Support
For bugs, feature requests, or general questions:
support@tmuxonwatch.comGitHub
Report issues, view source, or contribute:
github.com/beneaug/TerminalPulseCommon Issues
App shows "Disconnected"
Make sure the tmuxonwatch server is running on your Mac and your phone can reach it. You can verify the server locally with curl -sf http://127.0.0.1:8787/health. If needed, run the install command again.
QR code won't scan
Re-run the install command to print a fresh QR code. Make sure the terminal window is large enough and the code is fully visible.
Watch not receiving data
The watch receives data through your iPhone via WatchConnectivity. Make sure the iPhone app is connected to the server and the watch is paired and nearby.
Server won't start
Check that tmux is installed and a session is running. The server requires Python 3.10+ and tmux. Check logs at /tmp/tmuxonwatch.err.log to see error output.
Reinstall or update
Run the install command again to update to the latest version. Your configuration and token are preserved.
brew install beneaug/tmuxonwatch/tmuxonwatch
tmuxonwatch-install