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 writes details of a few internet radio sta-
tions to ~/.wrarc. The user is free to modify these as desired.
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
~/.wrarc
Default location of configuration file
ENVIRONMENT VARIABLES
None.
EXAMPLES
The following will start your default station now:
wra on now
(The default station is that that is listed first in the configuration
file.)
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
(Note that if only one station is defined temporarily, then it is not
necessary to select that station in the command line arguments.)
CAVEATS
None.
STANDARDS
This manual page documents version 4.1.3 of wra.
SEE ALSO
audacious(1), crontab(5), 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.
23 Jan 2025 WRA(1)
