about summary refs log tree commit diff
NAME
    radio - conveniently play internet radio streams, with simplicity in mind

DESCRIPTION
    The 'radio' bash script provides convenience features for radio streams.
    Usage happens through the command line and various menus like dmenu or zenity.
    Command Line arguments only yield results when mpv runs with an ipc-server,
    which makes the script output-friendly for other external scripts without requiring
    a lot of string manipulation.
    This script is aware of it's dependencies, whether they are files or executables.

PARAMETERS
    set     volume <Integer>           Set the stream volume (absolute)

    get     station                    Outputs current station name
                                       This information is provided by the stream.
            title [short]              Outputs current stream title
                                       Shows station name if title is empty.
            timepos                    Outputs the current time position (absolute)
                                       Displayed in this format: hh:mm:ss
            timeleft                   Outputs the remaining stream time
            volume                     Outputs the current volume level

    toggle  pause                      Pauses or resumes the stream
            mute                       Mutes the current stream
    stop                               Stops the stream
    seek    [-]ss                      Seeks the stream in seconds
            [-][h]h:mm:ss              Seeks the stream with given format
            [-][m]m:ss
                                       Examples:
                                         radio seek -90
                                         radio seek -04:21:30
                                         radio seek 4:21:30
                                         radio seek 9:19

    status                             Outputs information whether a
                                       stream is running or not.
                                       Returns a corresponding exit status.

    -h, --help                         Shows this help
    --version                          Displays the version

CONFIGURATION
    The configuration (config.json) is read
    from one of these locations (descending priority):
	...

    config  ls                         Prints all options from the
                                       configuration with their current values.
            set <option> <value>       Change the value of an option.
            station ls|add|rm          List, add or remove radio stations

ENVIRONMENT
    Valid values for environment variables are 1 and 0.
    Following environment variables are read by the script:

    DEBUG                              Show debug messages
    LOAD_OPTIONS                       Read options from configuration file
                                       If 'false', default values are used.
                                       (Default: on)