MinimServer

Home

Donate

Features

Downloads

Installing

Release notes

User guide

Support

Troubleshooting

Forum

MinimStreamer

License

UPnP AV

Technology

Contact

Latest news

Improved artwork handling for multidisc albums

Latest change

MinimServer update 124 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're using GNOME Shell as your desktop (this is the default on Ubuntu 17.10 or later), Java 9 or later is required for MinimWatch to work correctly.

If you're running Linux x86 or Linux x64 as a desktop system, you can download the latest Oracle Java Runtime Environment (JRE 10) from this page.

If you're running Linux on an ARMv6 or ARMv7 machine, you can download Oracle JDK 8 (Java Development Kit) for ARM from this page.

If you're running Linux on an ARMv5 machine, you can download the current version of Oracle Java SE Embedded from this page. Review and accept the Oracle license agreement, then click on the first download link (ARMv5/ARMv6/ARMv7 Linux - SoftFP ABI, Little Endian 2). You'll be prompted to create or login to your Oracle account before you can download the file.

If you have downloaded the JRE or JDK as a .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 JDK 8 update 181 into the directory /usr/local/ejdk, you can create this link by using the following command:
 ln -s /usr/local/ejdk/ejdk1.8.0_181/bin/java /usr/local/bin

If you're using Debian or Ubuntu, you can use apt-get to download and install the JRE. Depending on which version of Debian or Ubuntu you're running, the JRE package might be named openjdk-10-jre, openjdk-10-jre-headless, openjdk-9-jre, openjdk-9-jre-headless, openjdk-8-jre or openjdk-8-jre-headless. The "headless" packages are used for embedded systems without a graphical user interface and the other packages are used for desktop systems with a graphical user interface.

Note: On ARM 32-bit systems, runtime performance of OpenJDK 8 is considerably worse than Oracle JDK and Oracle Java SE Embedded. On Intel x86 and x64 systems and ARM 64-bit 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. If you're using GNOME Shell 3.26 or later (for example, on Ubuntu 17.10 or later), install the GNOME Shell extension TopIcons Plus before installing MinimWatch. If you don't install TopIcons Plus, you will get a message "unable to create tray icon" when you launch MinimWatch.
  2. 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.
  3. Download the archive file MinimWatch-0.8.5.2-linux-intel.tar.gz, MinimWatch-0.8.5.2-linux-arm.tar.gz, MinimWatch-0.8.5.2-linux-armhf.tar.gz, MinimWatch-0.8.5.2-linux-arm64.tar.gz or MinimWatch-0.8.5.2-linux-ppc.tar.gz (depending on which version of Linux you're running) from the Downloads page.
  4. Use tar xf to unpack the downloaded archive file into the <minim-home> directory. For example, on Linux Intel x86 or x64, you would use the following commands in a terminal window:
     cd <minim-home>
     tar xf MinimWatch-0.8.5.2-linux-intel.tar.gz
  5. 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 desktop integration and automatic startup, MinimWatch will be started automatically when you login to your desktop. You can't enable automatic startup without desktop integration.
  6. 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
  7. 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 any other 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.

  8. If MinimServer is running but MinimWatch can't see MinimServer, check that you don't have a firewall blocking port udp/1900.
  9. 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.
  10. 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 you enter the exit command or if the terminal window is closed for any reason.
  11. 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.5.2-linux-intel.tar.gz, MinimWatch-0.8.5.2-linux-arm.tar.gz, MinimWatch-0.8.5.2-linux-armhf.tar.gz, MinimWatch-0.8.5.2-linux-arm64.tar.gz or MinimWatch-0.8.5.2-linux-ppc.tar.gz (depending on which version of Linux you're running) from the Downloads page.
  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 other 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 a terminal window, use the command:
 <minim-home>/minimwatch/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 closing the terminal window.

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.