• Acts as an API endpoint to upload album art covers for RoonCordJS

• Serves the images as static files, and responds to RoonCordJS with the link

• Offers optional Bearer token authentication to protect your endpoint

• Do the things RoonCordJS can do

• Enhance the album art in any way

• Let others listen to your music alongside you

• Break any Terms of Service provided by Discord or Roon Labs.

• NodeJS 20 LTS (latest release preferred)

• npm (should come with NodeJS)

• The ability for your server to be reached via the web

• (Optional) A reverse proxy for SSL and domain names

1. Clone the repo:

   git clone https://github.com/prolix-oc/RoonCordJS-Server

2. Install all dependencies:

   npm install

3. Run it!

   • On Windows, double click or run in Command Prompt/Terminal:

     launch.bat

   • On Linux, first

     chmod +x ./launch.sh, then run

     ./launch.sh

   • Or if you prefer the manual, platform-agnostic way:

     node --env-file=app.env index

The server will automatically create a generic user with a randomly generated Bearer token. There might be a few things you want to configure though, so read on to the next step.

In app.env, you'll find a few important things.

• AUTH_REQ - Defaults to true. Enables Bearer token authorization for all API calls made to the server. Can be disabled if you're feeling risky.

• AUTH_TYPE - Defaults to json, unused at the moment. In the future, this will specify how Express checks for tokens and where.

• SERVER_BASE_URL - Defaults to http://127.0.0.1:3249. This is what the server will use in the response to RoonCord as a image URL for caching. Make sure this URL is publicly accessible. localhost and 127.0.0.1 will not work.

• IMG_UPLOAD_DIR - Defaults to artfiles. Specify where Multer will store uploads, and where Express will serve the album art from.

• SERVER_PORT - Defaults to 3429. The port that Express will listen for requests on.

Feel free to report it in the repository issues, and I'll see what went wrong for you!

• None at the moment.