MinimServer

Home

Features

MinimServer 2.2

License options

Downloads

Release notes

Quick start

MinimWatch

User guide

Support

Troubleshooting

Forum

MinimStreamer

License terms

UPnP and DLNA

Technology

Contact

Latest news

(2024/04/14) Configuration status web page updated automatically

Latest change

(2024/07/15) MinimServer 2.2 update 253 has been released

Installing MinimWatch 2 on the Raspberry Pi

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

Table of contents

Updating an existing MinimWatch installation
Installing MinimWatch 2 on the Raspberry Pi
Installing Java on the Raspberry Pi
[NEW] Configuring Raspberry Pi OS to use X11 instead of Wayland
Running MinimWatch 2 on the Raspberry Pi
Uninstalling MinimWatch 2 from the Raspberry Pi

Updating an existing MinimWatch installation

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

1. MinimWatch 2 is written in Java and requires Java 8 or later to be installed. See the Installing Java on the Raspberry Pi section for details of how to install Java and/or check that the correct version of Java is installed.
2. On the MinimServer 2 Downloads page, find the Linux row in the table of MinimWatch downloads. For Raspberry Pi OS 32-bit or Raspbian, click the download link for ARM hard float. For Raspberry Pi OS 64-bit, click the download link for ARM 64-bit.
3. Accept the license and download the archive file to the /home/pi directory on your Raspberry Pi. For Raspberry Pi OS 32-bit or Raspbian, the archive file is . For Raspberry Pi OS 64-bit, the archive file is .

   Note: If you are not running a graphical desktop on your Raspberry Pi, you need to download the archive file using another computer and copy the archive file to the /home/pi directory on your Raspberry Pi.

4. Open a terminal window from the Raspberry Pi desktop or login via SSH as the 'pi' user.
5. For Raspberry Pi OS 32-bit or Raspbian, enter the command:
    miniwatch/bin/update
   For Raspberry Pi OS 64-bit, enter the command:
    minimwatch/bin/update
6. This stops any MinimWatch instances that are currently running, uninstalls the current version of MinimWatch, installs MinimWatch 2 and migrates your current MinimWatch configuration to your new installation of MinimWatch 2.
7. To start and run MinimWatch 2, follow the instructions in the Running MinimWatch 2 on the Raspberry Pi section.

Installing MinimWatch 2 on the Raspberry Pi

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

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

1. MinimWatch 2 is written in Java and requires Java 8 or later to be installed. See the Installing Java on the Raspberry Pi section for details of how to install Java and/or check that the correct version of Java is installed.
2. On the MinimServer 2 Downloads page, find the Linux row in the table of MinimWatch downloads. For Raspberry Pi OS 32-bit or Raspbian, click the download link for ARM hard float. For Raspberry Pi OS 64-bit, click the download link for ARM 64-bit.
3. Accept the license and download the archive file to the /home/pi directory on your Raspberry Pi. For Raspberry Pi OS 32-bit or Raspbian, the archive file is . For Raspberry Pi OS 64-bit, the archive file is .

   Note: If you are not running a graphical desktop on your Raspberry Pi, you need to download the archive file using another computer and copy the archive file to the /home/pi directory on your Raspberry Pi.

4. Open a terminal window from the Raspberry Pi desktop or login via SSH as the 'pi' user.
5. For Raspberry Pi OS 32-bit or Raspbian, enter the commands:
    cd /home/pi
 tar xf
   For Raspberry Pi OS 64-bit, enter the commands:
    cd /home/pi
 tar xf
6. 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 in the "Other" category of your applications start menu. If you enable desktop integration and automatic startup, MinimWatch is started automatically when you login to your desktop. You can't enable automatic startup without desktop integration.
7. [NEW] Important: If you are running Raspberry Pi OS version 12 (bookworm), this uses Wayland as its display protocol by default instead of X11. MinimWatch requires X11 to show its tray icon. To configure Raspberry Pi OS to use X11 instead of Wayland, see the section Configuring Raspberry Pi OS to use X11 instead of Wayland.
8. Start MinimWatch 2 by clicking the MinimWatch laumch icon. MinimWatch 2 will scan your local network for all instances of MinimServer 2 and MinimServer 0.8 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 2 displays a grey icon.
9. MinimWatch 2 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.
10. 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 enable_autostart enables automatic startup
     minimwatch/bin/setup disable_autostart disables automatic startup

Installing Java on the Raspberry Pi

If you have Raspbian Wheezy, Jessie or Stretch, it comes with Java preinstalled. If you have Raspbian Buster, you need to install Java by opening a terminal window and typing the command:
 sudo apt install default-jdk
Answer 'y' to the confirmation prompt, wait for apt 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 output similar to the following, probably with a different version number:
 java version "1.8.0_65"
 Java(TM) SE Runtime Environment (build 1.8.0_65-b17)
 Java HotSpot(TM) Client VM (build 25.65-b01, mixed mode)

For MinimServer 2, Java 8 or later is required. If the version of Java that is installed on your Raspberry Pi is lower than Java 8 and you are unable to update to Java 8, please post to the MinimServer forum.

[NEW] Configuring Raspberry Pi OS to use X11 instead of Wayland

If you are running Raspberry Pi OS version 12 (bookworm), this uses Wayland as its display protocol by default instead of X11. MinimWatch requires X11 to show its tray icon. If you try to run MinimWatch on Wayland, you will see a message "ServerWatch: unable to create tray icon".

To configure Raspberry Pi OS (bookworm) to use X11 instead of Wayland, do the following:

1. Open a Terminal window and run this command: sudo raspi-config
2. Select option 6 (Advanced Options) and press Enter
3. Select option A6 (Wayland) and press Enter
4. Select option W1 (X11) and press Enter
5. Reboot the Raspberry Pi

Running MinimWatch 2 on the Raspberry Pi

MinimWatch 2 is written in Java and requires Java 8 or later to be installed. See the Installing Java on the Raspberry Pi section for details of how to install Java and/or check that the correct version of Java is installed.

If you have enabled MinimWatch desktop integration, you can start MinimWatch by clicking the MinimWatch launch icon in your applications start menu. 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.

Uninstalling MinimWatch 2 from the Raspberry Pi

To uninstall MinimWatch 2 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:
    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.