roon-extension-manager

Roon Extension for managing Roon Extensions.

---

OS Specific Installation

OS specific installation instructions can be found on the project Wiki.

Manual Installation

1. Install Node.js from https://nodejs.org.

   • On Windows, install from the above link.
   • On Mac OS, you can use homebrew to install Node.js.
   • On Linux, you can use your distribution's package manager, but make sure it installs a recent Node.js. Otherwise just install from the above link.

   Make sure you are running node 5.x or higher. This can be verified on the command line with the following command:

   node -v
   

   For example:

   $ node -v
   v5.10.1
   

2. Install Git from https://git-scm.com/downloads.

   • Following the instructions for the Operating System you are running.

3. Setup an extension installation location via npm.

   • Make a global extension directory:

     mkdir ~/.RoonExtensions
     

   • Configure npm to use the new directory path:

     npm config set prefix '~/.RoonExtensions'
     

   Note: If you use npm for other purposes as well, it may be handy to use an environment variable instead. Background information about setting up a global npm installation directory can be found here.

4. Install the extension at the set location:

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

   Note: On Windows it is easiest to run this command from the Git CMD prompt (part of git installation), this ensures that the git executable can be found.

5. Run it!

   cd ~/.RoonExtensions/lib/node_modules/roon-extension-manager
   node .
   

   The extension should appear in Roon now. See Settings->Extensions. If you have multiple Roon Cores on the network, all of them should see it but only one can connect at a time.

Notes

• Remember that extensions are installed on the device at which the Extension Manager is running (hostname is included in the extension name to differentiate between multiple devices).
• Automatic startup at system start is OS dependent and outside the scope of this document.