MPD-DYNAMIC(1)

NAME
mpd-dynamic - a dynamic playlist for mpd

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.