Groove Basin

No-nonsense music client and server for your home or office.

Run it on a server connected to your main speakers. Guests can connect with their laptops, tablets, and phones, and play and share music.

Depends on mpd version 0.17+ for the backend. Some might call this project an mpd client. (Note, version 0.17 is only available from source as of writing this; see below instructions regarding mpd installation.)

Live demo: groovebasin.com

Features

• Lightning-fast, responsive UI. You can hardly tell that the music server is on another computer.

• Dynamic playlist mode which automatically queues random songs, favoring songs that have not been played recently.

• Drag and drop upload. Drag and drop playlist editing. Rich keyboard shortcuts.

• Streaming support. You can listen to your music library - or share it with your friends - even when you are not physically near your home speakers.

• Last.fm scrobbling.

Get Started

Make sure you have Node and npm installed, then:

$ npm install groovebasin
$ npm start groovebasin

At this point, Groove Basin will issue warnings telling you what to do next.

Screenshots

Mpd

Groove Basin depends on mpd version 0.17+.

Some new features are only available when you compile from source:

$ git clone git://github.com/superjoe30/mpd.git

Configuration

• audio_output - Uncomment the "httpd" one and configure the port to enable streaming. Recommended "vorbis" encoder for better browser support.

• sticker_file - Groove Basin will not run without one set.

• gapless_mp3_playback - "yes" recommended. <3 gapless playback.

• volume_normalization - "yes" recommended. Replaygain scanners are not implemented for all the formats that can be played back. Volume normalization works on all formats.

• max_command_list_size - "16384" recommended. You do not want mpd crashing when you try to remove a ton of songs from the playlist at once.

• auto_update - "yes" recommended. Required for uploaded songs to show up in your library.

Configuring Groove Basin

See http://npmjs.org/doc/config.html#Per-Package-Config-Settings

See the "config" section of package.json for configuration options and defaults.

Example:

$ npm config set groovebasin:mpd_conf ~/.mpd/mpd.conf
$ npm config set groovebasin:port 80

Developing

$ sudo npm link
$ make watch
$ npm -g start groovebasin

Release Notes

0.0.5

• Note: Requires you to pull from latest mpd git code and recompile.
• Andrew Kelley:
  • disable volume slider when mpd reports volume as -1. fixes #8
  • on last.fm callback, do minimal work then refresh. fixes #7
  • warnings output the actual mpd.conf path instead of "mpd conf". see #5
  • resize things after rendering things. fixes #6
  • put uploaded files in an intelligent place, and fix #2
  • ability to retain server state file even when structure changes
  • downgrade user permissions ASAP
  • label playlist items upon status update
  • use blank user_id to avoid error message
  • use jplayer for streaming
• Josh Wolfe:
  • do not show ugly "user_n" text after usernames in chat.

0.0.4

• Andrew Kelley:
  • update keyboard shortcuts dialog
  • fix enter not queuing library songs in firefox
  • ability to authenticate with last.fm, last.fm scrobbling
  • last.fm scrobbling works
  • fix issues with empty playlist. fixes #4
  • fix bug with dynamic mode when playlist is clear
• Josh Wolfe:
  • easter eggs
  • daemon uses a state file

0.0.3

• Andrew Kelley:
  • ability to select artists, albums, tracks in library
  • prevents sticker race conditions from crashing the server (#3)
  • escape clears the selection cursor too
  • ability to shift+click select in library
  • right-click queuing in library works
  • do not show download menu option since it is not supported yet
  • show selection on expanded elements
  • download button works for single tracks in right click library menu
  • library up/down to change selection
  • nextLibPos/prevLibPos respects whether tree items are expanded or collapse
  • library window scrolls down when you press up/down to move selection
  • double click artists and albums in library to queue
  • left/right expands/collapses library tree when lib has selection
  • handle enter in playlist and library
  • ability to drag artists, albums, tracks to playlist
• Josh Wolfe:
  • implement chat room
  • users can set their name in the chat room
  • users can change their name multiple times
  • storing username persistently. disambiguating conflicting usernames.
  • loading recent chat history on connect
  • normalizing usernames and sanitizing username display
  • canot send blank chats
  • supporting /nick renames in chat box
  • hotkey to focus chat box

0.0.2

• Andrew Kelley:
  • learn mpd host and port in mpd conf
  • render unknown albums and unknown artists the same in the playlist (blank)
  • auto-scroll playlist window and library window appropriately
  • fix server crash when no top-level files exist
  • fix some songs error message when uploading
  • edit file uploader spinny gif to fit the theme
  • move chat stuff to another tab
• Josh Wolfe:
  • tracking who is online