tracker-bridge

Tracker Bridge is a tiny localhost HTTP + WebSocket helper so the published Tower Run Tracker website can find and read playerInfo.dat on your computer (emulator, USB phone, or Mac App Store install).

It only reads your save file — it does not modify the game or inject code.

Usage

npx tracker-bridge

On first run the terminal walks you through setup:

1. Trust intro and npm source links
2. Self-update check — if a newer Tracker Bridge is published it offers to update before continuing
3. Automatic adb discovery or platform-tools install
4. Optional OS startup registration
5. Optional background mode (safe to close the terminal)

Optional flags

npx tracker-bridge --daemon        # Run in background
npx tracker-bridge --boot          # Register OS login startup
npx tracker-bridge --no-boot       # Skip startup prompts
npx tracker-bridge --remove-boot   # Remove OS startup entry
npx tracker-bridge --install-path  # Add adb to user PATH
npx tracker-bridge --no-update     # Skip the newer-version check
npx tracker-bridge --help

Platform notes

• Windows USB: Uses host adb in the bridge terminal. Autoplay can cause reconnect loops — set your phone to Take no action in Autoplay settings.
• macOS: Mac save scan checks the App Store bundle-id container, non-App-Store (random-UUID) sandbox containers, and non-sandboxed / Steam-style installs under ~/Library/Application Support, then runs a bounded case-insensitive search under those roots. macOS hides ~/Library in Finder — see the on-site import guide for how to reveal it (Go to Folder with ⇧⌘G, or the Go menu with Option held).
• Linux: Emulator connect tries adb first, then common on-disk save paths for Waydroid/Anbox installs.
• Published site: Click Allow when Chrome or Edge asks for local network access so the site can reach 127.0.0.1:43781.

Environment variables

• LOCAL_ADB_BRIDGE_PORT — default 43781
• ADB_PATH or LOCAL_ADB_BRIDGE_ADB — full path to adb / adb.exe
• LOCAL_ADB_BRIDGE_SKIP_AUTO_INSTALL=1 — do not install or modify PATH

Platform-tools zip installs are stored under ~/.local-adb-bridge/platform-tools/.

Legacy package name

The previous npm package was local-adb-bridge. New releases ship as tracker-bridge.