MPDBliss ======== MPDBliss is an attempt at binding [Bliss](https://github.com/Polochon-street/bliss) to MPD to be able to play smooth mixes with MPD, _à la_ Grooveshark radio. ## Dependencies To build it you will need `sqlite3` and `libmpdclient`, plus the required dependencies from `bliss` (see [https://github.com/Polochon-street/bliss](https://github.com/Polochon-street/bliss)). ## Build ``` git clone --recursive https://github.com/phyks/mpdbliss cd mpdbliss; mkdir build cmake .. make ``` This will build a `mpdbliss` executable. ## Usage `mpdbliss` is made of two components. First one, `mpdbliss`, has to run on the MPD server machine (or at least have access to the music files) and will build and maintain a parallel database of song "features" and distances between them, as computed by `bliss`. This will be stored in `$XDG_DATA_HOME/mpdbliss/` (defaults to `~/.local/share/mpdbliss`). Second one is a client, to create playlist based on the currently playing song. `client.sh` script at the root of this repository is an example of such a script. Such client script needs to have access to the database build in first step. See `mpdbliss --help` for up to date doc. _Note_: `mpdbliss` supports the `MPD_HOST`/`MPD_PORT` environment variables. You can overload them passing it command-line argument. Passwords should be provided in the host string following the standard MPD syntax. There are basically 3 modes of operation: * `--rescan` which will trigger a full rescan of your MPD database and recreate the associated bliss database. * `--update` which will do the same, but will only consider newly added musics. * Without any flag, `mpdbliss` will listen for MPD IDLE protocol, and trigger an update of the database whenever the MPD database is modified. Typical usage would be to run a `--rescan` first, and then either do periodic `--update` or let it run listening at MPD IDLE protocol to maintain MPD database and `mpdbliss` database in sync. Check the `client.sh` script for an example client script to build smooth MPD playlists.