MinimServer

Home

Donate

Features

Downloads

Installing

Release notes

User guide

Support

Troubleshooting

Forum

MinimStreamer

License

UPnP AV

Technology

Contact

Latest news

Now supports Java 9 as well as Java 8 and Java 7

Latest change

MinimServer 0.8.5.3 has been released

Installing MinimServer on a Melco N1

You can install and use MinimServer on a Melco N1 free of charge, subject to the License terms. If you are enjoying the combination of MinimServer and the N1, please bear in mind the considerable effort that has been required to create a MinimServer installer for the N1 and show your appreciation by making a donation via the Donate page. There's no recommended amount—please give what you feel MinimServer is worth to you. Many thanks!

Table of contents

Overview
Creating the USB installer flash drive on Windows
Creating the USB installer flash drive on Mac
Installing MinimServer on the Melco N1
Updating MinimServer on the Melco N1
Removing MinimServer from the Melco N1
Reinstalling MinimServer and Java on the Melco N1

Overview

The installation process uses a USB flash drive to install, update or remove MinimServer depending on what is in the files directory of the USB flash drive and what is already installed on the N1. [NEW] The MinimServer installation includes a tailored version of the OpenJDK Java Runtime Environment (identified as MinimJRE) that is suitable for running MinimServer.

If the version of MinimServer on the flash drive is later than the version currently installed on the N1 (or no version is currently installed), the flash drive version of MinimServer will be installed and the currently installed version of MinimServer (if any) will be removed. If MinimServer is running, it will be restarted.

If MinimServer is not present on the flash drive, MinimServer will be uninstalled from the N1. If MinimServer is running, it will be stopped. The MinimServer configuration will be saved in case MinimServer is reinstalled later.

To revert to an older version of MinimServer, you need to first uninstall MinimServer and then reinstall the desired version. This prevents unintentionally overwriting MinimServer with an older version if an older install flash drive is inserted. The saved MinimServer configuration will be used when MinimServer is reinstalled.

[NEW] Previous versions of the MinimServer installer for the N1 included Java as a separate install package. If this separate Java package is currently installed, it will be removed automatically.

Java security updates are issued periodically. These updates will be delivered to the N1 as updates to the MinimJRE package and will be installed automatically by the MinimServer automatic update facility. These updates can also be installed or removed using MinimWatch.

The MinimJRE package that is included in the MinimServer installation was built from the publicly available OpenJDK source repository. It is licensed under the GPL v2 license with the "Classpath" exception (see this page) and the "Assembly" exception (see this page). If you would like a copy of the source code that was used to build the MinimJRE package, please send a private message to user simoncn via the MinimServer forum at forum.minimserver.com.

Creating the USB installer flash drive on Windows

The installation process requires a USB installer flash drive containing MinimServer and some other files. To create this flash drive using a Windows PC, follow these steps:

  1. Format a USB flash drive (128 MB or larger) with a single NTFS or FAT32 partition
  2. Download the MinimServer archive file MinimServer-0.8.5.2-melco.zip from
  3. Extract the MinimServer-0.8.5.2-melco.zip file to the root folder of the flash drive. This will create the following folder structure on the flash drive:
    .Anas.bak
      5A0001
        17-09-28-082657
    files
    scripts
    

    Note: Make sure the folders .Anas.bak, files and scripts are all in the root folder of the USB drive and aren't underneath some other folder

  4. Safely eject the USB flash drive using the Windows system tray icon and remove the USB flash drive from your Windows PC.

You can now continue with the installation as described in the section Installing MinimServer on the Melco N1.

Creating the USB installer flash drive on Mac

The installation process requires a USB installer flash drive containing MinimServer and some other files. To create this flash drive using a Mac, follow these steps:

  1. Download the MinimServer archive file MinimServer-0.8.5.2-melco.dmg from
  2. Insert a USB flash drive (128 MB or larger) into your Mac
  3. Double-click the downloaded MinimServer archive, then double-click the create-installer file within the archive
  4. A Terminal window will open. This window is a wizard that creates the USB installer flash drive from the MinimServer archive that you have downloaded. The wizard will guide you through a number of steps, including asking you to select the USB flash drive that you want to use as the installer flash drive. Take care when making this selection because the USB flash drive that you specify will be erased and overwitten. When you are prompted to enter a password, enter the password that you use to login to your Mac.
  5. When the wizard has completed, remove the USB flash drive from your Mac, close the Terminal window and eject the MinimServer-0.8.5.2-melco volume.

You can now continue with the installation as described in the section Installing MinimServer on the Melco N1.

Installing MinimServer on the Melco N1

You should follow the steps in this section if you have never previously installed MinimServer on your Melco N1 or if you are reinstalling MinimServer after selecting Initialize settings from the N1 front panel or downgrading the N1 firmware to an older level. In other cases, you can use the simpler process described in the section Updating MinimServer on the Melco N1.

To install MinimServer, make sure you follow all the steps in this section exactly and in the order shown:

Warning: the following procedure will reset your N1 to its factory default settings and you will need to re-enter any custom settings. Your audio files will be preserved.

  1. Create a USB installer flash drive using the instructions in one of the previous sections.
  2. Insert the USB flash drive into the USB port marked Backup at the rear of the N1
  3. On the N1 front panel, select Backup » Restore from Backup and then select MinimServer-Setup followed by Restore Settings
  4. At the prompt 'All settings will be initialized. Continue?', select OK
  5. When the restore has finished, select OK
  6. You will see a 'Restarting...' prompt. Before you select OK, remove the USB flash drive from the USB port marked Backup and insert it into the USB port marked Expansion
  7. Select OK to restart the N1
  8. You will be prompted to re-enter your language and time zone settings
  9. The N1 will install MinimServer from the USB flash drive
  10. If the N1 is connected to the internet, MinimServer will download and apply the latest update
  11. MinimServer will start scanning your N1 music library. If your library is large, this could take a long time. Subsequent rescans will be quicker because MinimServer uses a cache to speed up the scanning process.
  12. Follow the instructions in the "Importing Music Files from a Computer" section of the N1 User Manual to view the share folder in Windows Explorer or Mac Finder
  13. Check the minimsetup.log file in the share/MinimServer folder to confirm that installation was successful. The contents of this file should be similar to the following:
    Expansion drive found
    Found MinimServer 0.8.5.2 on flash drive
    Installing MinimServer 0.8.5.2...
    Configuring MinimServer startup settings...
    Starting MinimServer...
    Creating minimstart.conf file
    Creating minimserver.defaults file
    Creating minimserver.options file
    Enabling MinimServer automatic startup...
    MinimServer setup completed
    
  14. If installation wasn't successful, copy the minimsetup.log, minimserver-init.log, minimserver.log and minimserver-out.log files from the share/MinimServer folder to another location and post a message to the Support section of the MinimServer forum
  15. Re-enter any custom settings that have been reset to system defaults. In particular, you need to change the Auto Power Save setting to Off from its default value of 5 minutes.
  16. To confirm that MinimServer is running, you can display the MinimServer status web page by typing http://x.x.x.x:9790 into a web browser address bar, where x.x.x.x is the IP address of the N1. Alternatively, you can install and start MinimWatch on another computer on your local network, then select 'Show log' from the MinimWatch minim icon to view the MinimServer log
  17. When the initial scan of your N1 library has completed (this can take a long time), the MinimServer library will become visible to UPnP control points on your local network and you can use a UPnP control point to view the contents of your library
  18. You can now remove the USB flash drive. Melco recommends that you don't remove a USB drive while the N1 is powered on.
  19. If you want to install MinimStreamer (see this page), you can do this from MinimWatch
  20. Retain the USB flash drive for use if you need to update or remove MinimServer (see below)

The MinimServer installer creates a folder named share/MinimServer. This folder contains files used by the MinimServer application such as logs and configuration files and should not be used for music files. If you put your music into the normal locations in the N1 library, MinimServer will find it.

Twonky and MinimServer are both started automatically when the N1 is powered on. Having Twonky running as well as MinimServer can cause performance issues with a large library. To stop Twonky running, you can edit the minimserver.options file in the share/MinimServer/etc folder and change the stoptwonky setting from false to true. This setting will take effect the next time you power on the N1.

In version 3.50 (and below) of the Melco firmware, the N1 front panel doesn't show the details of music files that are being streamed by MinimServer. This has been fixed in the 3.72 firmware.

If you have installed MinimStreamer and you want to use FFmpeg as a stream converter, you can copy an ffmpeg static binary for ARMv7 into the ahare/MinimServer/opt/bin folder and restart MinimServer by powering the N1 off and on. FFmpeg is released as source code only and there don't seem to be any public download sites that provide a suitable ARMv7 binary, so it is necessary to build the binary from source code. You can find instructions for building an ffmpeg static binary for ARMv7 in this tutorial.

Updating MinimServer on the Melco N1

You should follow the steps in this section if you have previously installed MinimServer on your Melco N1 and you now want to update MinimServer and/or Java to the latest version.

Note: If MinimServer was removed because you selected Initialize settings from the N1 front panel or you downgraded the N1 firmware to an older level, you need to use the full installation process described in the section Installing MinimServer on the Melco N1.

To update MinimServer to the latest version, follow these steps:

  1. Create a USB installer flash drive containing the latest MinimServer installer using the instructions in this section (for Windows) or this section (for Mac)
  2. Power off the N1, then insert the USB flash drive into the USB port marked Expansion at the rear of the N1 and power on the N1
  3. The N1 will update MinimServer to the new version on the flash drive and restart MinimServer if it is running
  4. Follow the instructions in the "Importing Music Files from a Computer" section of the N1 User Manual to view the share folder in Windows Explorer or Mac Finder
  5. Check the minimsetup.log file in the share/MinimServer folder to confirm that the update was successful. The contents of this file should be similar to the following:
    Expansion drive found
    MinimServer 0.8.4.7 is installed
    Found MinimServer 0.8.5.2 on flash drive
    Updating MinimServer 0.8.4.7 to 0.8.5.2...
    Stopping MinimServer process 1262
    MinimServer update completed successfully
    Configuring MinimServer startup settings...
    Starting MinimServer...
    Creating minimstart.conf file
    Creating minimserver.defaults file
    MinimServer setup completed
    
  6. If the update wasn't successful, copy the minimsetup.log, minimserver-init.log, minimserver.log and minimserver-out.log files from the share/MinimServer folder to another location and post a message to the Support section of the MinimServer forum
  7. You can now remove the USB flash drive. Melco recommends that you don't remove a USB drive while the N1 is powered on.

Removing MinimServer from the Melco N1

You can remove MinimServer from the N1 by following these steps:

  1. On the USB flash drive, delete the MinimServer file from the files folder. After you have done this, the files folder should be empty. Do not change or remove any other files on the flash drive.
  2. Power off the N1, then insert the USB flash drive into the USB port marked Expansion at the rear of the N1 and power on the N1
  3. The N1 will stop MinimServer if it is running and then remove MinimServer
  4. Follow the instructions in the "Importing Music Files from a Computer" section of the N1 User Manual to view the share folder in Windows Explorer or Mac Finder.
  5. Check the minimsetup.log file in the share/MinimServer folder to confirm that removal was successful. The contents of this file should be similar to the following:
    Expansion drive found
    MinimServer 0.8.5.2 is installed
    Uninstalling MinimServer 0.8.5.2...
    Do you want to save your MinimServer configuration file (y/n)?
    Removing links for automatic startup...
    Stopping MinimServer process 2357
    Saving MinimServer configuration file...
    Removing MinimServer installation files...
    MinimServer has been uninstalled
    Uninstall actions completed
    
  6. If removal wasn't successful, copy the minimsetup.log, minimserver-init.log, minimserver.log and minimserver-out.log files from the share/MinimServer folder to another location and post a message to the Support section of the MinimServer forum
  7. You can now remove the USB flash drive. Melco recommends that you don't remove a USB drive while the N1 is powered on.
  8. A copy of your MinimServer configuration is saved on the N1 in case you decide to reinstall MinimServer later. If you select Initialize settings from the N1 front panel or if you downgrade the N1 firmware to an older level, this saved configuration will be deleted.

Reinstalling MinimServer on the Melco N1

If you have previously installed and removed MinimServer from the N1 and you now want to reinstall MinimServer, follow the steps in the section Updating MinimServer on the Melco N1.

If MinimServer wase removed because you selected Initialize settings from the N1 front panel or you downgraded the N1 firmware to an older level, you need to use the full installation process described in the section Installing MinimServer on the Melco N1.