.\" $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 \-\-rc
]
[
.B \-\-define=\fR"\fIstn url ply\fR"
]
{
.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. Comments are given in the 
configuration file to aid the user in this. See also 
.B CAVEATS
below.
.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 \-\-rc
Write the example configuration file to standard output and immediately exit.
.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
.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" x on 0700
.fam T
.fi
.br
.ne 5
.SH CAVEATS
It is possible that this version of this program requires entries
in the config file
.B ~/.wrarc\fR
that earlier versions of this program did not require. This program
will not append such missing entries to the config file but it does create an example 
config file if one does not already exist. If you encounter error
messages that you suspect are related to missing entries in the config file, then
rename your old config file, run
.B wra
to generate a new config file and then merge any modifications you 
had made in the old config file (e.g. your preferred radio station and player
definitions) into the new config file.
.PP
URLs specified with the
.B \-\-define
option may not contain spaces; this restriction is considered a bug (see 
http://dione.no-ip.org/AlexisWiki/WRA).
.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]