CASTGETRC(16) User Commands CASTGETRC(16)NAME
castgetrc - configuration file for castget
DESCRIPTION
The configuration file .castgetrc should be located in a user's home
directory. It defines the behaviour of the RSS enclosure downloader
castget, and in particular the list of channels it operates on.
The file is based on a simple key-value format. It consists of a chan‐
nel definition for each RSS feed castget should process. A channel def‐
inition starts with a line containing a channel identifier enclosed in
brackets. The channel identifier can be freely chosen by the user and
is used for all subsequent operations on the channel. Following this
are one or more key-value pairs on the form key=value that define cast‐
get's behaviour when operating on the channel. A channel definition
ends when another channel definition is started or at the end of the
file.
Lines beginning with a hash character (`#') and blank lines are consid‐
ered comments. All identifiers, keys and values should be UTF-8
encoded.
Key-value pairs in a channel definition define the behaviour of castget
when processing the channel. The channel definition
[df]
url=http://downloads.bbc.co.uk/podcasts/radio4/fooc/rss.xml
spool=/home/joe/podcasts
for example, instructs castget to use /home/joe/podcasts as a download
directory when processing the channel df.
KEYS
url retrieve RSS feed from this URL. The field is mandatory for all
channel definitions.
spool download enclosures to this directory.
playlist
write the fully qualified file names of all downloaded enclo‐
sures to an m3u style playlist file with this name.
filter restrict operation to items whose enclosures have names matching
this regular expression.
id3leadartist
add or overwrite the `lead artist' (TPE1) ID3v2 tag in enclo‐
sures that support this.
id3contentgroup
add or overwrite the `content group' (TIT1) ID3v2 tag in enclo‐
sures that support this.
id3title
add or overwrite the `title' (TIT2) ID3v2 tag in enclosures that
support this.
id3album
add or overwrite the `album' (TALB) ID3v2 tag in enclosures that
support this.
id3contenttype
add or overwrite the `content type' (TCON) ID3v2 tag in enclo‐
sures that support this.
id3year
add or overwrite the `year' (TYER) ID3v2 tag in enclosures that
support this.
id3comment
add or overwrite the `comment' (COMM) ID3v2 tag in enclosures
that support this.
GLOBAL CONFIGURATION
A channel definition with the channel identifier `*' will define a
global configuration affecting all channels. The global configuration
[*]
id3contenttype=Podcast
for example, is equivalent to adding the key-value pair id3content‐
type=Podcast to all other channel definitions.
Key-value pairs in channel definitions override the global configura‐
tion.
CHANNEL REMOVAL
If a channel configuration is removed, the channel status remains the
same so that if the channel is subsequently re-added, any enclosures
marked as already downloaded will not be downloaded again.
NOTE
The source distribution includes a sample configuration file demon‐
strating all supported settings.
SEE ALSOcastget(1)AUTHOR
Marius L. Jøhndal.
castget 1.2.2 June 2013 CASTGETRC(16)