diff --git a/docs/plugins/index.rst b/docs/plugins/index.rst index a71bcae6f..7d1393b0c 100644 --- a/docs/plugins/index.rst +++ b/docs/plugins/index.rst @@ -24,6 +24,7 @@ by typing ``beet version``. echonest_tempo echonest bpd + mpc mpdupdate fetchart embedart @@ -80,6 +81,8 @@ Metadata * :doc:`zero`: Nullify fields by pattern or unconditionally. * :doc:`ftintitle`: Move "featured" artists from the artist field to the title field. +* :doc:`mpc`: Connect to `MPD`_ and update the beets library with playing + statistics (last_played, play_count, skip_count). .. _Acoustic Attributes: http://developer.echonest.com/acoustic-attributes.html .. _the Echo Nest: http://www.echonest.com diff --git a/docs/plugins/mpc.rst b/docs/plugins/mpc.rst new file mode 100644 index 000000000..04ea06e74 --- /dev/null +++ b/docs/plugins/mpc.rst @@ -0,0 +1,26 @@ +MPC Plugin +================ + +``mpc`` is a plugin for beets that collects statistics about your listening +habits from `MPD`_. It collects the following information about tracks:: + +* play_count: The number of times you *fully* listened to this track. +* skip_count: The number of times you *skipped* this track. +* last_played: UNIX timestamp when you last played this track. +* rating: A rating based on *play_count* and *skip_count*. + +.. _MPD: http://mpd.wikia.com/wiki/Music_Player_Daemon_Wiki + +To use it, enable it in your ``config.yaml`` by putting ``mpc`` on your +``plugins`` line. Then, you'll probably want to configure the specifics of your +MPD server. You can do that using an ``mpc:`` section in your +``config.yaml``, which looks like this:: + + mpc: + host: localhost + port: 6600 + password: seekrit + +Now use the ``mpc`` command to fire it up:: + + $ beet mpc