X-Git-Url: http://git.kaliko.me/?a=blobdiff_plain;f=data%2Fman%2Fmpd_sima.cfg.5;h=345864f59509a56f2e0c8afb9f560b8418c21e7e;hb=e703692c1f6f2cbac143c19dac2fb5800be8b6ea;hp=d5e0c5793cb1d1f6a582aaf46724d05ca1345b0a;hpb=8c72e63ba4d41c4d9722ddff3c000de314ff66dc;p=mpd-sima.git diff --git a/data/man/mpd_sima.cfg.5 b/data/man/mpd_sima.cfg.5 index d5e0c57..345864f 100644 --- a/data/man/mpd_sima.cfg.5 +++ b/data/man/mpd_sima.cfg.5 @@ -1,13 +1,13 @@ '\" t .\" Title: mpd_sima.cfg -.\" Author: Jack Kaliko -.\" Generator: DocBook XSL Stylesheets v1.78.1 -.\" Date: 09/20/2015 -.\" Manual: mpd-sima 0.14.0 User Manual +.\" Author: kaliko +.\" Generator: DocBook XSL Stylesheets v1.79.1 +.\" Date: 12/14/2020 +.\" Manual: mpd-sima 0.16.0 User Manual .\" Source: mpd-sima .\" Language: English .\" -.TH "MPD_SIMA\&.CFG" "5" "09/20/2015" "mpd-sima" "mpd-sima 0.14.0 User Manual" +.TH "MPD_SIMA\&.CFG" "5" "12/14/2020" "mpd-sima" "mpd-sima 0.16.0 User Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -36,9 +36,40 @@ This manual page documents briefly configuration options available in user configuration file (see the section called \(lqFILES\(rq)\&. .SH "EXAMPLES" -.SS "Album queue mode\&." +.SS "File tags queue mode (offline mode)\&." .PP -Here is an example of album queue configuration\&. +Here is an example of autoqueue using file tags only\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +[MPD] +host=example\&.org +port=6601 + +[sima] +# Setup internal plugins +internal = Tags, Crop +history_duration=48 # 2 days +queue_length=2 + +[tags] +# Look for files with tagged with genre "electonica" OR "IDM" OR "glitch" +genre = electonica, IDM, glitch + +[crop] +# keep 30 played tracks in playlist +consume=30 + + +.fi +.if n \{\ +.RE +.\} +.SS "Album queue mode using last\&.fm recommendations (online mode)\&." +.PP +Here is an example of album queue configuration using online recommendations system\&. .sp .if n \{\ .RS 4 @@ -116,7 +147,7 @@ Configure logging\&. .RS 4 File to log to, usually in d\(aemon mode\&. .br -Defaut (empty or unset) is to log to stdin/stdout\&. +Default (empty or unset) is to log to stdin/stdout\&. .RE .PP \fBverbosity=\fR\fIinfo\fR @@ -171,19 +202,17 @@ For instance a "AwesomePlugin" declared here gets its configuration from the cor The default list of plugins to load at startup: \fBLastfm\fR,\fBRandom\fR,\fBCrop\fR\&. .br + \fBCrop\fR is an utility plugin, it does not queue any tracks (cf\&. below)\&. .br + \fBRandom\fR will queue a track at random if other plugins did not return any tracks\&. .br .sp -You can add here as many plugins you want, currently shipping -\fBLastfm\fR -and -\fBEchoNest\fR -only\&. +You can add, combine here as many plugins you want\&. .br The priority may be used to order them\&. @@ -212,6 +241,16 @@ Use MusicBrainzIdentifier to search music (mainly for artists)\&. Default is Tru Consider using these metadata as it enhances a lot artist/album/tracks identification\&. Use Picard to tag your file: \m[blue]\fB\%https://picard.musicbrainz.org/\fR\m[]\&. .RE +.PP +\fBrepeat_disable_queue=\fR\fItrue\fR +.RS 4 +Prevent disabling queuing in repeat play mode\&. +.RE +.PP +\fBsingle_disable_queue=\fR\fItrue\fR +.RS 4 +Prevent disabling queuing in single play mode\&. +.RE .SS "Crop section" .PP crop plugin\*(Aqs configuration: @@ -305,7 +344,7 @@ for info about queue modes)\&. .PP \fBmax_art=\fR\fI10\fR .RS 4 -Number of similar artist to retrieve from local media library\&. +Maximum number of similar artist to retrieve from local media library\&. .br When set to something superior to zero, it tries to get as much similar artists from media library\&. .RE @@ -332,7 +371,8 @@ How many track(s) to add\&. Only relevant in \fBtop\fR and \fBtrack\fR -queue modes\&. +queue modes\&. This is actually an upper limit, min(\fBmax_art\fR, +\fBtrack_to_add\fR) will be used\&. .RE .PP \fBalbum_to_add=\fR\fI1\fR @@ -342,12 +382,20 @@ How many album(s) to add\&. Only relevant in queue modes\&. .RE .PP +\fBtrack_to_add_from_album=\fR\fI0\fR +.RS 4 +How many track(s) to add from each selected albums\&. Only relevant in +\fBalbum\fR +queue modes\&. When set to 0 or lower the whole album is queued\&. +.RE +.PP \fBcache=\fR\fITrue\fR .RS 4 Whether or not to use on\-disk persistent http cache\&. .br When set to "true", sima will use a persistent cache for its http client\&. The cache is written along with the dbfile in: .br + $XDG_CONFIG_HOME/mpd_sima/http/WEB_SERVICE\&. .br @@ -358,46 +406,64 @@ If set to "false", caching is still done but in memory\&. .RS 4 Plugin priority .RE -.SS "EchoNest section" +.SS "Tags section" .PP -EchoNest plugin\*(Aqs configuration\&. +Tags plugin\*(Aqs configuration\&. There is no default configuration for this plugin, it does not work out of the box\&. .PP -Options for EchoNest are exactly the same as LastFm (same default as well), except for cache plugin which is always needed to limit number of requests to the service\&. +This plugin permits offline autoqueuing based on files tags only\&. Supported tags are +\fB\*(Aqcomment\*(Aq\fR, +\fB\*(Aqdate\*(Aq\fR, +\fB\*(Aqgenre\*(Aq\fR, +\fB\*(Aqlabel\*(Aq\fR +and +\fB\*(Aqoriginaldate\*(Aq\fR\&. It currently supports single track queuing only, no album mode for this plugin\&. .PP -\fB[echonest]\fR -.RS 4 -.RE +In addition to supported tags above you can use an MPD filter\&. Please refer to MPD protocol documentation for more\&. .PP -\fBqueue_mode=\fR\fItrack\fR +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\&. +.br + +For instance setting "\fBgenre=rock\fR" and "\fBdate=1982,1983,1984,1985,1986,1987,1988,1989\fR" will end up looking for track tagged with genre +\fBrock\fR +and date within 1985 through 1990\&. +.br + +Using an MPD filter to replace +\fBdate\fR +you can achieve the same with the following setting: "\fBgenre=rock\fR" and "\fBfilter=(date =~ \*(Aq198[2\-9]\*(Aq)\fR" (provided your MPD server was compiled with libpcre)\&. +.PP +\fB[tags]\fR .RS 4 .RE .PP -\fBmax_art=\fR\fI10\fR +\fBfilter=\fR .RS 4 +You can use here any valid MPD filter as defined in MPD protocol documentation\&. .RE .PP -\fBdepth=\fR\fI1\fR +\fBcomment=\fR .RS 4 .RE .PP -\fBsingle_album=\fR\fIfalse\fR +\fBdate=\fR .RS 4 .RE .PP -\fBtrack_to_add=\fR\fI1\fR +\fBgenre=\fR .RS 4 .RE .PP -\fBalbum_to_add=\fR\fI1\fR +\fBlabel=\fR .RS 4 .RE .PP -\fBpriority=\fR\fI100\fR +\fBpriority=\fR\fI80\fR .RS 4 +Plugin priority .RE .SH "QUEUE MODES" .PP -mpd\-sima offers different queue modes\&. All of them pick up tracks from artists similar to the last track in the queue\&. +mpd\-sima offers different queue modes with lastfm plugin\&. All of them pick up tracks from artists similar to the last track in the queue\&. .PP mpd\-sima 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\&. .PP @@ -463,7 +529,7 @@ and .SH "FEEDBACK/BUGS" .PP The maintainer would be more than happy to ear from you, don\*(Aqt hesitate to send feedback, -\m[blue]\fB\%http://kaliko.me/id/\fR\m[]\&. +\m[blue]\fB\%https://kaliko.me/contact/\fR\m[]\&. .PP XMPP users are welcome to join the dedicated chat room at @@ -476,13 +542,13 @@ users are welcome to join the dedicated chat room at /usr/share/doc/mpd\-sima/ .SH "AUTHOR" .PP -\fBJack Kaliko\fR <\&kaliko@azylum\&.org\&> +\fBkaliko\fR <\&kaliko@azylum\&.org\&> .RS 4 Wrote this man page and is currently leading MPD_sima project\&. .RE .SH "COPYRIGHT" .br -Copyright \(co 2009-2015 Jack Kaliko +Copyright \(co 2009-2020 kaliko .br .PP This manual page was written for the Debian system (and may be used by others)\&.