CASTGET(1)

💖 CASTGET 💖

okay bestie, welcome to the manual page for castget, a User Commands situation, and it's literally here to help you download RSS enclosures. yes. podcasts. we're doing this. 🎧✨

---

✨ NAME ✨

castget — download RSS enclosures 🫶

---

🌸 SYNOPSIS 🌸

castget [OPTION...] [CHANNEL IDENTIFIER...]

---

💅 DESCRIPTION 💅

So like, castget downloads RSS enclosures — think podcasts, the whole vibe — straight from RSS feeds. it's giving download manager but make it cute. 🦋

Your RSS feeds get assigned channel identifiers over in the config file .castgetrc. if you want castget to actually do something with a channel, you just hand it the channel identifier as an argument. and if you don't give it any channel identifiers at all? it processes every available channel. no thoughts, just all of them. 💀

Run it with zero options and it does the default action on all the channels it's processing. and the default action is... downloading any enclosure that isn't already downloaded. iconic behavior honestly. ✨

But wait, there's more — you can make it do other actions by passing one or more options as arguments. main character energy. 👑

---

🌈 OPTIONS 🌈

🎀 Operations

• -c, --catchup — catch up with channels and then dip. exit. gone. 💨
• -l, --list — list the available enclosures that haven't been downloaded yet, then exit. window shopping, basically. 🛍️
• -h, --help — show the help and exit. everybody needs a little help sometimes, no shame. 🙈
• -V, --version — print out version info and exit. 🏷️

---

🧚 Operation filters

• -n, --new-only — restrict the operation to new channels only, aka channels that have never been downloaded from or caught up with before. fresh out the box, never touched. ✨

okay so heads up bestie: if a channel gets added to the config and then removed later, its download history is preserved. which means if you take it out of the config file and then add it back in at some later point, it will NOT count as "new". the receipts stay. 📝

• -1, --first-only — restrict the operation to just the most recent item in each channel. one item. singular. the latest one. that's it. 💅
• -f pattern, `--filter=pattern — restrict the operation to enclosures whose download URLs match the regular expression pattern. and fyi, this overrides any regular expression filters you set in the config file. this one wins. periodt. 👑

---

🫶 Global options

• -r, --resume — resume aborted downloads. 🦋

⚠️ but like, do NOT use this if your RSS feed uses the same filename for multiple enclosures, because that will corrupt existing downloads. i'm serious. don't do it. 💀

• -q, --quiet — don't print anything at all, except error messages. silent mode. 🤫
• -v, --verbose — print detailed progress info. tell me everything, i want the tea. ☕
• -d, --debug — print (lots of) connection debug information. and when they say lots, they mean LOTS. 😭
• -p, --progress-bar — print a progress bar while downloading enclosures. we love a visual. 📊✨
• -C filename, `--rcfile=filename — override the default filename for the configuration file. 🎀

---

💜 EXAMPLES 💜

Download all enclosures not already downloaded:

$ castget

Download all enclosures not already downloaded from channel foobar, and be verbose about it:

$ castget -v foobar

List all enclosures not already downloaded:

$ castget -l

Catch up with channel foobar:

$ castget -c foobar

List the first available enclosure in all new channels:

$ castget -1 -n -l

Catch up with items that match the regular expression Freddies0[67] in the channel frederator:

$ castget -c -f "Freddies0[67]" frederator

---

🌐 HTTP PROXY 🌐

Wanna use a HTTP proxy? just set the environment variable http_proxy, like so:

http_proxy=http://your.proxy.server:port/ castget

---

👀 SEE ALSO 👀

castgetrc(5)

---

💀 BUGS 💀

Found a bug? no worries bestie, head over to the castget home page at http://mlj.github.io/castget — there's instructions there on how to submit bug reports. 🫶

---

👑 AUTHORS 👑

Marius L. Jøhndal, Jick Nan. 🎀

---

⭐ COPYRIGHT ⭐

Castget is Copyright (C) 2005-2019 Marius L. Jøhndal.

Castget is Copyright (C) 2007 Jick Nan.

This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. 🔥

---

okay and that's the whole thing!! this was castget 2.0.1, from October 2019, and it lives in section 1 of the manual (the CASTGET(1) of it all 💅). go forth and download your podcasts, bestie, you've got this 🌸🦋✨