Home

Awesome

Groove Basin

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.

Feature Highlights

Installation on Ubuntu

For Ubuntu 17.04 Zesty:

  1. sudo apt-get install nodejs libgrooveloudness-dev libgroovefingerprinter-dev libgrooveplayer-dev libgroove-dev
  2. Clone this repo and cd to it.
  3. npm run build
  4. npm start

For Ubuntu 18.04 Bionic:

Configuration

When Groove Basin starts it will look for config.json in the current directory. If not found it creates one for you with default values.

Use this to set your music library location and other settings.

It is recommended that you generate a self-signed certificate and use that instead of using the public one bundled with this source code.

Screenshots

Search + drag/drop support Multi-select and context menu Keyboard shortcuts Settings Import Events

Developing

$ npm run dev

This will install dependencies, build generated files, and then start the sever. It is up to you to restart it when you modify assets or server files.

Community

Pull requests, feature requests, and bug reports are welcome! Live discussion in #libgroove on Freenode.

Articles

Roadmap

  1. Music library organization
  2. Accoustid Integration
  3. Finalize GrooveBasin protocol spec