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 enclosures whose download URLs  match  the
54              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. Make sure not to use  this  option  if
60              the  RSS  feed uses the same filename for multiple enclosures as
61              this will corrupt existing downloads.
62
63       -q, --quiet
64              Do not print anything except error messages.
65
66       -v, --verbose
67              Print detailed progress information.
68
69       -d, --debug
70              Print (lots of) connection debug information.
71
72       -p, --progress-bar
73              Print a progress bar when downloading enclosures.
74
75       -C filename, --rcfile=filename
76              Override the default filename for the configuration file.
77

EXAMPLES

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

HTTP PROXY

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

SEE ALSO

111       castgetrc(5)
112

BUGS

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

AUTHORS

118       Marius L. Jøhndal, Jick Nan.
119

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