Repository navigation
Troubleshooting
John Maguire edited this page Oct 2, 2026
·
1 revision
- Check that Clementine's network remote is on (Tools → Preferences → Network Remote → Use a network remote control), and that Clementine is running.
- Your phone and computer must be on the same network. Discovery doesn't cross VPNs, guest Wi-Fi networks or separate subnets.
- Connect by address instead: enter one of the addresses Clementine's Network Remote page lists, under Or enter its address.
- On Android 17 and later, the app needs the Nearby devices permission. If you refused it, allow it in the app's settings (Android's Settings → Apps → Clementine Remote → Permissions).
- Check the address, and that the app's port (Settings → Connection → Port) is Clementine's (5500 unless changed).
- A firewall on your computer may block Clementine's port. Allow incoming TCP connections on it.
- Over a VPN or from another network, turn off Only allow connections from the local network in Clementine. Clementine closes connections from addresses outside the local network without a word.
- Some Wi-Fi networks (public or guest ones, typically) don't let devices talk to each other.
Clementine's Require authentication code is on. Enter the code shown on Clementine's Network Remote page.
Clementine Remote needs Clementine 1.3 or later: download Clementine.
- "Download forbidden": turn on Allow downloads on Clementine's Network Remote page.
- "Download only on wifi allowed": connect to Wi-Fi, or turn off Settings → Downloads → WiFi only.
Turn on Allow playing on remote devices on Clementine's Network Remote page (older versions of Clementine don't have it), and Settings → Advanced → Let Clementine play on this phone in the app.
Turn on Settings → Advanced → Keep CPU alive. Some phones also stop apps in the background to save battery: let Clementine Remote run unrestricted in Android's battery settings.
Open an issue, with your Android and Clementine versions, and how you connect.