X-Git-Url: https://git.kaliko.me/?a=blobdiff_plain;f=data%2Fman%2Fmpd_sima.cfg.5.xml;h=149087f8a2a36243215ba6e2903e0b887d578afb;hb=2bdb311df29a1524223c606e52c72d0524ed6bda;hp=002b1413a635796a9001356ea6746faa4b9d12b5;hpb=41e7f45be3c35a4630478211b2036ce496fdf588;p=mpd-sima.git diff --git a/data/man/mpd_sima.cfg.5.xml b/data/man/mpd_sima.cfg.5.xml index 002b141..149087f 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. @@ -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. @@ -206,8 +212,7 @@ man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/ 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 here as many plugins you want, - currently shipping only. + You can add, combine here as many plugins you want. The priority may be used to order them. @@ -288,6 +293,12 @@ man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/ + + 1 + + How many track(s) to add. + + sensible @@ -342,7 +353,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. @@ -372,7 +383,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. @@ -382,6 +395,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 @@ -404,56 +425,116 @@ man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/ + + 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 + + + + + 1 + + How many track(s) to add. + + + QUEUE MODES - &dhpackage; offers different queue modes. All of them pick up - tracks from artists similar to the last track in the queue. + Different queue modes are available with some plugins (check for + presence in plugin config). + &dhpackage; tries preferably to chose among unplayed artists or - at least not recently played artist. Concerning track and album - queue modes titles are chosen purely at random among unplayed - tracks. + at least not recently played artist. - - - - Queue a similar track chosen at random from a similar artist. - - - - - - Queue a track from a similar artist, chosen among - "top tracks" according to last.fm data mining. - - - - - - Queue a whole album chosen at random from a similar artist. - Nota Bene: Due to the - track point of view of database build upon tracks tags - an album lookup for a specific artist will return - albums as soon as this artist appears in a single track - of the album. - For instance looking for album from "The Velvet - Underground" will fetch "Last Days" and "Juno" OSTs - because the band appears on the soundtrack of these two - movies. - A solution is for you to set AlbumArtists tag to - something different than the actual artist of the - track. For compilations, OSTs etc. a strong convention - is to use "Various Artists" for this tag. - &dhpackage; is currently looking for AlbumArtists tags - 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. - - + + + + Queue a similar track chosen at random from a similar artist. + + + + + + Queue a track from a similar artist, chosen among + "top tracks" according to last.fm data mining. + + + + + + Queue a whole album chosen at random from a similar artist. + Nota Bene: Due to the + track point of view of database build upon tracks tags + an album lookup for a specific artist will return + albums as soon as this artist appears in a single track + of the album. + For instance looking for album from "The Velvet + Underground" will fetch "Last Days" and "Juno" OSTs + because the band appears on the soundtrack of these two + movies. + A solution is for you to set AlbumArtists tag to + something different than the actual artist of the + track. For compilations, OSTs etc. a strong convention + is to use "Various Artists" for this tag. + &dhpackage; is currently looking for AlbumArtists tags + 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. + + +