X-Git-Url: https://git.kaliko.me/?a=blobdiff_plain;f=data%2Fman%2Fmpd_sima.1.xml;h=9873396e17b46dc2700fdf985ed24b18ff34433a;hb=6288b079e5de8e9ee5482e8009111b6ba3cba93a;hp=c0b59d49a63f891cd40bf1cac4cc1d3a6e68775b;hpb=8c72e63ba4d41c4d9722ddff3c000de314ff66dc;p=mpd-sima.git diff --git a/data/man/mpd_sima.1.xml b/data/man/mpd_sima.1.xml index c0b59d4..9873396 100644 --- a/data/man/mpd_sima.1.xml +++ b/data/man/mpd_sima.1.xml @@ -43,7 +43,7 @@ man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/ - + ]> @@ -56,12 +56,12 @@ man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/ &dhsection; - &dhpackage; - &dhpackage; will try to maintain some titles ahead in the queue following different policies. + &dhutils; + &dhutils; will try to maintain some titles ahead in the queue following different policies. - &dhpackage; + &dhutils; conf_file var_directory @@ -72,17 +72,7 @@ man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/ mpd_port - &dhpackage; - --create-db - var_directory - - - &dhpackage; - --generate-config - - - - &dhpackage; + &dhutils; @@ -95,16 +85,60 @@ man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/ + + &dhutils; + config-test + conf_file + + + &dhutils; + create-db + var_directory + + + &dhutils; + generate-config + + + + &dhutils; + purge-history + var_directory + + + &dhutils; + bl-view + + + &dhutils; + bl-add-artist + + + + &dhutils; + bl-add-album + + + + &dhutils; + bl-add-track + + + + &dhutils; + bl-delete + + DESCRIPTION This manual page documents briefly the - &dhpackage; commands. + &dhutils; commands. At start up default configuration is first overridden by user configuration in mpd_sima.cfg (see ) and finally 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 + default MPD host (localhost) in your configuration + file or with -S my_mpd_server option. For default configuration see . See also environment variables special case for MPD host and port in . @@ -113,16 +147,16 @@ man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/ 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 + Here follows an example on how to launch &dhutils; as a service on your system, not attach to regular user configuration/database. + &dhutils; --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 - Launching &dhpackage; from/whithin your user account is easy, you can simply call &dhpackage; from your shell or one of the following command: + Launching &dhutils; from/whithin your user account is easy, you can simply call &dhutils; from your shell or one of the following command: Background execution (dæmonise), log in the specified file, save pid: - &dhpackage; --daemon --pid=$HOME/var/run/mpd-sima.pid --log=$HOME/var/log/mpd-sima.log + &dhutils; --daemon --pid=$HOME/var/run/mpd-sima.pid --log=$HOME/var/log/mpd-sima.log Foreground execution, connect my.mpd.server.org, log to std(out|err): - &dhpackage; --host=my.mpd.server.org + &dhutils; --host=my.mpd.server.org @@ -192,19 +226,7 @@ man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/ - 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 - - - - - - Generate a sample configuration file according to the current configuration. You can put other options with this one to get them in the generated configuration. - - - - - - 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 . @@ -223,6 +245,72 @@ 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). + + + + + + View blocklist, useful to get entry IDs to remove with delete command. + + + + + + Add artist to the blocklist. If + artist + is not provided, try to get the currently playing artist. + + + + + + + Add album to the blocklist. If + album + is not provided, try to get the currently playing album. + + + + + + + Add track to the blocklist. If + track + is not provided, try to get the currently playing track. + + + + + + + Remove blocklist entry referenced by its + id. Use bloclist view command to get the id. + + + @@ -241,6 +329,12 @@ man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/ + + HTTP_PROXY, HTTPS_PROXY + + &dhutils; honors HTTP_PROXY environment variables. + + @@ -260,9 +354,9 @@ 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 get the defaults as detected by &dhpackage; on your system you can run &dhpackage; to print the config: - &dhpackage; --generate-config + 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 &dhutils; on your system you can run &dhutils; to print the config: + &dhpackage; generate-config