paraslash Paraslash Audio Streaming
About   News   Download   Documentation   Development



para_gui - show para_audiod status in a curses window


para_gui [--help] [--detailed-help] [--version] [--config-file=<filename>] [--loglevel=<severity>] [--theme=<name>] [--stat-cmd=<command>] [--key-map=<k:m:c>]


para_gui is a curses program which displays status information about para_server and para_audiod in a terminal. Keys may be mapped to user-defined commands which are executed when the key is pressed. Command output is shown in a simple pager.


Common options
The following options are implemented generically and are available for many of the commands.
, --help

print help and exit


print help, including all details, and exit

-V, --version

print version and exit

-c, --config-file=<filename>

path to alternative config file

default: ~/.paraslash/gui.conf

para_gui reads its config file right after parsing the options that were given at the command line. If an option is given both at the command line and in the config file, the value that was specified at the command line takes precedence.

-l, --loglevel=<severity>

control amount of logging

values: debug, info, notice, warning, error, crit, emerg

Log only messages with severity greater or equal than the given value. Possible values:

debug: Produces really noisy output. info: Still noisy, but won’t fill up the disk quickly. notice: Indicates normal, but significant event. warning: Unexpected events that can be handled. error: Unhandled error condition. crit: System might be unreliable. emerg: Last message before exit.

Options for para_gui
, --theme=<name>

select startup theme

If this option is not given the default theme is used. If the given name is not a valid theme name, the list of available themes is printed and the program terminates.

-s, --stat-cmd=<command>

command to read status items from

default: para_audioc -- stat -p

On a host on which the para_audiod service is not is running, the default command will fail. An alternative is

para_client -- stat -p

This command connects para_server instead of para_audiod. However, no timing information about the current audio file is printed.

-k, --key-map=<k:m:c>

map a key to a command using one of three possible modes

Mode may be d, x or p for display, external and paraslash commands, respectively. Of course, this option may be given multiple times, one for each key mapping. See the manual for more information.


Written by Andre Noll
Copyright (C) 2024 Andre Noll
License: GNU GPL version 2
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
Report bugs to Andre Noll