simadb_cli1
Simadb_cli is a command line interface editor for the sima user db.
Usage
simadb_cli --remove_artist=artist
[--dbfile=db_file]
[--reciprocal]
simadb_cli --purge_hist
[--dbfile=db_file]
simadb_cli --view_all
[--dbfile=db_file]
simadb_cli {--bl_curr_trk | --bl_curr_art | --bl_curr_alb | --bl_art=artist_name}
[--dbfile=db_file]
[--host=mpd_host]
[--port=mpd_port]
simadb_cli --remove_bl=row_id
[--dbfile=db_file]
simadb_cli --view_bl
[--dbfile=db_file]
simadb_cli {{-h | --help} | --version}
Overview
This manual page documents briefly the simadb_cli commands.
simadb_cli is a command line interface to get and edit users blacklist database used with MPD_sima. The default database file (see the section called “FILES”) can be overridden if you want.
Examples
Black list edition
Adding to black list. You can add a single track, an album or an artist to the black list. The element to black list is chosen from the currently playing track. Use --bl_curr_trk to prevent simadb_cli to queue this track, --bl_curr_alb or --bl_curr_art respectively for the album and the artist.
Remember you need access to your MPD server to retrieve information to black list. Defaults are localhost:6600 or found in environment variables but you may set it up from command line:
simadb_cli --bl_curr_art -S mympd.example.org
To black list a specific artist (not currently playing) you can use --bl_ar="Artist name to black list".
Options
The program follows the usual GNU command line syntax, with long options starting with two dashes ("-"). A summary of options is included below.
-
-h, --help -
Print help and exit.
-
--version -
Print version and exit.
-
--bl_art=artist_name -
Use to black list artist_name. simadb_cli is checking artist_name is actually in MPD music library (cf
-Sand-Poptions to set MPD host/address if necessary).If artist_name is not found the script print out a list of matching artists.
-
--bl_curr_trk | --bl_curr_art | --bl_curr_alb -
Use to black list the currently playing track|artist|album. You need access to your MPD server, use
-Sand-Pto set MPD host/address if necessary.
-
-d db_file, --dbfile=db_file -
Use the specific file db_file as database.
Default is too useXDG_DATA_HOME(see the section called “FILES”).
-
--purge_hist -
Purge history, you may supply an alternative DB file with --dbfile option.
-
--remove_bl=row_id -
Use to remove a black list entry. To get the row_id to suppress use
--view_bloption.
-
--view_bl -
Get all entries in the black list.
-
-P mpd_port, --port=mpd_port -
Use the specific port number mpd_port on MPD server. This overrides
MPD_PORTenvironment variable.
Default is 6600.
-
-S mpd_host, --host=mpd_host -
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 overridesMPD_HOSTenvironment variable.
Default is localhost.
Files
${XDG_DATA_HOME}/mpd_sima/sima.db
SQLite DB file. Usually XDG_DATA_HOME is set to ${HOME}/.local/share.
Feedback/bugs
The maintainer would be more than happy to ear from you, don't hesitate to send feedback, https://kaliko.me/contact/.
XMPP users are welcome to join the dedicated chat room at [email protected].
Releases
5 releases since Debian 7 (Wheezy); the text changed 4 times.
--add_similarity until Debian 8 (Jessie);
--check_names until Debian 8 (Jessie);
--reciprocal until Debian 8 (Jessie);
--remove_artist until Debian 8 (Jessie);
--view_all until Debian 8 (Jessie);
-a until Debian 8 (Jessie);
-c until Debian 8 (Jessie);
-r until Debian 8 (Jessie).