GPO(1)

📦
version 3.11.5 · 4 versions
, in alpine 3.24, arch rolling, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable

💖 GPO 💖

okay bestie, welcome to gpo — the text mode interface of gPodder 🌸 it's literally the glow-up your podcast workflow needed, no cap.

✨ SYNOPSIS ✨

gpo [--verbose|-v|--quiet|-q] [COMMAND] [params...]

🦋 DESCRIPTION 🦋

gpo is the text mode interface of gPodder, and she is serving. Run her with zero arguments and you land straight in the interactive shell (more on that below, keep reading 💅). Wanna know what she can even do? Just type gpo help and she'll hand you the whole list of supported commands like the icon she is.

The vibe here is: manage your podcasts from the command line, without ever having to start gPodder. Periodt. And because she's efficient like that, gpo can also automate tasks for you — things like downloading or updating feeds, so your lil cronjobs do the work while you sleep 😴✨

Oh and super important: the database and files are the same ones the GUI uses, gpodder(1). So nothing gets duplicated, nothing gets lost — they're literally sharing a closet 🫶

🎀 INTERACTIVE SHELL MODE 🎀

Run gpo with no COMMAND and boom, you're in interactive shell mode. From there you just type commands directly, like a chat but with your podcast library 💬

When readline is available, this shell supports completion using <Tab> — yes, tab completion, we love to see it 👑 Podcast feed URLs are also completed for commands that take the URL of a podcast as an argument. It's giving convenience.

Also! Some commands (e.g. search and toplist) will provide a query in interactive shell mode (to subscribe to podcasts). But heads up bestie — those queries will not be shown when started directly from the command line. 🙈

⭐ COMMAND PREFIXES ⭐

For all commands, you can use only the first few characters instead of the full command — as long as the command is unique. Shortcuts, we stan 🎀

If it's not unique, gpo will show you all matching commands and the shortest prefix of each, so you can figure out where to go next.

⚠️ okay real talk for a sec: future additions to the command set could change the shortest prefix of any given command. So using the full command in scripts is recommended (e.g. use gpo update and not gpo up in scripts and cronjobs). The short command prefixes are mostly useful for interactive usage — iykyk 💅

🌈 EXAMPLES 🌈

  • gpo — Enter interactive shell mode
  • gpo update && gpo download — Check for new episodes, then download all new episodes
  • gpo search linux outlaws — Search the directory for podcasts named "linux outlaws"
  • gpo youtube http://youtube.com/watch?v=oHg5SJYRHA0 — Print download URL of a YouTube video to stdout

💜 SEE ALSO 💜

gpodder(1) — the GUI sibling, go say hi 🫶

💀 BUGS 💀

Found a bug? Don't suffer in silence bestie, report it at https://github.com/gpodder/gpodder/issues — they wanna know, fr fr 🙏

and that's the whole page, babe 🎀 this one's from gpodder 3.11.5, dated December 2024 — go forth and podcast, you absolute main character 👑✨🦋

📦 where this page comes from