MusicIP Mixer Help - Setting Up a MusicIP Server
If you are using a different program or hardware device which
interacts with one of MusicIP's services, you may not need the
application user interface to be running at all times. MusicIP Mixer
includes a standalone server which can provide the services supported
by the MusicIP Mixer (this is also called the "headless"
version of the mixer, as it does not include a graphical user
interface).
You configure the MusicIP Server by editing a server configuration
file. This file has the name mmm.ini - consult the platform specific notes
below on where this file is located.
You should create a startup file as necessary by modifying the
sample included in the distribution. This file is read when the
server starts, so make sure it's configured correctly first, as
described below.
If you are using the GUI application and the server together, you
may create conflicts where both applications are trying to update your
cache. In this case, you will be prompted from the application whether you
want to overwrite any changes made by the server. From the server,
you will need to manually reload the cache if you want the server to
use modified data.
Windows
On Windows, the MusicIP Server runs as a system service. The configuration
files live in the installation folder. To install the service, run:
MusicMagicServer install
You can uninstall this at a later point using this command:
MusicMagicServer uninstall
To start the service, run the following command, or use the Windows
Services panel:
net start "MusicIP Server"
To test if the server is running, open your browser and enter the
URL where you installed MusicIP Mixer:
http://localhost:10002/api
To stop the service at any time, run the following command, or use the Windows
Services panel:
net stop "MusicIP Server"
Mac OS X
From the installation DMG, open up the MusicIP Server folder, and double-click
on the Mixer Server.prefPane icon. This will add a system preference panel which
you can use to control the MusicIP Server.
The configuration file should be stored in the same place as your cache
file: ~/Library/Application Support/MusicMagic
Linux
To run MusicIP Mixer in the "headless" mode:
- Install MusicIP Mixer
- Locate the mmm.ini file in the installation directory, and copy it to
the $HOME/.MusicMagic directory
- Change any settings desired by editing the mmm.ini file in your .MusicMagic directory.
- Run the command: "MusicMagicServer start". This
will start the server on port 10002, or any other port you have
specified in your mmm.ini file.
- Open the URL http://localhost:10002
in your browser. From this page you can control the MusicIP Server.
Details for mmm.ini
The following section details the options for the mmm.ini file.
The MusicIP Server can share a cache file with the standalone GUI, but
does not share any of the configuration options.
[mix]
| mixsize=10 tracks | How many tracks to include
in a mix by default. Option should be a # followed by tracks,
minutes, or mb (meaning megabytes) |
| restrict=3 tracks | How often to allow
duplicate artists in a mix |
| style=20 | The style setting. 0 is low, 200 is high |
| variety=0 | The variety setting. 0 is none, 9 is high |
| seed=1 | Boolean: 1=always include the seed in mixes, 0=sometimes include the seed in mixes (depending on other options) |
[server]
| proxy=0 | Boolean: 1=use proxy, 0=do not use proxy |
| host= | Proxy host name |
| proxyport= | Proxy port number |
| authentication= | Boolean: 1=use authentication on proxy, 0= do not use authentication |
| user= | Proxy user name |
| password= | Proxy password |
[services]
| key= | MusicIP Mixer egistration key |
| cache= | Cache file (optional) |
| port=10002 | Port to expose services |
| tivo=1 | Boolean: 1=enable TiVo support, 0=disable TiVo support |
| upnp=0 | Boolean: 1=enable UPnP support, 0=disable UPnP support |
| api=1 | Boolean: 1=enable HTTP API, 0=disable HTTP API |
| refresh=15 | How many seconds to wait before refreshing the headless view. This applies only while adding, refreshing, or validating songs. You can disable automatic refresh by setting this value to 0. |
| cpu=0 | Processor Load option (Windows only). 0=Max, 1=Moderate, 2=Low |
