1CASTGETRC(5)                     User Commands                    CASTGETRC(5)
2
3
4

NAME

6       castgetrc - configuration file for castget
7

DESCRIPTION

9       The  configuration  file  .castgetrc should be located in a user´s home
10       directory. It defines the behaviour of  the  RSS  enclosure  downloader
11       castget, and in particular the list of channels it operates on.
12
13       The  file is based on a simple key-value format. It consists of a chan‐
14       nel definition for each RSS feed castget should process. A channel def‐
15       inition  starts with a line containing a channel identifier enclosed in
16       brackets. The channel identifier can be freely chosen by the  user  and
17       is  used  for  all subsequent operations on the channel. Following this
18       are one or more key-value pairs on the form key=value that define cast‐
19       get´s  behaviour  when  operating  on the channel. A channel definition
20       ends when another channel definition is started or at the  end  of  the
21       file.
22
23       Lines beginning with a hash character (`#´) and blank lines are consid‐
24       ered comments.  All  identifiers,  keys  and  values  should  be  UTF-8
25       encoded.
26
27       Key-value pairs in a channel definition define the behaviour of castget
28       when processing the channel. The channel definition
29
30
31
32           [fooc]
33           url=http://downloads.bbc.co.uk/podcasts/radio4/fooc/rss.xml
34           spool=/home/joe/podcasts
35
36
37
38       for example, instructs castget to use /home/joe/podcasts as a  download
39       directory when processing the channel fooc.
40

KEYS

42       url    retrieve  RSS feed from this URL. The field is mandatory for all
43              channel definitions.
44
45       spool  download enclosures to this directory.
46
47       playlist
48              write the fully qualified file names of  all  downloaded  enclo‐
49              sures to an m3u style playlist file with this name.
50
51       filter restrict operation to items whose enclosures have names matching
52              this regular expression.
53
54       id3leadartist
55              add or overwrite the `lead artist´ (TPE1) ID3v2  tag  in  enclo‐
56              sures that support this.
57
58       id3contentgroup
59              add  or overwrite the `content group´ (TIT1) ID3v2 tag in enclo‐
60              sures that support this.
61
62       id3title
63              add or overwrite the `title´ (TIT2) ID3v2 tag in enclosures that
64              support this.
65
66       id3album
67              add or overwrite the `album´ (TALB) ID3v2 tag in enclosures that
68              support this.
69
70       id3contenttype
71              add or overwrite the `content type´ (TCON) ID3v2 tag  in  enclo‐
72              sures that support this.
73
74       id3year
75              add  or overwrite the `year´ (TYER) ID3v2 tag in enclosures that
76              support this.
77
78       id3comment
79              add or overwrite the `comment´ (COMM) ID3v2  tag  in  enclosures
80              that support this.
81

GLOBAL CONFIGURATION

83       A channel definition with the channel identifier * will define a global
84       configuration affecting all channels. The global configuration
85
86
87
88           [*]
89           id3contenttype=Podcast
90
91
92
93       for example, is equivalent to adding  the  key-value  pair  id3content‐
94       type=Podcast to all other channel definitions.
95
96       Key-value  pairs  in channel definitions override the global configura‐
97       tion.
98

CHANNEL REMOVAL

100       If a channel configuration is removed, the channel status  remains  the
101       same  so  that  if the channel is subsequently re-added, any enclosures
102       marked as already downloaded will not be downloaded again.
103

NOTE

105       The source distribution includes a  sample  configuration  file  demon‐
106       strating all supported settings.
107

SEE ALSO

109       castget(1)
110

AUTHOR

112       Marius L. Jøhndal.
113
114
115
116castget 1.2.4                      May 2017                       CASTGETRC(5)
Impressum