# Groovebasin

From ArchWiki
Jump to navigation Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

Groovebasin is a music player server with a web-based user interface.

Run it on a server connected to some speakers in your home or office. Guests can control the music player by connecting with a laptop, tablet, or smart phone. Further, you can stream your music library remotely.

Groove Basin works with your personal music library; not an external music service. Groove Basin will never support DRM content.

## Installation

Install the nodejs-groovebasinAUR package from the Arch User Repository.

## Configuration

A config file is located in `/etc/groovebasin.json` you need to provide groovebasin with a config file or it will create a new one in the current directory named `config.json`.

## Start the Server

To start groovebasin as a regular user run

    $ groovebasin --start

A unit file is also available to start groovebasin as root use:

    # systemctl start groovebasin.service

## Web Interface

Open on your browser https://localhost:16242/.

## NGINX Proxy

NGINX can be used to redirect traffic from port 16242 to 80 with the following configuration.

    /etc/nginx/nginx.conf

    location /groove/ {
            proxy_set_header    X-Real-IP  $remote_addr;
            proxy_set_header    X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header    Host $http_host;
            proxy_redirect      off;
            proxy_http_version  1.1;
            proxy_set_header    Upgrade $http_upgrade;
            proxy_set_header    Connection "upgrade";
            proxy_pass          http://127.0.0.1:16242/;
    }

Categories:

- Music
- Web applications