MinimServer

Home

Donate

Features

Downloads

Installing

Release notes

User guide

Support

Troubleshooting

Forum

MinimStreamer

License

UPnP AV

Technology

Contact

Latest news

Command scripting and Web API now available

Latest change

MinimServer update 96 has been released

Installing MinimWatch on Linux

Installing Java on Linux
Installing MinimWatch on Linux
Updating MinimWatch on Linux
Uninstalling MinimWatch on Linux
Running MinimWatch on Linux

Note: If you have a Raspberry Pi running Raspbian, please refer to this page for instructions on how to install Java and MinimWatch.

Installing Java on Linux

MinimWatch is written in Java and requires Java 7 or later to be installed. If you don't already have this installed, and you're running Linux x86 or Linux x64 as a desktop system, you can download the current version of the Oracle Java Runtime Environment (JRE) from this page and follow the installation instructions there. If you're running Linux on an ARMv6 or ARMv7 machine, you can download Oracle JDK 7 for ARM from this page or you can download Oracle JDK 8 for ARM from this page.

If you want to run MinimWatch in an embedded Linux environment such as a plug computer or NAS, you can download the current version of Oracle Java SE Embedded from this page. You can download either Java SE Embedded 7 or Java SE Embedded 8. Review and accept the Oracle license agreement, then click on the download link for the correct .tar.gz file for your machine architecture. You'll be prompted to create or login to your Oracle account before you can download the file.

After downloading the Java SE Embedded .tar.gz file, use tar xf to unpack its contents to a local directory. After doing this, create a link to the java executable from a location on the path. The usual location for this link is the /usr/local/bin directory. For example, if you have unpacked the .tar.gz download for Java 7 update 45 into the directory /usr/local/ejre, you can create this link by using the following command:
 ln -s /usr/local/ejre/ejre1.7.0_45/bin/java /usr/local/bin

If you're using Debian or Ubuntu, another option is to use apt-get to download and install the openjdk-7-jre or openjdk-7-jre-headless package. The former package is used for desktop systems with a graphical user interface and the latter package is used for embedded systems without a graphical user interface. On ARM systems, runtime performance of the current OpenJDK download is considerably worse than Oracle JDK and Oracle Java SE Embedded. On x86 and x64 systems, there's no significant difference.

After installing Java, use the command
 java -version
to make sure Java is installed correctly and is available on the path. This is important for correct operation of the MinimWatch command scripts.

Installing MinimWatch on Linux

If you have a previous version of MinimWatch already installed, see the section Updating MinimWatch on Linux for details of how to update your installation to a new version.

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

  1. You can install MinimWatch in your home directory or in another directory. If you're installing MinimWatch in another directory, create this directory using mkdir. In the following instructions, we'll refer to this directory as the <minim-home> directory.
  2. Download the file MinimWatch-0.8.4-linux-x86.tar.gz, MinimWatch-0.8.4-linux-x64.tar.gz, MinimWatch-0.8.4-linux-arm.tar.gz, MinimWatch-0.8.4-linux-armhf.tar.gz or MinimWatch-0.8.4-linux-ppc.tar.gz (depending on which version of Linux you're running) from the Downloads page and save this file in the <minim-home> directory.

    Note: The x64 version of MinimWatch must be launched using 64-bit Java, and the x86 version of MinimWatch must be launched using 32-bit Java. If you use 32-bit Java to launch the x64 version of MinimWatch (or vice versa), you'll get an error message.

  3. Use tar xf to unpack the downloaded archive file into the <minim-home> directory. For example, on Linux x86, you would use the following commands in a terminal window:
     cd <minim-home>
     tar xf MinimWatch-0.8.4-linux-x86.tar.gz
  4. Enter the command:
     minimwatch/bin/setup
    The setup command will ask whether you want to enable desktop integration (if available) and/or automatic startup (if available). 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 computer is started or rebooted.
  5. If you're running in a graphical desktop environment, double-click the MinimWatch launch icon on your desktop. Alternatively, if you're running in a "headless" environment, open a terminal window and run the command
     minimwatch/bin/startc
  6. MinimWatch will scan your local network for all instances of MinimServer that are currently running. If you're running in a graphical desktop environment, MinimWatch will display a tray icon for each MinimServer instance running on another computer or NAS on your local network. The tray icon has a minim symbol (musical note) and its colour shows the status of the MinimServer instance, as follows:
    • If the icon is yellow, MinimServer is starting or stopping
    • If the icon is green, MinimServer is running normally
    • If the icon is red, MinimServer has detected an error
    • If the icon is white, MinimServer is stopped
    • If the icon is grey, no instances of MinimServer were detected

    Alternatively, if you're running in a "headless" environment, you'll get a message
     <server-name> is running
    for each MinimServer instance running on your local network, where <server-name> is the display name of the MinimServer instance. This includes any MinimServer instances running on the same computer as MinimWatch.

  7. If MinimServer is running but MinimWatch can't see MinimServer, check that you don't have a firewall blocking port udp/1900.
  8. MinimWatch installation is now complete. If you're running in a graphical desktop environment, you can use the pop-up menu selections for each minim icon to configure and manage the MinimServer instance corresponding to this minim icon. For details of these menu selections, see the Controlling MinimServer using the minim icon section of the User guide. Alternatively, if you're running in a "headless" environment, you can configure and manage all MinimServer instances by entering commands from the terminal window. For details of these commands, see the Controlling MinimServer using console commands section of the User guide.
  9. If you're running in a graphical desktop environment, MinimWatch will continue to run until you terminate it by using the Exit comand from the minim icon pop-up menu. If you're running in a "headless" environment, MinimWatch will terminate if its terminal window is closed for any reason.
  10. To change your current settings for desktop integration and/or 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 enable_autostart enables automatic startup
     minimwatch/bin/setup disable_autostart disables automatic startup

Updating MinimWatch on Linux

To update an existing installation of MinimWatch (0.8.1 or later), do the following:

  1. Download the archive file MinimWatch-0.8.4-linux-x86.tar.gz, MinimWatch-0.8.4-linux-x64.tar.gz, MinimWatch-0.8.4-linux-arm.tar.gz, MinimWatch-0.8.4-linux-armhf.tar.gz or MinimWatch-0.8.4-linux-ppc.tar.gz (depending on which version of Linux you're running) from the Downloads page and save this file in the <minim-home> directory.
  2. Enter the command:
     <minim-home>/minimwatch/bin/update <archive-name>
    where <archive-name> is the name of the archive file that you downloaded.
  3. 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, follow the instructions in the Running MinimWatch on Linux section.

To update an existing installation of MinimWatch (0.72 or earlier), make sure that MinimWatch isn't running, then follow the instructions for doing a new MinimWatch installation into a new <minim-home> directory. After unpacking the downloaded archive, copy your existing minimwatch.config file into the <minim-home>/minimwatch/data directory to migrate your current configuration settings to the new installation.

Uninstalling MinimWatch on Linux

To uninstall MinimWatch on Linux, do the following:

  1. Enter the command:
     <minim-home>/minimwatch/bin/uninstall
    This stops any MinimWatch instances that are currently running and uninstalls MinimWatch.
  2. 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 in the same <minim-home> directory and run the minimwatch/bin/setup command, your saved configuration file will be restored.

Running MinimWatch on Linux

To start MinimWatch in a graphical desktop environment, double-click the MinimWatch launch icon on your desktop. MinimWatch will display a minim icon for each MinimServer instance running on any computer or NAS on your local network. These minim icons will appear in the desktop system tray or menu bar and 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.

To start MinimWatch as an interactive console application in the current terminal window, use the command:
 <minim-home>/minimswatch/bin/startc
You'll get a message
 <server-name> is running
for each MinimServer instance running on your local network, where <server-name> is the display name of the MinimServer instance. This includes any MinimServer instances running on the same computer as MinimWatch. You can configure and manage all MinimServer instances by entering commands from the terminal window. See the Controlling MinimServer using console commands section for details of these commands. You can stop MinimWatch by using the exit command or by pressing Enter at the command prompt. MinimWatch will also be stopped if its terminal window is closed.

[DEPRECATED] On version 0.8.3 or earlier, you can send commands to MinimWatch 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 MinimWatch.

To stop all instances of MinimWatch (started in any of the above ways), use the command:
 <minim-home>/minimwatch/bin/stopall
This stops all MinimWatch processes that are running on this computer.