.TH CASTGET "1" "July 2006" "@PACKAGE_STRING@" "User Commands"
.SH NAME
castget \- download RSS enclosures
.SH SYNOPSIS
.B castget 
[\fIOPTION\fR]... [\fICHANNEL IDENTIFIER\fR]...
.SH DESCRIPTION
.PP
The program downloads RSS enclosures, for example podcasts, from RSS feeds.
.TP
RSS feeds are assigned channel identifiers in the configuration file \fB.castgetrc\fR. Channels to be processed by \fBcastget\fR are indicated by supplying the channel identifiers as arguments. If no channel identifiers are provided, all available channels are processed. 
.TP
If run without any options, \fBcastget\fR will perform the default action on all channels to be processed. The default action is to download any enclosure not already downloaded. Other actions may be performed by supplying one or more options as arguments.
.SH OPTIONS
.TP
\fB\-c\fR, \fB\-\-catchup\fR
catch up with channels and exit
.TP
\fB\-l\fR, \fB\-\-list\fR
list available enclosures that have not yet been downloaded, and exit
.TP
\fB\-n\fR, \fB\-\-new-only\fR
operate on new channels only, i.e. on channels that have never been downloaded from or been caught up with before. Note that if a channel is added to the configuration and subsequently removed, its download history is preserved so that the channel will not be considered as `new' if re-added to the configuration at a later time.
.TP
\fB\-1\fR, \fB\-\-first-only\fR
operate on the most recent enclosure in each channel only.
.TP
\fB\-r\fR, \fB\-\-resume\fR
resume aborted downloads
.TP
\fB\-q\fR, \fB\-\-quiet\fR
do not print anything except error messages
.TP
\fB\-v\fR, \fB\-\-verbose\fR
print detailed progress information
.TP
\fB\-h\fR, \fB\-\-help\fR
display help and exit
.TP
\fB\-V\fR, \fB\-\-version\fR
output version information and exit
.SH EXAMPLES
.TP
\fBcastget\fR
download all enclosures not already downloaded
.TP
\fBcastget -v foobar\fR
download all enclosures not already downloaded from channel \fBfoobar\fR and be verbose
.TP
\fBcastget -l\fR
list all enclosures not already downloaded
.TP
\fBcastget -c foobar\fR
catch up with channel \fBfoobar\fR
.SH SEE ALSO
\fBcastgetrc\fR(5)
.SH AUTHOR
Marius L. Jøhndal.
.SH COPYRIGHT
Copyright \(co 2005 Marius L. Jøhndal.
.br
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.