Repository navigation
Dual-platform SmoothTrack USB tracking for iOS and Android with upstream OpenTrack sync.
What's New in 1.0.4
- Upstream Synchronization:
- Cherry-picked and merged critical fixes and enhancements from upstream
opentrack/opentrackmaster:- CMake install prefix safeguard (
cmake: set install prefix before any errors can occur). - PaperTracker multi-marker pose estimation overhaul with bundle adjustment.
- PaperTracker OpenCV 5 compatibility guards and out-of-bounds line clipping.
- Pose cache optimization after refinement to reduce redundant CPU usage.
- CMake install prefix safeguard (
- Cherry-picked and merged critical fixes and enhancements from upstream
- SmoothTrack USB Reliability:
- Hardened ADB reverse relay lifecycle for Android USB tracking (automatic ABI detection for ARM64 and ARMv7, automatic daemon staging and graceful cleanup).
- Native iOS USB tracking via
libusbmuxd(port 47047). - Bundled ADB platform-tools and relay binaries directly in the distribution.
- Documentation:
- Added complete, step-by-step Quick Start guides for both iOS and Android in the README.
How SmoothTrack USB Tracking Works
Android USB
- Enable Developer Options and turn on USB Debugging on your phone.
- Connect your device to your PC via USB cable and allow debugging when prompted.
- Open SmoothTrack on Android: set Target IP to
127.0.0.1and Port to4242. - In OpenTrack: select SmoothTrack (USB) as tracker -> click
...-> select Android (USB via ADB Relay). - Click Start. OpenTrack sets up the reverse tunnel, runs
st-relayon device, and cleans up automatically on stop.
iOS USB
- Connect your iPhone / iPad via USB cable and ensure it trusts the PC.
- Open SmoothTrack on iOS -> Settings -> enable Activate USB Connection.
- In OpenTrack: select SmoothTrack (USB) -> click
...-> select iOS (Apple USB via usbmuxd) (Port47047). - Click Start.