WRA(1) General Commands Manual WRA(1)
NAME
wra - web radio alarm
SYNOPSIS
wra [ -V | --version ] [ -v | --verbose | -d level | --debug=level ] [
-h | --help ] [ -p | --paths ] [ -n | --simulate ] [ --list-stations |
-l ] [ --config-file=file | -f file ] { on time | off time | station }
...
DESCRIPTION
Wra is a web radio alarm. It can be used to turn one of a number of web
radio stations on or off at specified times.
URLs for radio stations' streams are specified in wra's configuration
file.
Wra controls a media player (e.g. mplayer(1), vlc(1)), audacious(1)),
according to rules written in wra's configuration file.
On and off times are specified in the format HHMM or now. If a speci-
fied on time is not now, then audio will be faded in.
CONFIGURATION
When wra is first run it creates a symlink ~/.config/wra/wrarc pointing
to an uneditable list of radio stations. The user is free to replace
the symlink with the file that it points to and then edit it.
OPTIONS
-d level, --debug=level Determines how verbose this program will be.
The message types displayed for the different
values of level are as follows: 0 displays no
messages; 1 displays only errors, 2 displays
errors and warnings; 3 displays errors, warn-
ings and informational messages; higher values
display errors, warnings, informational mes-
sages and various messages intended for debug-
ging. The default is 2.
-h, --help Displays a brief usage message.
-p, --paths Lists the compiled-in paths of various files
and directories that this program uses. -n,
--simulate Some external commands that this
program runs may be displayed rather than ac-
tually executed. BEWARE: different programs
implement different levels of simulation; so
this option may work perfectly; on the other
hand it may do nothing at all!
-v, --verbose Equivalent to -d 3.
-V, --version Prints the program's version number and exits.
--list-stations, -l List defined stations.
--config-file=file, -f file
Load an alternative configuration file.
EXIT STATUS
On success wra returns zero. On failure it returns non-zero and dis-
plays a diagnostic message.
FILES
~/.config/wra/wrarc
Default location of configuration file
ENVIRONMENT VARIABLES
WRA_DEFAULT_STATION
Specifies the radio station to play when no station has been
specified on the command line.
EXAMPLES
The following will start your default station now:
wra on now
The following command plays BBC Radio 4 in the evening for a while and
then wakes you up with SomaFM's Drone Zone:
wra r4 on now off 2305 drone on 0655 off 0810
CAVEATS
None.
STANDARDS
This manual page documents version 4.99.0.1 of wra.
SEE ALSO
audacious(1), crontab(5), ffplay(1), mplayer(1), mpv(1), vlc(1)
AUTHOR
Alexis Huxley <alexishuxley@gmail.com>
COPYRIGHT & DISTRIBUTION POLICY
Copyright (C) 2003-2025 Alexis Huxley
This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your
option) any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of MER-
CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
Public License for more details.
You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
675 Mass Ave, Cambridge, MA 02139, USA.
7 May 2025 WRA(1)
