1CASTGET(1)                       User Commands                      CASTGET(1)
2
3
4

NAME

6       castget - download RSS enclosures
7

SYNOPSIS

9       castget [OPTION...] [CHANNEL IDENTIFIER...]
10

DESCRIPTION

12       castget downloads RSS enclosures, for example podcasts, from RSS feeds.
13
14       RSS  feeds  are  assigned channel identifiers in the configuration file
15       .castgetrc. Channels to be processed by castget are indicated  by  sup‐
16       plying  the channel identifiers as arguments. If no channel identifiers
17       are provided, all available channels are processed.
18
19       If run without any options, castget will perform the default action  on
20       all  channels  to  be  processed. The default action is to download any
21       enclosure not already downloaded. Other actions  may  be  performed  by
22       supplying one or more options as arguments.
23

OPTIONS

25   Operations
26       -c, --catchup
27              catch up with channels and exit
28
29       -l, --list
30              list available enclosures that have not yet been downloaded, and
31              exit
32
33       -h, --help
34              display help and exit
35
36       -V, --version
37              output version information and exit
38
39   Operation filters
40       -n, --new-only
41              restrict operation to new channels only, i.e. to  channels  that
42              have  never  been downloaded from or been caught up with before.
43              Note that if a channel is added to the configuration and  subse‐
44              quently  removed,  its download history is preserved. This means
45              that a channel that has been removed from the configuration file
46              will not be considered as ´new´ if it is added to the configura‐
47              tion again at a later time.
48
49       -1, --first-only
50              restrict operation to the most recent item in each channel only.
51
52       -f pattern, --filter=pattern
53              restrict operation to items whose enclosures have names matching
54              the regular expression pattern. Note that this will override any
55              regular expression filters given in the configuration file.
56
57   Global options
58       -r, --resume
59              resume aborted downloads
60
61       -q, --quiet
62              do not print anything except error messages
63
64       -v, --verbose
65              print detailed progress information
66
67       -d, --debug
68              print (lots of) connection debug information
69
70       -p, --progress-bar
71              print a progress bar when downloading enclosures
72
73       -C filename, --rcfile=filename
74              override the default filename for the configuration file
75

EXAMPLES

77       Download all enclosures not already downloaded:
78
79              $ castget
80
81       Download all enclosures not already downloaded from channel foobar  and
82       be verbose:
83
84              $ castget -v foobar
85
86       List all enclosures not already downloaded:
87
88              $ castget -l
89
90       Catch up with channel foobar:
91
92              $ castget -c foobar
93
94       List the first available enclosure in all new channels:
95
96              $ castget -1 -n -l
97
98       Catch  up with items that match the regular expression Freddies0[67] in
99       the channel frederator:
100
101              $ castget -c -f "Freddies0[67]" frederator
102

HTTP PROXY

104       To use a HTTP proxy, set the environment variable http_proxy:
105
106              http_proxy=http://your.proxy.server:port/ castget
107

SEE ALSO

109       castgetrc(5)
110

BUGS

112       Please see  the  castget  home  page  http://mlj.github.io/castget  for
113       instructions on how to submit bug reports.
114

AUTHORS

116       Marius L. Jøhndal, Jick Nan.
117

119       Castget is Copyright (C) 2005-2013 Marius L. Jøhndal.
120
121       Castget is Copyright (C) 2007 Jick Nan.
122
123       This  is free software; see the source for copying conditions. There is
124       NO warranty; not even for MERCHANTABILITY or FITNESS FOR  A  PARTICULAR
125       PURPOSE.
126
127
128
129castget 1.2.4                      May 2017                         CASTGET(1)
Impressum