puf(1)

📦 version 1.0.0, in debian bookworm, ubuntu jammy, ubuntu noble

💖 puf(1) — the manual, but make it make sense

okay bestie, welcome to puf, a page from the General Commands Manual section, section 1. yes, section 1 means "run this in your shell, it's a command." sit down, grab a strawberry 🍓, we're gonna read this together and it's gonna be so good.

✨ NAME ✨

puf — an http client for parallel downloading. that's it. that's the whole vibe. 🦋

🌈 SYNTAX 🌈

puf [options] url [url ...]

look at her. options first, then a url, then as many more urls as your little heart desires. go off. 💅

🎀 DESCRIPTION 🎀

so puf is a program, and she is similar to GNU wget. same energy, same family. but here's the plot twist, the main character moment: puf tries to download as many urls as possible in parallel. not one at a time like some people. all of them. at once. iconic behavior honestly. 👑

lowkey important though: the available options vary between different versions. so like, don't come for me if your build has different flags than your friend's build, that's just how it is. if you wanna know what YOUR copy supports, simply run:

puf -h

and it'll hand you the list of available options. fr fr, that's the move. 🫶

🌸 SEE ALSO 🌸

go read those too, they're cute. ✨

💀 BUGS 💀

okay this is the part where we hold hands and stay calm.

  • entries in your /etc/hosts file will confuse the alias detection for the listed hosts. 😭 not a vibe.
    • workaround: do not use aliases. only use the primary name on the command line. periodt.
  • when you're continuing a download, ALL already complete files are scanned for links, because we have no reliable means of detecting the file type. all of them. every single one. not a drill. 🙈
please report bugs to Oswald Buddenhagen <puf@ossi.cjb.net> — he's the one who made this whole thing, be nice, be specific. 💜

💖 cute sign-off 💖

this little page is from 11 Oct 2000 (yes, a vintage queen 👑), and it lives in the puf(1) slot of the General Commands Manual. now go parallel-download something and slay. bye bestie!! 🎀🦋💅

📦 where this page comes from