MinimServer

Home

Donate

Features

Downloads

Installing

Release notes

User guide

Support

Troubleshooting

Forum

MinimStreamer

License

UPnP AV

Technology

Contact

Latest news

Added support for digital booklets

Latest change

MinimServer update 97 has been released

Installing MinimServer on the Raspberry Pi

Note: The installation instructions on this page are for Raspberry Pi users who are using Raspbian. If you are using a different version of Linux on your Raspberry Pi, please refer to the Installing MinimServer and MinimWatch on Linux page for installation instructions.

Table of contents

Installing Java on the Raspberry Pi
Installing MinimServer on the Raspberry Pi
Updating MinimServer on the Raspberry Pi
Uninstalling MinimServer from the Raspberry Pi
Running MinimServer on the Raspberry Pi
Installing MinimWatch on another computer
Installing MinimWatch on the Raspberry Pi
Updating MinimWatch on the Raspberry Pi
Uninstalling MinimWatch from the Raspberry Pi
Running MinimWatch on the Raspberry Pi

Installing Java on the Raspberry Pi

If your Raspbian image is from September 2013 or later, it comes with Java preinstalled. If you have an older image without Java preinstalled, you need to install Java by opening a terminal window and typing the command:
 sudo apt-get install oracle-java7-jdk
Answer 'y' to the confirmation prompt, wait for apt-get to do its thing, and you're done!

To make sure Java is installed correctly, open a terminal window and type the command:
 java -version
You should get the following output, possibly with a later version number:
 java version "1.7.0_40"
 Java(TM) SE Runtime Environment (build 1.7.0_40-b43)
 Java HotSpot(TM) Client VM (build 24.0-b56, mixed mode)

Installing MinimServer on the Raspberry Pi

If you have a previous version of MinimServer (0.8.1 or later) already installed, see the section Updating MinimServer on the Raspberry Pi for details of how to update your installation to a new version.

For a new installation of MinimServer on the Raspberry Pi, do the following:

  1. Download the file MinimServer-0.8.4-linux-armhf.tar.gz from the Downloads page to the /home/pi directory on your Raspberry Pi.
  2. Open a terminal window from the Raspberry Pi desktop or login via SSH as the 'pi' user.
  3. Enter the commands:
     cd /home/pi
     tar xf MinimServer-0.8.4-linux-armhf.tar.gz
  4. Enter the command:
     minimserver/bin/setup
    The setup command will ask whether you want to enable desktop integration and/or automatic startup. If you enable desktop integration, a MinimServer launch icon will appear on your desktop. If you enable automatic startup, MinimServer will be started automatically when the Raspberry Pi is started or rebooted.
  5. You're now ready to start MinimServer. If you're running the Raspberry Pi graphical desktop and you have enabled MinimServer desktop integration, double-click on the MinimServer desktop launch icon and wait a few seconds for MinimServer to begin its startup. If you're using a terminal window to run MinimServer, enter the command:
     minimserver/bin/startc
    from the terminal window.
  6. If this is the first time you've started MinimServer, MinimServer will prompt you for your content directory. This is the directory on the Raspberry Pi that contains your music files. If you have enabled desktop integration, MinimServer will show a file chooser dialog on the desktop and ask you to select a content directory. If you have disabled desktop integration, MinimServer will run as a terminal application and will display a command prompt asking for the name of the content directory, which you need to enter as a Linux-style path. For example, if your music files are in a 'music' directory within the 'pi' home directory, you should enter the value
     /home/pi/music
    If you need to add additional content directories, you can do this later.
  7. MinimServer will scan all the music files under the content directory that you configured during the installation process. Depending on how many music files you have, this might take some time. If you have enabled desktop integration, MinimWatch will display a yellow icon with a minim symbol (musical note) in the system tray while this scan is in progress. When the scan has finished successfully, the colour of the minim icon will change to green. If MinimServer startup fails for any reason, the colour of the minim icon will change to red and you'll see a pop-up message describing the problem. If you have disabled desktop integration, a terminal message will be displayed either indicating successful startup or describing a startup problem.
  8. It's a good idea to check the MinimServer log to see if there are any warning or error messages about problems found by MinimServer while scanning your music files. If MinimServer is running on the desktop, right-click on the minim icon and select "Show log". If MinimServer is running as a terminal application, you can see the log output in the file
     /home/pi/minimserver/data/minimserver.log
    A warning in the log means that MinimServer has found something wrong with a file, but has been able to read the file and make it available for browsing and playing. An error in the log means that MinimServer wasn't able to read the file. If you see a message you don't understand, you can get help by creating a new thread in the MinimServer support forum as described on the Support page.
  9. If MinimServer has started successfully, you can use a UPnP control point to browse your music library and select and play music.
  10. If MinimServer is running on the desktop, MinimServer installation is now complete. The Pi desktop minim icon pop-up menu provides a number of selections that you can use to configure and manage MinimServer. For information about these selections, see the Controlling MinimServer using the minim icon section of the User guide.
  11. If MinimServer is running as a terminal application, MinimServer will terminate if the terminal window is closed for any reason. To prevent this happening, press Enter at the command prompt to exit MinimServer, then enter the command:
     minimserver/bin/startd
    This restarts MinimServer as a daemon background process that will continue to run after the terminal window is closed.
  12. To configure and manage MinimServer when it's running as a daemon background process, you can install MinimWatch either on another computer that's connected to your local network or on the Raspberry Pi. For details of how to do this, see the sections Installing MinimWatch on another computer and Installing MinimWatch on the Raspberry Pi.
  13. To change your current settings for desktop integration and automatic startup, you can run the minimserver/bin/setup command at any time. This command lists your current settings and prompts you to change them. As an alternative to changing settings using interactive prompts, you can specify a single argument to the minimserver/bin/setup command as follows:
     minimserver/bin/setup enable_desktop enables desktop integration
     minimserver/bin/setup disable_desktop disables desktop integration
     minimserver/bin/setup add_rc enables automatic startup
     minimserver/bin/setup remove_rc disables automatic startup

Updating MinimServer on the Raspberry Pi

To update an existing installation of MinimServer on the Raspberry Pi, do the following:

  1. Download the file MinimServer-0.8.4-linux-armhf.tar.gz from the Downloads page to the /home/pi directory on your Raspberry Pi.
  2. Open a terminal window from the Raspberry Pi desktop or login via SSH as the 'pi' user.
  3. Enter the command:
     minimserver/bin/update MinimServer-0.8.4-linux-armhf.tar.gz
    This stops any MinimServer instances that are currently running, uninstalls the current version of MinimServer, installs the new version of MinimServer, and migrates your current MinimServer configuration file to the new version of MinimServer.
  4. To start the new version of MinimServer, follow the instructions in the Running MinimServer on the Raspberry Pi section.

Uninstalling MinimServer from the Raspberry Pi

To uninstall MinimServer from the Raspberry Pi, do the following:

  1. Open a terminal window from the Raspberry Pi desktop or login via SSH as the 'pi' user.
  2. Enter the command:
     minimserver/bin/uninstall
    This stops any MinimServer instances that are currently running and uninstalls MinimServer.
  3. You'll be asked whether you want to save your MinimServer configuration file. It's a good idea to save your configuration file if there's any chance that you might reinstall MinimServer in the future. If you reinstall MinimServer and run the minimserver/bin/setup command, your saved configuration file will be restored.

Running MinimServer on the Raspberry Pi

If you have enabled MinimServer desktop integration, you can start MinimServer by double-clicking on the MinimServer desktop program icon. The minim icon will appear in the desktop system tray and you can use the minim icon pop-up menu to configure and manage MinimServer. See the Controlling MinimServer using the minim icon section for details of the available menu selections. You can stop MinimServer by using the minim icon pop-up menu Exit selection or by using the minim icon pop-up menu Close selection from a remote instance of MinimWatch.

You can also use terminal commands to start, stop and manage MinimServer. The relative paths for the commands and files shown below assume that your current directory is /home/pi.

To start MinimServer as a daemon background process, open a terminal window and use the command:
 minimserver/bin/startd
You can configure and manage the MinimServer daemon process by using MinimWatch. See the Running MinimWatch section for details.

To start MinimServer as an interactive console application in a terminal window, use the command:
 minimserver/bin/startc
You can configure and manage MinimServer by entering commands from the terminal window. See the Controlling MinimServer using console commands section for details of the available commands. You can stop MinimServer by using the exit command or by pressing Enter at the command prompt. MinimServer will also be stopped if its terminal window is closed.

[DEPRECATED] On version 0.8.3 or earlier, you can send commands to MinimServer via a local named pipe. This capability is now replaced by the new command scripting feature in version 0.8.4 (see the Command scripting section) and the named pipe facility will be removed completely in the next version of MinimServer.

To stop all instances of MinimServer (started in any of the above ways), use the command:
 minimserver/bin/stopall
This stops all MinimServer processes that are running on the Raspberry Pi.

Installing MinimWatch on another computer

If you have disabled desktop integration for MinimServer, or if you want to be able to configure and manage MinimServer from another computer, you can install and run MinimWatch on another computer that's connected to your local network. The computer that you use to run MinimWatch can be running Windows, Mac OS X or Linux.

For details of how to install and uninstall MinimWatch on a Windows PC, see the Installing MinimWatch on Windows page. If you're installing MinimWatch on Mac OS X, see the Installing MinimWatch on Mac OS X page. If you're using Linux to run MinimWatch, see the Installing MinimWatch on Linux page.

Installing MinimWatch on the Raspberry Pi

Note: The instructions in this section and the following sections are provided for completeness. In practice, it's not very likely that you will need to install and run MinimWatch on the Raspberry Pi. In most cases, MinimServer would be installed on the Raspberry Pi and MinimWatch (if you are using it) would be installed on another computer on your local network, as described in the previous sections.

If you have a previous version of MinimWatch (0.8.1 or later) already installed, see the section Updating MinimWatch on the Raspberry Pi for details of how to update your installation to a new version.

For a new installation of MinimWatch on the Raspberry Pi, do the following:

  1. Download the file MinimWatch-0.8.4-linux-armhf.tar.gz from the Downloads page to the /home/pi directory on your Raspberry Pi.
  2. Open a terminal window from the Raspberry Pi desktop or login via SSH as the 'pi' user.
  3. Enter the commands:
     cd /home/pi
     tar xf MinimWatch-0.8.4-linux-armhf.tar.gz
  4. Enter the command:
     minimwatch/bin/setup
    The setup command will ask whether you want to enable desktop integration and/or automatic startup. If you enable desktop integration, a MinimWatch launch icon will appear on your desktop. If you enable automatic startup, MinimWatch will be started automatically when the Raspberry Pi is started or rebooted.
  5. Start MinimWatch by double-clicking on the MinimWatch desktop program icon. MinimWatch will scan your local network for all instances of MinimServer that are currently running, and it will display an icon with a minim symbol (musical note) in the system tray for each MinimServer instance that was found. The colour of the icon indicates the status of the MinimServer instance, as described in the Controlling MinimServer using the minim icon section of the User guide. If no MinimServer instances were found, MinimWatch displays a grey icon.
  6. MinimWatch installation is now complete. For each minim icon, its pop-up menu provides a number of selections that you can use to configure and manage the MinimServer instance corresponding to this minim icon. For information about these selections, see the Controlling MinimServer using the minim icon section of the User guide.
  7. To change your current settings for desktop integration and automatic startup, you can run the minimwatch/bin/setup command at any time. This command lists your current settings and prompts you to change them. As an alternative to changing settings using interactive prompts, you can specify a single argument to the minimwatch/bin/setup command as follows:
     minimwatch/bin/setup enable_desktop enables desktop integration
     minimwatch/bin/setup disable_desktop disables desktop integration
     minimwatch/bin/setup add_rc enables automatic startup
     minimwatch/bin/setup remove_rc disables automatic startup

Updating MinimWatch on the Raspberry Pi

To update an existing installation of MinimWatch on the Raspberry Pi, do the following:

  1. Download the file MinimWatch-0.8.4-linux-armhf.tar.gz from the Downloads page to the /home/pi directory on your Raspberry Pi.
  2. Open a terminal window from the Raspberry Pi desktop or login via SSH as the 'pi' user.
  3. Enter the command:
     minimwatch/bin/update MinimWatch-0.8.4-linux-armhf.tar.gz
    This stops any MinimWatch instances that are currently running, uninstalls the current version of MinimWatch, installs the new version of MinimWatch, and migrates your current MinimWatch configuration file to the new version of MinimWatch.
  4. To start the new version of MinimWatch after the update has completed, double-click on the MinimWatch desktop program icon.

Uninstalling MinimWatch from the Raspberry Pi

To uninstall MinimWatch on the Raspberry Pi, do the following:

  1. Open a terminal window from the Raspberry Pi desktop or login via SSH as the 'pi' user.
  2. Enter the command:
     minimwatch/bin/uninstall
    This stops any MinimWatch instances that are currently running and uninstalls MinimWatch.
  3. You'll be asked whether you want to save your MinimWatch configuration file. It's a good idea to save your configuration file if there's any chance that you might reinstall MinimWatch in the future. If you reinstall MinimWatch and run the minimwatch/bin/setup command, your saved configuration file will be restored.

Running MinimWatch on the Raspberry Pi

If you have enabled MinimWatch desktop integration, you can start MinimWatch by double-clicking on the MinimWatch desktop program icon. MinimWatch will display a minim icon in the desktop system tray for each MinimServer instance running on any computer or NAS on your local network. You can use the pop-up menu for each minim icon to configure and manage the MinimServer instance corresponding to this minim icon. See the Controlling MinimServer using the minim icon section for details of the available menu selections. You can stop MinimWatch by selecting Exit from any minim icon pop-up menu.

For other ways to run MinimWatch on the Raspberry Pi, see the Running MinimWatch on Linux section.