MPD-DYNAMIC(1p) 					User Contributed Perl Documentation					   MPD-DYNAMIC(1p)

NAME

       mpd-dynamic - a dynamic playlist for mpd

VERSION

       version 1.120610

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.

perl v5.14.2							    2012-03-01							   MPD-DYNAMIC(1p)