X-Git-Url: http://git.kaliko.me/?a=blobdiff_plain;f=data%2Fman%2Fmpd_sima.cfg.5.xml;h=8ff9db0312e88f00c1a559bfede3aceaac08d719;hb=e703692c1f6f2cbac143c19dac2fb5800be8b6ea;hp=97018d801ca9aca21f2c90c6cf4aef3cbf21523f;hpb=7bd1cf9a791b7dc46fea0b665535996406cda819;p=mpd-sima.git
diff --git a/data/man/mpd_sima.cfg.5.xml b/data/man/mpd_sima.cfg.5.xml
index 97018d8..8ff9db0 100644
--- a/data/man/mpd_sima.cfg.5.xml
+++ b/data/man/mpd_sima.cfg.5.xml
@@ -75,9 +75,15 @@ man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/
-->
+
+ File tags queue mode (offline mode).
+ Here is an example of autoqueue using file tags only.
+
+
+
- Album queue mode.
- Here is an example of album queue configuration.
+ Album queue mode using last.fm recommendations (online mode).
+ Here is an example of album queue configuration using online recommendations system.
@@ -129,8 +135,8 @@ man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/
- Configure logging.log section
+ Configure logging.
@@ -139,7 +145,7 @@ man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/
- File to log to, usually in dæmon mode.Defaut
+ File to log to, usually in dæmon mode.Default
(empty or unset) is to log to stdin/stdout.
@@ -155,64 +161,106 @@ man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/
-
- sima section
- Core &dhutils; configuration.
+
+ Process daemonization
+ Configure process daemon.
-
-
+
+
-
- 8
-
- How far to look back in history to avoid to play
- twice the same track/title (duration in
- hours).
-
-
-
- 1
+
+
- This value triggers queue process if the queue
- length is less than specified
- queue_length.
+ whether to daemonize process or not.
-
- false
+
+
- Temporarily removed feature
-
+ Where to store process ID.
- &dhpackage;'s plugin management for internal source plugin
- and contrib (ie. external plugins). Plugins list is a
- comma separated string list. Optional plugin's
- configuration lays in its own section.For instance a
- "AwesomePlugin" declared here gets its configuration from the
- corresponding section "[awesomeplugin]".internal plugins
- will look for a section named after the lower-cased name of the
- pluglin, ie. RandomFallBack â randomfallback.
-
+
+
+ sima section
+ Core &dhutils; configuration.
-
- Crop, RandomFallBack, Lastfm
-
- and
- are utilities plugins while is the
- actual queue plugin. Another queue plugin is available as
- a "techno preview", it relies on EchoNest web services, replace
- with to try.
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+ Lastfm, Random, Crop
+
+ &dhpackage;'s plugin management for internal source plugin
+ and contrib (ie. external plugins). Plugins list is a
+ comma separated string list. Optional plugin's
+ configuration lays in its own section.For instance a
+ "AwesomePlugin" declared here gets its configuration from the
+ corresponding section "[awesomeplugin]".
+
+ The default list of plugins to load at startup: ,,.
+ is an utility plugin, it does not queue any tracks (cf. below).
+ will queue a track at random if other plugins did not return any tracks.
+
+ You can add, combine here as many plugins you want.
+ The priority may be used to order them.
+
+
+
+
+ 8
+
+ How far to look back in history to avoid to play
+ twice the same track/title (duration in
+ hours).
+ The is also used to give priority to not recently played artists.
+
+
+
+
+ 2
+
+ Threshold value triggering queue process.
+
+
+
+ true
+
+ Use MusicBrainzIdentifier to search music (mainly
+ for artists).
+ Default is True, switch to False if you don't have
+ MusicBrainzIdentifier set for at least 80% of you
+ music library. Consider using these metadata as it
+ enhances a lot artist/album/tracks identification.
+ Use Picard to tag your file: .
+
+
+
+
+ true
+
+ Prevent disabling queuing in repeat play mode.
+
+
+
+
+ true
+
+ Prevent disabling queuing in single play mode.
+
+
+
+
@@ -222,22 +270,30 @@ man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/
- 0
+ 10How many played tracks to keep in the queue.
Allows you to maintain a fixed length queue.
- Set to 0 to keep all played tracks.
+ Set to some negative integer to keep all played tracks.
+
+
+
+
+ 10
+
+
+ Plugin priority
-
- RandomFallback section
- RandomFallback plugin's configuration:
-
-
+
+ Random section
+ Random plugin's configuration:
+
+
-
+ sensibleWhen no similar tracks are found, falling back to
@@ -263,6 +319,14 @@ man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/
+
+ 50
+
+
+ Plugin priority
+
+
+ LastFm section
@@ -283,7 +347,7 @@ man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/
10
- Number of similar artist to retrieve from local
+ Maximum number of similar artist to retrieve from local
media library.When set to something superior
to zero, it tries to get as much similar artists
from media library.
@@ -313,7 +377,9 @@ man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/
How many track(s) to add. Only relevant in
and
- queue modes.
+ queue modes. This is actually an upper limit,
+ min(,
+ ) will be used.
@@ -323,6 +389,14 @@ man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/
queue modes.
+
+ 0
+
+ How many track(s) to add from each selected albums. Only relevant in
+ queue modes. When set to 0 or lower the whole album is queued.
+
+
+ True
@@ -335,12 +409,73 @@ man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/
+
+ 100
+
+
+ Plugin priority
+
+
+
+
+ Tags section
+ Tags plugin's configuration. There is no default configuration for this plugin, it does not work out of the box.
+
+ This plugin permits offline autoqueuing based on files tags only. Supported tags are
+ , , , and
+ . It currently supports single track queuing only, no album mode for this plugin.
+
+
+ In addition to supported tags above you can use an MPD filter. Please refer to MPD protocol documentation for more.
+
+
+ All entries in this section are ANDed as a single MPD filter to look for titles
+ in the library. Moreover, with tags, comma separated values are also ANDed.
+ For instance setting "" and
+ ""
+ will end up looking for track tagged with genre
+ and date within 1985 through 1990.
+ Using an MPD filter to replace you can achieve
+ the same with the following setting: "" and
+ "" (provided your MPD server
+ was compiled with libpcre).
+
+
+
+
+
+
+
+ You can use here any valid MPD filter as defined in MPD protocol documentation.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 80
+
+
+ Plugin priority
+
+
+
+ QUEUE MODES
- &dhpackage; offers different queue modes. All of them pick up
+ &dhpackage; offers different queue modes with lastfm plugin. All of them pick up
tracks from artists similar to the last track in the queue.&dhpackage; tries preferably to chose among unplayed artists or
at least not recently played artist. Concerning track and album
@@ -381,10 +516,7 @@ man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/
and avoid album where this tag is set with "Various
Artists". If a single track within an album is found
with AlbumArtists:"Various Artists" the complete album
- is skipped and won't be queued.
- It is planned to allow users to set the values of
- AlbumArtists tag triggering this behaviour. cf.
- feature request #2085 on the tracker.
+ is skipped and won't be queued.
@@ -393,3 +525,5 @@ man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/
+