VERSION

version 2.004

DESCRIPTION

This program implements a dynamic playlist for MPD, build on top of the Audio::MPD perl module.

MPD (music player daemon) is a cool music player, but it lacks a dynamic playlist. A dynamic playlist is a playlist that will change automatically over time. In particular, it will remove already played songs (keeping at most a given number of songs) and add new songs to the playlist so it never fall short of songs.

Note that since mpd is a daemon needing no gui to work, "mpd-dynamic" is also a daemon. That is, it will fork and do all its work from the background. This way, you can fire "mpd" and "mpd-dynamic" and forget completely about your music (especially since "mpd-dynamic" is a low-resource program): it will just be there! :-)

USAGE

    mpd-dynamic [options]

OPTIONS

General behaviour

You can customize the usage of mpd-dynamic with the following options:

-o[ld] <old>

Number of old tracks to keep in the backlog. Defaults to 10.

-n[ew] <new>

Number of new tracks to keep in the to-be-played playlist. Defaults to 10.

-s[leep] <sleep>

Time spent sleeping (in seconds) before checking if playlist should be updated. Default to 5 seconds.

-d[ebug]

Run mpd-dynamic in debug mode. In particular, the program will not daemonize itself. Default to false.

-e[ncoding] <encoding>

Print debug messages with this encoding. Since mpd-dynamic is meant to be a silent daemon, this option will not be used outside of debug mode. Default to "utf-8".

--version

--usage

--help

--man

Print the usual program information

Note however that those flags are optional: since "mpd-dynamic" comes with some sane defaults, you can fire "mpd-dynamic" as is.

Ratings

You can also take advantage of ratings if you want. With those options, songs need to have at least a given rating (or no rating yet) to be inserted: this way, you will only listen to your favorite songs!

Ratings can be created / updated with "mpd-rate".

Note that if you supply a non-existant rating db-file, the rating mechanism will be ignored. The following options control the rating mechanism:

-r[atings] <ratings>

The path of a db file with the ratings per song. The keys are the song path (relative to MPD root), and the value is an integer (the rating). Default to "~/.mpd/ratings.db".

-m[in[imum]] <min>

The minimum rating for a song to be inserted in the playlist. Default to 4.

AUTHOR

Jerome Quelin

COPYRIGHT AND LICENSE

This software is copyright (c) 2007 by Jerome Quelin.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.