X-Git-Url: https://git.kaliko.me/?a=blobdiff_plain;f=data%2Fman%2Fmpd_sima.1.xml;h=a67b4e517c61ed2e38913cb7e087603749e5d1ca;hb=abb05a55c1b6c27a11bbd90efbc594ad6331bbc6;hp=44d77c4bfb5f004e76084cee0c0b127352e5c0a6;hpb=e49af6fd502e9b4e43c1d2f1b93cb01a2e381e4d;p=mpd-sima.git diff --git a/data/man/mpd_sima.1.xml b/data/man/mpd_sima.1.xml index 44d77c4..a67b4e5 100644 --- a/data/man/mpd_sima.1.xml +++ b/data/man/mpd_sima.1.xml @@ -57,39 +57,54 @@ man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/ &dhpackage; - &dhpackage; will try to maintain some titles ahead in your play list following different policies. + &dhpackage; will try to maintain some titles ahead in the queue following different policies. &dhpackage; conf_file - var_directory + var_directory pid_file log_file log_level mpd_host mpd_port - - &dhpackage; - var_directory - - &dhpackage; - - + + + - + + &dhpackage; + config-test + conf_file + + + &dhpackage; + create-db + var_directory + + + &dhpackage; + generate-config + + + + &dhpackage; + purge-history + var_directory + DESCRIPTION @@ -100,14 +115,16 @@ man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/ command lines options are honored. For instance you can override default MPD_HOST set in defaults (localhost) or in your configuration file with -S my_mpd_server option. For default - configuration see . + configuration see . See also environment + variables special case for MPD host and port in . + EXAMPLE Launch as a system service (dæmon). Here follows an example on how to launch &dhpackage; as a service on your system, not attach to regular user configuration/database. - &dhpackage; --daemon --conf=/etc/mpd_sima.cfg --var_dir=/var/cache/mpd-sima/ --pid=/run/mpd-sima.pid --log=/var/log/mpd-sima.log + &dhpackage; --daemon --conf=/etc/mpd_sima.cfg --var-dir=/var/cache/mpd-sima/ --pid=/run/mpd-sima.pid --log=/var/log/mpd-sima.log Launch in user land @@ -167,23 +184,25 @@ man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/ Verbosity in [debug,info,warning,error].Default is to log info messages. - + - Use the specific file conf_file to set up configuration instead of looking for the default user configuration file.Default is to look for $XDG_CONFIG_HOME/mpd_sima/mpd_sima.cfg. Concerning this file see also .Pay attention: Because you load a specific configuration file from command line interface does not mean it will override others options pass to mpd_sima. In other words launching with will override port setting whatever the configuration file your using, default or command line specified. + Use the specific file conf_file to set up + configuration instead of looking for the default user + configuration file.Default is to look for + $XDG_CONFIG_HOME/mpd_sima/mpd_sima.cfg. + CLI option overrides any equivalent mentioned in configuration file, ie. launching &dhutils; with '' CLI option will ignore port setting in configuration file. + For more details on configuration file cf. + mpd_sima.cfg + 5, see also . + - - + + - Use the specific path var_directory to look for (or create) var files (ie. database) instead of looking at the default user data location.Default is to look in $XDG_DATA_HOME/mpd_sima/. Concerning $XDG_DATA_HOME see also - - - - - - Create the database and exit. Uses folder specified with or default directory.Default is to use $XDG_DATA_HOME/mpd_sima/. Concerning $XDG_DATA_HOME see also + Use the specific path var_directory to look for (or create) var files (ie. database) instead of looking at the default user data location.Default is to look in $XDG_DATA_HOME/mpd_sima/. Concerning $XDG_DATA_HOME see also . @@ -202,35 +221,34 @@ man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/ See also + + + + Test configuration file and exit. Uses the configuration file specified with or default location.Default is to use $XDG_CONFIG_HOME/mpd_sima/mpd_sima.cfg (see for more). + config-test tests MPD connection and Tags plugin configuration. + + + + + + Create the database and exit. Uses folder specified with or default directory.Default is to use $XDG_DATA_HOME/mpd_sima/ (see for more). + + + + + + Generate a sample configuration file according to the current CLI options and env. var.. The configuration is written on stdout. + + + + + + Purge play history in the database and exit. Uses folder specified with or default directory.Default is to use $XDG_DATA_HOME/mpd_sima/ (see for more). + + - - FILES - - - ${XDG_CONFIG_HOME}/mpd_sima/mpd_sima.cfg - - - The per-user configuration file. Usually XDG_CONFIG_HOME is set to ${HOME}/.config. - - - - ${XDG_DATA_HOME}/mpd_sima/sima.db - - - SQLite database. Usually XDG_DATA_HOME is set to ${HOME}/.local/share. - - - - + ENVIRONMENT @@ -246,6 +264,12 @@ man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/ + + HTTP_PROXY, HTTPS_PROXY + + &dhutils; honors HTTP_PROXY environment variables. + + @@ -257,7 +281,7 @@ man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/ mpd_sima.cfg is read if present. Otherwise built-in defaults are used. An example should be provided in the tarball within - doc/examples/mpd_sima.cfg. On Debian + doc/examples/. On Debian system please look in /usr/share/doc/&dhpackage;. @@ -265,35 +289,19 @@ man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/ DEFAULTS - Default is to look for MPD server at localhost:6600 (or MPD_HOST/MPD_PORT env. var. if set). - The default behavior is to add one track, - this track is to be chosen among titles from - artists similar to the artist of the currently - played track. MPD_sima will add one track when the - play list is one track long. - To change these defaults, use the configuration file mpd_sima.cfg + Default is to look for MPD server at localhost:6600 (or MPD_HOST/MPD_PORT env. var. if set). The default plugins will use Last.fm to find similar tracks to queue and fallback to random if nothing if found. + The get the defaults as detected by &dhpackage; on your system you can run &dhpackage; to print the config: + &dhpackage; generate-config - - - - SEE ALSO - - - - mpc - 1 - , - mpd - 1 - , - mpd-sima.cfg - 5 - - - - /usr/share/doc/mpd-sima/ + For details about mpd_sima.cfg refer to the manual + + mpd_sima.cfg + 5 + + +