/roon-extension-manager

Roon Extension for managing Roon Extensions

Primary LanguageJavaScriptApache License 2.0Apache-2.0

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.