.\" $HeadURL$ $LastChangedRevision$
.\" vim: filetype=nroff
.\"
.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 \-\-list\-stations
|
.B \-l
]
[
.B \-\-config\-file=\fIfile\fB
|
.B \-f \fIfile\fB
]
{
.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 mplayer\fR(1),
.B vlc\fR(1)),
.B audacious\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 to
.B ~/.wrarc\fR. 
The user is free to modify these as desired.
.br
.ne 5
.SH OPTIONS
\*[ade_standard_options_component]
.TP
.B \-\-list\-stations\fR, \fB\-l
List defined stations.
.TP
.B \-\-config\-file=\fIfile\fR, \fB\-f \fIfile\fB
Load an alternative configuration file.
.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
.TP
.B ~/.wrarc
Default location of configuration file
.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 that that is listed first in the configuration file.)
.PP
The following command plays BBC Radio 4 in the evening for a while
and then wakes you up with SomaFM's Drone Zone:
.IP
.nf
.fam C
.B wra r4 on now off 2305 drone on 0655 off 0810
.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
None.
.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
audacious(1), crontab(5), mplayer(1), mpv(1), vlc(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]