.\" $HeadURL$ $LastChangedRevision$
.pso ade-config --format=man
.so \*[ade_include_prefix]/ade.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 \-w
|
.B \-i
|
.B \-b
] [
.B \-F
]
{ 
.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. It uses
.B xmms-shell\fR(1)
to talk to
.B xmms\fR(1).
.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 add details of additional stations manually.
.PP
In this file blank and hash-led lines are ignored. Remaining lines of the format:
.IP
.I station station\-name url player 
.PP
where
.I station
is the single short word used on the command line to select the station,
.I station\-name
is a longer description of the station, which must be quoted if it contains spaces,
.I url
is the URL to be passed to the player and
.I player
is either 
.B realplay
or 
.B xmms\fR. 
The first entry in the file identifies the station to be selected if none is specified on the command line.
For example:
.IP
.B b2 \(dqBayern 2\(dq http://gffstream.ic.llnwd.net/stream/gffstream_w2b xmms
.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
xmms(1), xmms-shell(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]