If you're having trouble using MonkeyMote, wish to report a bug or suggest a new feature, please email Support or send a message via Facebook. Support requests should include a detailed error description and mention which media player and device you are using.

Troubleshooting

Always make sure to use the latest version of the app as well as its corresponding plug-in and media player.

Connection issues

If you are having trouble connecting to your PC, please make sure that

• the plug-in for your media player is installed correctly and working (the server must be enabled in the plug-in's configuration dialog)
• your firewall is not blocking the port used by MonkeyMote to listen for incoming TCP connections (default 19371). Recent plugin versions allow you to easily add Windows Firewall rules through their configuration dialogs. Alternatively, configure your firewall s.t. it allows the host application (i.e. the media player software) to accept incoming TCP connections.
• your PC and mobile device are connected to the same local WiFi network
• your WiFi router/access point allows clients to communicate directly (i.e. 'client isolation' is disabled, often only applicable if the PC is also using a wireless connection)
• VPNs, personal hotspots etc. are disabled on your mobile device

Automatic discovery

For the automatic discovery to work, Apple's Bonjour service needs to be running on your PC. It is typically installed automatically alongside iTunes.

A firewall may prevent the automatic discovery feature from working reliably.

Should the automatic service discovery fail or you would like to set a default connection, then you need to create a manual connection. This requires you to enter your computer's IP address. A list of network adapters and their addresses is shown in the plugin configuration dialog. Alternatively, you can open a command prompt and enter ipconfig. In the example below, the IP address to use is 192.168.0.173.

Please note that, depending on your network configuration, your computer's IP address might change after a reboot. In that case you may want to set up a static IP address or configure your router to always assign the same IP address to your PC.

Browsing issues (albums)

MonkeyMote by default tries to use the album artist tag when collecting a list of albums in the media library. If your files are not tagged properly, you may run into problems with albums containing tracks by several different artists. This can be resolved by either re-tagging the albums in question (e.g. using TagScanner or Mp3Tag) or toggling the Prefer album artist option in the plug-in settings.

JRiver Media Center

In some cases MonkeyMote will be able to connect to a running JRMC instance, but will behave erratically. For example, it may not react to track or volume changes. This is most likely to happen when two different versions of JRMC were installed at some point, e.g. when upgrading. To resolve this issue, fully uninstall and then reinstall both JRMC and MonkeyMote. When upgrading to a newer version of JRMC, always uninstall the old version first.