.\" $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 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)),
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. Comments are given in the 
configuration file to aid the user in this.
.br
.ne 5
.SH OPTIONS
\*[ade_standard_options_component]
.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 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
.br
.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
mplayer(1), realplayer(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]