Skip to content

Installation

Jan Koudijs edited this page Mar 9, 2019 · 27 revisions

The Roon Extension Manager can be installed on a variety of platforms, this page contains detailed installation instructions for:


DietPi Logo     Linux Logo     Docker Logo     Windows 10 Logo     macOS X Logo


After installation the Extension Manager should show up in Roon, it can be accessed via Settings→Extensions.

The figure below shows instances of the Roon Extension Manager running on different platforms: Instances

Ready-to-Go Integrations

Some devices and distributions come with the Roon Extension Manager already included, for these it is just a matter of enabling it and you are ready to go. The applicable products are:

DietPi (≥ v6.10)

Installation can be performed via the dietpi-software installer, the Extension Manager can be found in the 'Media Systems' group within 'Software Optimized'.

Alternatively, you can install from the command line:

dietpi-software install 86

The full set of extensions becomes available by also installing Docker:

dietpi-software install 86 162

An installation video is available on YouTube

DietPi Installation

@ Roon Labs Community

https://community.roonlabs.com/t/roon-extension-manager-now-included-in-dietpi-v6-10/45514

Linux

Using the Setup Script (Recommended)

Install

The Setup Script performs a prerequisite check, installs the Extension Manager and sets up a systemd service. It has to be run with administrator privileges. If you run it as a normal user with sudo (recommended), the service will run as that user. Installation is done in the home directory of the user.

The script is pretty basic and has limited error handling. It is used successfully on Fedora, Arch Linux and DietPi but should work an other distros as well.

  • Download the Setup Script

  • Set the execute permission for the Setup Script:

    chmod +x /path/to/file/setup.sh

  • Run the Setup Script

    sudo /path/to/file/setup.sh

Uninstall

  • Download the Setup Script

  • Set the execute permission for the Setup Script:

    chmod +x /path/to/file/setup.sh

  • Run the Setup Script with the --uninstall option

    sudo /path/to/file/setup.sh --uninstall

@ Roon Labs Community

https://community.roonlabs.com/t/howto-install-roon-extension-manager-on-linux/37974

Manual Installation

Follow the generic installation instructions of the README file.

Setting up the updater

  • Change directory:

    cd ~/.RoonExtensions/lib

  • Install the updater via npm:

    npm install -g https://github.com/TheAppgineer/roon-extension-manager-updater.git

  • Download the shell script:

    curl -O https://raw.githubusercontent.com/TheAppgineer/roon-extension-manager-packaging/master/linux/roon-extension-manager.sh

  • Set the execute permission for the shell script:

    chmod +x roon-extension-manager.sh

Setting up a systemd service

Follow these steps to run the Extension Manager as a systemd service:

  • Set up the updater

  • Download the service file and change the paths in the WorkingDirectory and ExecStart field to the location of the shell script as setup in the previous step (use the absolute path here).

  • Change the User field to the user name you use to run the Extension Manager. Make sure that the service file and shell script can be accessed by this user.

  • Move the modified service file to the systemd location (check your distribution documentation for the right location):

    sudo mv roon-extension-manager.service /etc/systemd/system/

  • Reload systemd:

    sudo systemctl daemon-reload

  • Start the service, the Extension Manager should now show up in the Roon UI (Settings->Extensions):

    sudo systemctl start roon-extension-manager

  • Enable the service if you want it to auto start at system boot:

    sudo systemctl enable roon-extension-manager

  • View the status of the service by issuing the status command:

    systemctl status roon-extension-manager

Docker

Docker containers can be run on the more powerful Synology or QNAP devices, on a Linux PC by installing the Docker Community Edition, or on an ARM Single Board Computer (e.g. Raspberry Pi 2) running Raspbian or DietPi.

The Docker image can be found on DockerHub, setup instructions are there as well.

@ Roon Labs Community

https://community.roonlabs.com/t/docker-image-for-roon-extension-manager/44456

Synology specifics: https://community.roonlabs.com/t/docker-image-for-roon-extension-manager/44456/6
QNAP specifics: https://community.roonlabs.com/t/extension-manager-dissapearing/50596/2

Windows

Install

Windows installers, in both 32 bits and 64 bits, can be downloaded from the latest releases page. Please also read the information below the download links.

The provided installer installs the Roon Extension Manager as a Windows service. Once running, you can install and uninstall extensions from within the Roon UI. Select Settings→Extensions from the "hamburger menu" in the upper left corner and select the Extension Manager.

The service takes care that the Extension Manager starts when Windows starts, it is not necessary to login for the service to run.

Run the installer as administrator, this is required for setting-up the service.

There is a video of the installation process on YouTube

Uninstall / Prepare for Re-install

To uninstall the Extension Manager or prepare for a re-install, take the following steps:

  • Type services in the Windows search bar and open the Services application
  • Select the Roon Extension Manager in the list and stop it
  • Type cmd in the Windows search bar, right click the Command Prompt application and select Run as administrator.
  • Answer the allow changes prompt with Yes
  • Uninstall the service by entering: sc delete roon-extension-manager
  • Type uninstall a program in the Windows search bar and select Uninstall a program
  • Uninstall Node.js and Git
  • Type %appData% in the Windows search bar and press Enter
  • Delete the RoonExtensions folder
  • Delete the npm-cache folder
  • Type env in the Windows search bar and select Edit the system environment variables
  • Select the Environment Variables... button
  • Select NPM_CONFIG_PREFIX in the System variables section and press Delete
  • Restart the system

@ Roon Labs Community

https://community.roonlabs.com/t/howto-install-extensions-on-windows-in-three-easy-steps/29783

macOS

Follow the generic installation instructions of the README file.

Auto starting at login using Automator

  • Set up the updater

  • Launch Automator

  • Select New Document

  • Choose document type Application

  • Scroll down the list of available Actions and double click Run Shell Script

  • Paste into text input window:

    export PATH=/usr/local/bin/:$PATH
    cd ~/.RoonExtensions/lib
    while true; do ./roon-extension-manager.sh; done
    
  • Save

  • Open System Preferences -> Users & Groups and select your user.

  • Click Login Items, click + and navigate to where your new application is saved.

@ Roon Labs Community

https://community.roonlabs.com/t/howto-install-roon-extension-manager-on-macos/38864

You can’t perform that action at this time.