NAME

mpd_info_screen2 - Views graphical info on MPD, the successor to mpd_info_screen, in C++

SYNOPSIS

simplearchiver [-h | --help] [ options ]

DESCRIPTION

mpd_info_screen2 shows info on MPD about the currently playing song. By default, the remaining time, remaining percentage, title, artist, album, and filename are displayed along with the album art.

OPTIONS

-h, --help

Prints the "help text" which lists all options.

--host=<ip_addr>

The ip-address of the MPD server to connect to.

--port=<port>

The port of the MPD server to connect to. Defaults to 6600.

--disable-all-text

Disables showing all text. Only the album art is shown in this case.

--disable-show-title

Disables showing the title text.

--disable-show-artist

Disables showing the artist text.

--disable-show-album

Disables showing the album text.

--disable-show-filename

Disables showing the filename text.

--disable-show-remaining

Disables showing the track's remaining time.

--disable-show-percentage

Disables showing the track's elapsed time percentage.

--align-text-right

Aligns the displayed text to the right (instead of to the left).

--pprompt

If MPD requires a password to authenticate with, mpd_info_screen2 will prompt for a password if this option is specified. It is expected for the user to enter the password to authenticate with MPD, and to press Enter after the password has been input. Invalid passwords should result in mpd_info_screen2 to prompt for a password again.

--pfile=<filename>

If MPD requires a password to authenticate with, mpd_info_screen2 will read the file specified by --pfile=<filename> to get the password and will use it to authenticate with MPD.

--no-scale-fill

When drawing the album art, mpd_info_screen2 will not scale the album art to the window if this is specified.

--align-album-art-left

When drawing the album art, align the image to the left. This option is mutually exclusive with --align-album-art-right. If neither options are specified, then the image is centered.

--align-album-art-right

When drawing the album art, align the image to the right. This option is mutually exclusive with --align-album-art-left. If neither options are specified, then the image is centered.

--log-level=<level>

Sets the verbosity/log-level of outputs from mpd_info_screen2. The possible options are: ERROR, WARNING, DEBUG, VERBOSE. Note that the log-level name check is case-insensitive.

--bg-opacity=<percentage>

Sets the opacity/transparency of the text backgrounds. Must be between 0.0 and 1.0. Note that if --text-bg-color is used, then this option is ignored.

--default-font-filename=<font_filename>

Sets the default font by filename for texts.

--force-default-font

Forces all text displayed to only be the default font.

--force-default-font-ascii

Forces all ascii text displayed to only use the default font.

--blacklist-font-str=<string>

When fetching known fonts to use for an info text line, don't use fonts whose filename contains one of the string(s) specified by --blacklist-font-str=<string>. Note that this option can be specified multiple times to add more strings to check against.

--whitelist-font-str=<string>

When fetching known fonts to use for an info text line, only use fonts whose filename contains one of the string(s) specified by --whitelist-font-str=<string>. Note that this option can be specified multiple times to add more strings to check against. Also note that the whitelisting is implemented as "a font that contains ANY whitelisted string is allowed". If this option is not used, then no whitelisting is used.

--remaining-force-default-raylib-font

Forces the remaining time text and the percentage text to use the default Raylib font.

--font-scale-factor=<factor>

Sets the scale factor for all font sizes. By default, this is set to "1.0", and this value must be greater than zero.

--remaining-font-scale-factor=<factor>

Sets the scale factor for the remaining font text. Note that the "remaining" font text is the remaining time and elepsed percentage. By default, this is set to "1.0", and this value must be greater than zero. Also note that this option holds precedence over --font-scale-factor=<factor> .

--h-toggles-text

Changes the behavior of the "H" key. When this option is not used, then the displayed text will be visible by default, and hidden while "H" is pressed. If this option is specified, then the "H" key becomes a toggle to show/hide the displayed text. Note that due to mpd_info_screen2 running at a low frame-rate to run efficiently, the "H" key toggle may not work if the "H" key is depressed too quickly.

--background-color=<value>

Sets the background-color such that a value of 0.0 is black, 1.0 is white, and anything in between is the appropriate level of gray. Note that the default value is close to 0.0, but not 0.0. Note that if this value is greater than 0.5, then the color of the --pprompt text and other similarly displayed text is black instead of white.

--text-fg-color=<RED>,<BLUE>,<GREEN>,<ALPHA>

Set the foreground color of displayed text (not including informational texts like when mpd is stopped or the --pprompt text). Values are expected to be between 0.0 and 1.0 .

--text-bg-color=<RED>,<BLUE>,<GREEN>,<ALPHA>

Set the background color of displayed text (not including informational texts like when mpd is stopped or the --pprompt text). Values are expected to be between 0.0 and 1.0 . Note that this has priority over --bg-opacity.

--scale-text-by-width

Scales displayed text (remaining time, title, artist, album name, filename) by the width of the window. Note that this is the default.

--scale-text-by-height

Scales displayed text (remaining time, title, artist, album name, filename) by the height of the window.

--scale-text-by-wh-min

Scales displayed text (remaining time, title, artist, album name, filename) by either the width or height of the window (whichever is smaller).

--scale-text-by-wh-max

Scales displayed text (remaining time, title, artist, album name, filename) by either the width or height of the window (whichever is greater).

--version

Prints the current version of mpd_info_screen2.

NOTES

Supported Font Filetypes

Note that ".ttc" files are not supported (by Raylib) and will not be used.

On Disconnection

By default, if MPD was successfully connected to, but the TCP connection is somehow dropped, then mpd_info_screen2 will attempt to reconnect on a 5-second interval. Note reconnection attempts by default will be tried up to 5 times, after which the program will stop if reconnection failed.