DragonFly On-Line Manual Pages

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
       channel definition for each RSS feed castget should process. A channel
       definition 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
       castget'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
       considered 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
              enclosures 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
              enclosures that support this.

       id3contentgroup
              add or overwrite the `content group' (TIT1) ID3v2 tag in
              enclosures 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
              enclosures 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
       id3contenttype=Podcast to all other channel definitions.

       Key-value pairs in channel definitions override the global
       configuration.

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
       demonstrating all supported settings.

SEE ALSO
       castget(1)

AUTHOR
       Marius L. Johndal.

castget 1.2.2                      June 2013                     CASTGETRC(16)