X-Git-Url: https://git.kaliko.me/?a=blobdiff_plain;f=data%2Fman%2Fmpd_sima.cfg.5.xml;fp=data%2Fman%2Fmpd_sima.cfg.5.xml;h=0000000000000000000000000000000000000000;hb=dd2a18ade8d2cdbd3111c4eb01cf95f4a631f8a7;hp=c8efb9672061f40688828f32ba774d75a1fb2f82;hpb=6288b079e5de8e9ee5482e8009111b6ba3cba93a;p=mpd-sima.git diff --git a/data/man/mpd_sima.cfg.5.xml b/data/man/mpd_sima.cfg.5.xml deleted file mode 100644 index c8efb96..0000000 --- a/data/man/mpd_sima.cfg.5.xml +++ /dev/null @@ -1,604 +0,0 @@ - - - - - - -]> - - - - - &dhutils; - &dhsection; - - - &dhutils; - &dhpackage; will try to maintain some titles ahead in the queue - following different policies. This manual document the - configuration file for &dhpackage;. - - - DESCRIPTION - This manual page documents briefly &dhpackage; - configuration options available in user configuration file - (see ). - - - EXAMPLES - - - File tags queue mode (offline mode). - Here is an example of autoqueue using file tags only. - - - - - Album queue mode using last.fm recommendations (online mode). - Here is an example of album queue configuration using online recommendations system. - - - - - - - Configuration file - The configuration file consists of sections, led by a - [section] header and followed by - entries, with continuations in the style of RFC 822 (see section - 3.1.1, “LONG HEADER FIELDS”); is also accepted. Lines - beginning with '#' or ';' - are ignored and may be used to provide comments (Nota - Bene: inline comment are possible using '#'). - OPTIONS - The default values are used in the options lists below. - - MPD section - This section is meant to configure MPD access, MPD host - address / port and password if necessary. - - - - - - - - localhost - - Set MPD host. Use IP or FQDN. - - - - 6600 - - Set host port to access MPD to. - - - - s3cr3t - - Set MPD password to use. Do not use this option - if you don't have enabled password protected access - on your MPD server. - - - - - - log section - Configure logging. - - - - - - - - - File to log to, usually in dæmon mode.Default - (empty or unset) is to log to stdin/stdout. - - - - info - - Logging verbosity among - debug, - info, - warning, - error. - - - - - - Process daemonization - Configure process daemon. - - - - - - - - - whether to daemonize process or not. - - - - - - Where to store process ID. - - - - - - sima section - Core &dhutils; configuration. - - - - - - - - - - - - - - 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. - - - - - - - - Crop section - crop plugin's configuration: - - - - - 10 - - How many played tracks to keep in the queue. - Allows you to maintain a fixed length queue. - Set to some negative integer to keep all played tracks. - - - - - 10 - - - Plugin priority - - - - - - Random section - When no similar tracks are found, falling back to random queuing. - Random plugin's configuration: - - - - - 1 - - How many track(s) to add. - - - - sensible - - Different mode, aka random flavour, - are available: - pure, - sensible, - - - pure, pure random choice, even among recently played track. - - - - sensible, use play history to filter chosen tracks. - - - - - - - - 50 - - - Plugin priority - - - - - - LastFm section - LastFM plugin's configuration. - - - - - - track - - Queue mode to use among - track, - top and - album (see for info about queue modes). - - - - 10 - - 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. - - - - 1 - - How many artists to base on similar artists - search. The first is the last played artist - and so on back in the history. Highter depth - generates wider suggestions, it might help to - reduce looping over same artists. - - - - - false - - Prevent from queueing a track from the same album - (it often happens with OST). - Only relevant in "track" queue mode. - - - - 1 - - How many track(s) to add. Only relevant in - and - queue modes. This is actually an upper limit, - min(, - ) will be used. - - - - 1 - - How many album(s) to add. Only relevant in - 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 - - Whether or not to use on-disk persistent http - cache.When set to "true", sima will use a - persistent cache for its http client. The cache is - written along with the dbfile in: - $XDG_DATA_HOME/mpd_sima/http/WEB_SERVICE. - If set to "false", caching is still done but in memory. - - - - - 100 - - - Plugin priority - - - - - - - Genre section - Genre plugin's configuration. - This plugin permits offline autoqueuing based on files genre tag only. - It will try to queue tracks with similar genres (track's genre being read from tags). - - - - - track - - Queue mode to use among - track, - album (see for info about queue modes). - - - - false - - Prevent from queueing a track from the same album - (it often happens with OST). - Only relevant in "track" queue mode. - - - - 80 - - - Plugin priority - - - - - 1 - - How many track(s) to add. - - - - 1 - - How many album(s) to add. Only relevant in - queue mode. - - - - - 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 . - In addition to supported tags above you can use an MPD filter. Please refer to - MPD protocol documentation for more. - All tag entries in this section are ANDed as a single MPD filter to look for titles - in the library. Moreover, for each tags, comma separated values are also ORed. - For instance setting "" and - "" - will end up looking for track tagged with genre - and date within 1982 through 1989. - Using an MPD filter to replace you can achieve - the same with the following setting: "" and - "" (provided your MPD server - was compiled with libpcre). - - - - - - track - - Queue mode to use among - track, - album (see for info about queue modes). - - - - false - - Prevent from queueing a track from the same album - (it often happens with OST). - Only relevant in "track" queue mode. - - - - - - You can use here any valid MPD filter as defined in MPD protocol documentation. - - - - - - - - - - - - - - - - - - - 80 - - - Plugin priority - - - - - 1 - - How many track(s) to add. - - - - 1 - - How many album(s) to add. Only relevant in - queue mode. - - - - - - QUEUE MODES - 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. - - - - - 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. - - - - - - - - -