.\" $HeadURL$ $LastChangedRevision$
.\"
.pso ade-config --format=man
.so \*[ade_include_prefix]/ade.man
.pso wra-config --format=man
.TH WRA 1 "ADE_APP_TOKEN_RELEASE_DATE_MAN"
.SH NAME
wra \- web radio alarm
.br
.ne 5
.SH SYNOPSIS
.B wra
\*[ade_standard_synopsis_component] 
[
.B \-\-define=\fR"\fIstn url ply\fR"
]
[
.B \-\-list\-stations
|
.B \-s
]
{
.B on
.I time
|
.B off
.I time
|
.I station
} ...
.br
.ne 5
.SH DESCRIPTION
.B 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. 
.PP
URLs for radio stations' streams are specified in 
.B wra\fR's
configuration file.
.PP
.B Wra
controls a media player (e.g.
.B realplayer\fR(1),
.B mplayer\fR(1),
.B totem\fR(1),
.B xmms\fR(1)),
.B rhythmbox\fR(1)),
according to rules written in 
.B wra\fR's
configuration file.
.PP
On and off times are specified in the format
.I HHMM
or 
.B now\fR.
If a specified on time is not 
.B now\fR, 
then audio will be faded in.
.br
.ne 5
.SH CONFIGURATION
When 
.B wra
is first run it writes details of a few internet radio stations and a few 
media players to 
.B ~/.wrarc\fR. 
The user is free to modify these as desired.
.br
.ne 5
.SH OPTIONS
\*[ade_standard_options_component]
.TP
.B \-\-define=\fR"\fIstn url ply\fR"
equivalent to a temporary modification of the config file
.B ~/.wrarc
to define a new station
.I stn\fR,
using URL
.I url\fR,
to be played with player
.I ply
(which must be already defined in the config file
.B ~/.wrarc\fR).
.TP
.B \-\-list\-stations\fR, \fB\-s
List defined stations.
.br
.ne 5
.SH EXIT STATUS
On success
.B wra
returns zero. On failure it returns non-zero and displays a diagnostic
message.
.br
.ne 5
.SH FILES
None.
.br
.ne 5
.SH ENVIRONMENT VARIABLES
None.
.br
.ne 5
.SH EXAMPLES
The following will start your default station now:
.IP
.nf
.fam C
.B wra on now
.fam T
.fi
.PP
(The default station is selected by setting 
.B DFLT_STATION
in the configuration file, as explained in the comments you will find there.)
.PP
The following command plays radio 4 in the evening for a while
and then wakes you up with it:
.IP
.nf
.fam C
.B wra r4 on now off 2305 on 0655 off 0810
.fam T
.fi
.PP
The following command plays the alarm tune stored in /tmp/xxx.mp3 at 7 a.m.:
.IP
.nf
.fam C
.B  wra --define="x file:///tmp/xxx.mp3 totem" on 0700
.fam T
.fi
.PP
(Note that if only one station is defined temporarily, then it is not necessary
to select that station in the command line arguments.)
.ne 5
.SH CAVEATS
URLs specified with the
.B \-\-define
option may not contain spaces; this restriction is considered a bug (see 
http://dione.no-ip.org/wordpress/computing/wra/).
.PP
If running
.B wra
from your 
.B crontab\fR(5),
consider putting this code (with the UID and DISPLAY values adjusted to suit the
local user) above the first call to it:
.IP
.nf
.fam C
.B PULSE_RUNTIME_PATH=/run/user/1005/pulse 
.B DISPLAY=:0.0
.fam T
.fi
.br
.ne 5
.SH STANDARDS
This manual page documents version ADE_APP_TOKEN_RELEASE_ID of
.B wra\fR.
.br
.ne 5
.SH SEE ALSO
mplayer(1), realplayer(1), rhythmbox(1), totem(1), xmms(1)
.br
.ne 5
.SH AUTHOR
ADE_APP_TOKEN_AUTHOR_NAME <ADE_APP_TOKEN_AUTHOR_EMAIL>
.br
.ne 5
.SH COPYRIGHT & DISTRIBUTION POLICY
Copyright (C) 2003-ADE_APP_TOKEN_RELEASE_YEAR ADE_APP_TOKEN_AUTHOR_NAME
\*[ade_standard_copyright_component]