AboutWho made this app?Is it really free?How can I thank you?Is this app still being updated?
GeneralOn which mobile devices can I install the remote?Does the remote work over wireless networks?What does this app do?How do I install test versions?Does the remote work over bluetooth?What's the difference between MediaMonkey, MediaMonkey Android, MMRemote, and MMRemote Server?
The remote app (Android)Why does the app ask for those permissions?How do I solve the 'Missing MediaMonkey' problem?What is MediaMonkey?How do I configure the lyrics fetcher?How do I update the app?How do I find the version of my app?Which intents/actions/extras does it support?I keep getting the message 'You're not allowed to do that'. What do I do?I keep getting messages saying that "You are not permitted to perform this action. Check your access permissions in the server application." What do I do?
The server (Windows)On which operative systems can I install the server?Does the server install any toolbars, spyware, viruses or other nasty stuff?How do I make sure the server is running?Why does nothing happen when I try to start the server?How do I find the version of my server?How do I open the server window?Why do I need a server?How do I find the Windows event log?How do I find the server log?How do I update the server?How do I find my server's connection information?How do I protect my server from unauthorized use?
Donations and bonus featuresHow do I activate my PayPal bonus features?What are the bonus features?Google Play donation didn't work/has disappeared. What do I do?I've donated, but not received any bonus features. Why?I got a new phone. Do I have to donate again?
NetworkHow do I configure the Windows Firewall?Can I use the remote from outside of my local area network?How do I connect to the server?How do I connect to the server using autodetect?How do I connect to the server using a connection string?How do I connect to the server using a QR code?How do I connect to the server using manual input?
PerformanceWhy does it often take several seconds for the playlist to update?What can I do if the app is sloppy, or lags when browsing lists?What do I do if my network is slow?Why is my playlist very slow to load?
TroubleshootingWhat can I do if the automatic lyric lookup finds the wrong lyrics?Why does AVG warn me that the server is a virus?How do I solve the 'Windows cannot access the specified device path or file. You may not have appropriate permissions.' message?Why won't the Windows Firewall allow the server to communicate?Why doesn't the changes I just did to my library show in the app's Library tab?Why can't I browse the playlists in my library?How do I report a bug?What do I do if I see strange stuff in my library? (Duplicated or missing albums, artists, etc)What do I do when my remote can't connect to the server?What can I do if I get an 'OutOfMemoryException'?What do I do if the server crashes immediately after starting it / doesn't start?
MediaMonkeyHow do I take a backup of my MediaMonkey database?Did you make MediaMonkey too?What about my MediaMonkey problems?
Frequently Asked QuestionsBack to FAQ
The remote itself is completely free for personal use, and will always remain so.
There are some bonus features, which are rewarded to everyone making a donation to the project. You can donate from the settings menu in the app, and pay as much as you'd like. Read more about the bonus features here.
If you are a business or other commercial entity that wants to use the remote, please contact me at email@example.com.
Installing the server: If it is an installation, just run it as usual. If it is a zip file, just unpack it anywhere you want. If you're not replacing your current version, please make sure that you are in fact running the test version, and not the old version you had installed.
Installing the client: Open the given client url on your phone, and the usual app installer will pop up.
Note: Some Android users needs to allow app installs from 'Unknown sources' (outside of Google Play, that is) in order to install the test version. To do this, you need to find the 'Unknown sources' setting, and check it. It is usually located in Android Settings => Application Settings => Unknown Sources, or in Android Settings => Security => Unknown Sources, or in Android Settings => Developer => Unknown Sources.
When testing new versions, please note that you may experience bugs I haven't discovered yet. If so, please tell me about it, so that I can fix it before releasing the update to everyone.
- MediaMonkey (MM) is a media player that can manage and play your music. It runs on your Windows PC, and plays your music through any speakers connected to the PC.
- MediaMonkey Android (MMA) is the Android version of MediaMonkey, which runs on your phone, and plays the music files you have on your phone through any speakers connected to the phone.
- MMRemote is the remote I have made. It runs on your Android phone or tablet. It cannot play or stream your music, it can simply remote control MediaMonkey if you have it installed on your PC. It displays the currently playing track's info and offers basic media controls, saving you from walking to the PC.
- MMRemote Server is the small program that you must install on your PC in order to communicate with the MMRemote on your phone.
The remote app (Android)
ACCESS_WIFI_STATE is to be able to detect the Wifi state, so that the app can display a warning if Wifi is disabled.
WRITE_EXTERNAL_STORAGE is for caching album art, to save network traffic.
BILLING is to allow users to buy the bonus features through Google Play.
INSTALL_SHORTCUT is used when you create Library shortcuts on your homescreen.
READ_PHONE_STATE is used when performing actions if you're getting a phone call (like lowering the volume, or pausing the music).
It is usually resolved by one or more of the following steps:
- The simplest solution may be to simply quit MediaMonkey and MediaMonkey Remote Server, and then start first MediaMonkey, and then MediaMonkey Remote Server again.
- Try to reboot your computer.
- Run MediaMonkey with administrator rights ONCE, close it, then start it again normally.
- Close MediaMonkey and MediaMonkey Remote Server, then run MediaMonkey Remote Server with administrator rights.
- Reinstall MediaMonkey, and make sure to check 'Start MediaMonkey now' at the end of the installation. Then try the above solutions if the problem was not resolved.
- A: Save lyrics in the song's directory, or
- B: Save lyrics in a central directory.
If you choose alternative B, make sure you tell MediaMonkey Remote where the lyrics are stored, as shown in the picture.
You can send intents to the app by starting it with custom 'Extras'. Supply an extra named 'ACTION'. The following actions are supported:
- net.erlenddahl.mmremotefree.widget.WidgetBase.MEDIA_PLAY_LIBRARY_NODE: Start playing something. This is used when creating homescreen shortcuts, and requires the additional Extras: LIBRARYNODE_ID and LIBRARYNODE_TYPE.
- net.erlenddahl.mmremotefree.service.WidgetBase.MEDIA_PLAYPAUSE: Toggles play/pause.
- net.erlenddahl.mmremotefree.widget.WidgetBase.MEDIA_STOP: Stops playback.
- net.erlenddahl.mmremotefree.widget.WidgetBase.MEDIA_NEXT: Starts playing the next track.
- net.erlenddahl.mmremotefree.widget.WidgetBase.MEDIA_PREV: Starts playing the previous track.
The server (Windows)
Note that controlling the system volume does not work on XP machines. We're working on it!
If you know that the .Net Framework is installed, please see the Windows Event Log, and send me any exceptions related to the server. You should also send me the server log.
Note: Older versions of the server doesn't open a window, it just adds an icon to the system tray. See: How do I make sure the server is running?.
If your server version is older than 2.5, please update it. That will probably solve the issues you're having anyway.
In newer versions of the remote, simply click the 'Advanced' link in the bottom left corner of the server window (on your computer), and then 'Show log'. Then click 'Export log to file' to get an actual file, and send this to me.
If the server isn't running (for example if it crashes), you can find the log by locating the log file manually:
- Open a Run window (press Windows+R or open the start menu and open 'Run').
- Enter %appdata% into the Run prompt, and press 'Ok'. This opens your application data folder.
- Enter the folder named 'MediaMonkey Remote Server', and you should see a folder named 'Logs', which contains log files for the last two days. Send me the newest file(s).
Donations and bonus features
- Wait for the confirmation e-mail. You should receive it within a couple of minutes after you made the donation. (Check your spam folder!)
- In the app, navigate to Settings => Bonus features.
- Enter the e-mail you used to donate in 'PayPal donation e-mail'.
NOTE: No features that has been free will ever be changed to bonus features. The bonus features will not be essential for the use of the remote, and are there only as an incentive to support the development.
The bonus features will be stuff I don't think is essential for the remote itself, but still makes it a better product overall. The following bonus features are implemented, and will be a part of the next update for the remote:
- The computer menu - Close/open MediaMonkey, turn the screen on/off, put the computer to sleep, hibernation, shut it down, restart it, or wake it up (Wake-on-lan).
- Widgets - A large widget that gives you direct access to most of the remote controls right from your Android home screen.
- The permanent notification - A permanent notification in the Android notification area that gives you an instant overview over the currently playing song, and allows you to open the remote.
- Lock screen controls - Lock screen controls that allows you to control your music without unlocking the phone.
- Homescreen shortcuts - Allows you to create homescreen shortcuts for every item in your Library. This means that you can start playing your favorite album simply by clicking a shortcut on your homescreen!
- Lyrics - Searches for lyrics for your songs. Can be configured to use the MiniLyrics plugin in addition to searching online.
There will be more features in future updates, both free features and bonus features (once you've bought the bonus features, you'll receive every future bonus feature too).
- [Note: The goal of this is not to donate more, it is to open Google Play on one of the donation pages, and then cancel.]
- Go to Settings => Bonus features => Get bonus features.
- Now choose a sum, for example $2 (just not the same amount you donated the previous time).
- Click 'Google Play', and the Google Play window will open.
- Now, don't go through with the donation. Just make sure Google Play opened, and go as far as you can without actually paying.
- Then cancel, and hopefully Google Play will have noticed that you already bought the bonus features. If this doesn't work, don't hesitate to contact me on my e-mail or through the forums.
- Google Play: In the remote, click Settings => Bonus features => and click the 'Status' item. If this does nothing, please see this question
- PayPal: In the remote, click Settings => Bonus features => and enter the e-mail you used to donate in the 'PayPal donation e-mail'. If you have forgotten which e-mail that was, look for the e-mail receipt you got when you donated. See this question for details.
Microsoft has a short video here that explains how to do that: Allow an application to communicate through Windows Firewall.
Sometimes, the Windows Firewall may have blocked the server even though you allowed it through earlier. Look at this question for more information about that: Why won't the Windows Firewall allow the server to communicate?
- Automatic detection ('autodetect'): This will attempt to automatically detect any servers running on the same local area network as your Android device.
- Connection string: This will use mmremote.net to send connection information to your Android device.
- QR code: Open a QR code reader on your phone (find one on Google Play), and scan the QR code that appears when you hold your mouse over 'Hold for QR code' on the main tab of the server.
- Manual input: Enter IP and port number manually.
Click any of the options in the list above to read more about them.
In the server list, click the 'Autodetect' button (), and the app will look for servers on your network.
In the server list, click the 'Add server' button (), and choose 'Connection string'.
Then enter the connection string found on your server's main window into the popup box, and click 'Ok'.
The server will now be added to your server list, and the app will immediately connect.
In the server list, click the 'Add server' button (), and choose 'Manual'.
Then enter the connection information in the fields as explained here:
- Display name: A simple name for yourself to recognize the server. This has no effect on the connection at all.
- IP address: The IP address of your server.
- Port: The port number your server is configured to listen at.
- MAC address: This field is not required. The MAC address of your server, used when using Wake on lan.
If you don't know how to find the information you need to enter, see this FAQ entry.
- Album art can be deactivated by unchecking 'Send album art' in the server's settings.
- The backgrund image can be deactivated in the app by unchecking Settings => Performance settings => Draw background image.
- In the app, increase the 'Update status interval' in Settings => Performance settings => Update status interval.
- In the server, disable the performance heavy stuff: Click the Settings tab, and uncheck 'Send album art' and 'Send detailed library information'.
If you have a lot of album art embedded in the music files, that might slow down the loading. If so, it is recommended to export the art (save it in image files instead), or deactivate album art (checkbox in server settings) if you need very responsive long lists.
- The easiest is to use MediaMonkey itself to find the lyrics for your song. It has a more advanced search function than my remote, and is usually better. To do that right click the song in MediaMonkey, choose Properties => Lyrics => Lookup lyrics.
- Use the MiniLyrics plugin for MediaMonkey, which stores the lyrics in another format that the remote can read. You can get it here.
This is a false positive, which sometimes happens with all anti-virus programs.
I promise that there are no viruses, so if my word is enough, you can solve this by either adding the server to some kind of white list in your anti-virus program, or temporarily deactivating it while installing the server (remember to reactivate it afterwards!).
Some users have reported getting this error message when attempting to install the remote server. The error message is usually caused by anti-virus programs being too aggressive, and blocking the installation altogether.
Bryan J. reported that with Avast, "hardened mode" and "gaming/silenced mode" needs to be disabled.
A general solution is usually to temporarily disable your anti-virus software (on your own responsibility!) while installing the server. Remember to re-activate it afterwards!
The Windows Firewall may have set network dependent rules on your server even if you allowed it through on the first run.
This problem can often be resolved by simply opening Network Adapters, and disable and re-enable the Local Area Connection adapter. Upon reconnect, make sure to allow the remote through again, and everything should be well.
Take a look at 'brockvenom's forum post for the original (and more detailed) solution.
- A thorough description of the problem; what did you do? Where did you do it? Does the server or the app crash? Do you get any error messages?
- A copy of your server log. See How do I find the server log?
- Anything else you think may be useful. Please remember that I have absolutely no idea of what happened apart from the details you tell me.
First of all, make sure you have actually installed the server. You need to have both MediaMonkey (the media player itself), AND the MediaMonkey Remote Server for this to work. Go to www.mmremote.net to download it.
Next, make sure you have allowed the server to communicate through any firewalls you have installed. This is usually done in the firewall's security settings. Note that most newer Windows systems have an integrated firewall (Windows Firewall). Look at this question for a description of how to make the Windows Firewall allow the MMRemote server to communicate: How do I configure the Windows Firewall?
If you have the Windows Firewall, it may have blocked the server even though you allowed it through. Look at this question for more information about that: Why won't the Windows Firewall allow the server to communicate?
If you are sure you have let the server through all firewalls, you need to make sure the client and server are configured correctly. Take a look at this question for more information: How do I connect to the server?
If your server version is older than 2.6, please update it. That will probably solve the issues you're having anyway.
If the server crashes immediately after starting it, or doesn't start at all, it's probably the settings file that has been corrupted. You need to delete it, and then start the server again:
- Open a Run window (press Windows+R or open the start menu and open 'Run').
- Enter %appdata% into the Run prompt, and press 'Ok'. This opens your application data folder.
- Enter the folder named 'MediaMonkey Remote Server'
- Delete settings.json
- The server should now work
I always recommend taking a backup of your MediaMonkey database before using my remote to do anything. Even though it has been tested thoroughly for many years now, without issues, I can never guarantee complete safety.
To take a backup of your database, navigate to %APPDATA%\MediaMonkey (you can enter that directly in Windows Explorer, or navigate to something like C:\Users\
MediaMonkey have more details in their knowledge base.