X-Git-Url: https://git.kaliko.me/?a=blobdiff_plain;f=data%2Fman%2Fmpd_sima.1.xml;fp=data%2Fman%2Fmpd_sima.1.xml;h=0000000000000000000000000000000000000000;hb=dd2a18ade8d2cdbd3111c4eb01cf95f4a631f8a7;hp=9873396e17b46dc2700fdf985ed24b18ff34433a;hpb=6288b079e5de8e9ee5482e8009111b6ba3cba93a;p=mpd-sima.git diff --git a/data/man/mpd_sima.1.xml b/data/man/mpd_sima.1.xml deleted file mode 100644 index 9873396..0000000 --- a/data/man/mpd_sima.1.xml +++ /dev/null @@ -1,372 +0,0 @@ - - - - - - -]> - - - - - &dhutils; - &dhsection; - - - &dhutils; - &dhutils; will try to maintain some titles ahead in the queue following different policies. - - - - &dhutils; - - conf_file - var_directory - pid_file - log_file - log_level - mpd_host - mpd_port - - - &dhutils; - - - - - - - - - - - - - &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 - &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 (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 . - - - - EXAMPLE - - Launch as a system service (dæmon). - 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 &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: - &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): - &dhutils; --host=my.mpd.server.org - - - - OPTIONS - The program follows the usual GNU command line syntax, - with long options starting with two dashes (`-'). A summary of - options is included below. - - - - - - - Print help and exit. - - - - - - Print version and exit. - - - - - - Start as a daemon. Log redirected to /dev/null, usually setting and options in daemon mode are a good idea to monitor/stop the process. - - - - - - - Use the specific file pid_file to store pid to.Default is not to store pid info. - - - - - - - Use the specific file log_file to log messages to.Default is to log to stdout/stderr. - - - - - - - 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. - 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 . - - - - - - - Use the specific host mpd_host as MPD server.mpd_host can be an IP or a fully qualified domain name as long as your system can resolve it. This overrides MPD_HOST environment variable.Default is localhost. - See also . - - - - - - - Use the specific port number mpd_port on MPD server. This overrides MPD_PORT environment variable.Default is 6600. - 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. - - - - - - - - ENVIRONMENT - - - MPD_HOST, MPD_PORT - - &dhutils; will look for MPD_HOST and - MPD_PORT to override built-in configuration - (set to "localhost:6600"). - &dhutils; expects MPD_HOST syntax as documented in mpc manual, - cf. mpc1. - To use a password, provide a value of the form "password@host". - - - - - HTTP_PROXY, HTTPS_PROXY - - &dhutils; honors HTTP_PROXY environment variables. - - - - - - CONFIGURATION - - - mpd_sima.cfg - - mpd_sima.cfg is read if present. - Otherwise built-in defaults are used. An example should be - provided in the tarball within - doc/examples/. On Debian - system please look in - /usr/share/doc/&dhpackage;. - - - - DEFAULTS - - 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 - - - - For details about mpd_sima.cfg refer to the manual - - mpd_sima.cfg - 5 - - - - - -