GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  CASTGETRC (5)

NAME

castgetrc - configuration file for castget

CONTENTS

Description
Keys
Global Configuration
Channel Removal
Note
See Also
Author

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. J°hndal.
Search for    or go to Top of page |  Section 5 |  Main Index


castget 1.2.2 CASTGETRC (16) June 2013

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.