Madsonic Guide

Getting Started

This guide assumes that you have successfully installed the Madsonic server on your computer. If not, please refer to the installation instructions. After installing and starting Madsonic, open the Madsonic web page. The web address may differ depending on your installation options, but is typically http://localhost:4040.

1 Setting up media folders

You must tell Madsonic where you keep your music and videos. Select Settings > Media folders to add one or more folders.

Note that if you add more than one media folder, a list will appear on the left side of the screen where you can select the active folder.

Also note that Madsonic will organize your music according to how they are organized on your disk. Unlike many other music applications, Madsonic does not organize the music according to the tag information embedded in the files. (It does, however, also read the tags for presentation and search purposes.)

Consequently, it's recommended that the music folders you add to Madsonic are organized in an "artist/album/song" manner. There are music managers, like MediaMonkey, that can help you achieve this.

2 Using network disks in Windows

Madsonic runs as a service on Windows. By default, mapped networks disks are not visible to services.
To fix this you can change the Madsonic service to run as the logged-on user instead of the System user.

  1. Open Services in Windows.
  2. Right-click the Madsonic service and select Properties.
  3. Click the Log On tab.
  4. Activate This account and enter your Windows username and password.
  5. Click OK and restart the service.

3 Setting up remote access

With Madsonic you can access your music anywhere on the internet or from your iPhone or Android phone. However, in order to do that certain conditions must be met:

3.1 Automatic port forwarding

To enable automatic port forwarding in Madsonic, go to Settings > Network and enable the "Automatically configure your router..." option. Click the Save button and pay close attention to the status message that is displayed. If you get an error message, you should first try to configure your router to enable UPnP (or NAT-PMP if you have an AirPort from Apple). If it still fails, or your router doesn't support UPnP, follow the instructions below. If it works, the Madsonic server will at regular intervals (every hour) contact the router and tell it to forward incoming connections (from the internet) to the Madsonic server.

3.2 Manual port forwarding

If the automatic option didn't work you can still set it up manually. Consult to get instructions specific to your router. Note that the instructions contain important steps on how to configure a static IP address for your computer. You should follow these. Later in the process, you will find that Madsonic is not on the list of applications, so select the "Default Guide" instead.

When you get to the point where the router asks for private and public ports, enter the port number the Madsonic server is using (normally port 4040) for both values. If asked for a protocol, select TCP.

If you are unsure what any of this means you will probably need to consult someone with network configuration experience.

3.3 Setting up your personal address

Once you get the port forwarding set up correctly, the next step is to get yourself an easy-to-remember web address. You will use this address to access your Madsonic server from the internet.

From Settings > Network you can register your address. (Remember to log on with admin rights). Enable the "Access your server over the internet..." option, and enter your preferred address, for instance

Click the Save button, and pay attention to the status message that is displayed. Note that Madsonic will also perform a test to ensure that the web address works properly. If the test fails it might be an indication that the port forwarding is not set up correctly.

If you don't want to use a address you can get similar services from dynamic DNS providers such as

NEW :: Host it yourself with a custom URL

3.4 Troubleshooting

This section describes some common network problems and how to fix them.

4 Registering your license key

Most features in Madsonic are free, but some (like mobile phone streaming) require that you upgrade to Madsonic Premium after the 30-day free trial. After you receive the license key by email, you must register it on your server as follows:

5 Using https

For improved security you can turn on https encryption. On Windows, open the Madsonic Control Panel by clicking on the Madsonic tray icon, then enable https on the specified port (default 443).

On Linux, add --https-port=4443 (or any other port) to MADSONIC_ARGS in /etc/default/madsonic (Ubuntu/Debian) or /etc/sysconfig/madsonic (Fedora/RPM).

Note that Madsonic uses a self-signed https certificate by default. This provides encryption but not proper authentication. To use your own certificate you must put it in a Java keystore, then specify the following Java system properties: madsonic.ssl.keystore – (Path to an alternate SSL keystore), and madsonic.ssl.password – (Password of the alternate SSL keystore). On Windows, you can set these system properties in C:\madsonic\madsonic-service.exe.vmoptions.