XKCDPUNK(1)

📦
version 3.2 · 2 versions
, in nixos 26.05, nixpkgs unstable, ubuntu stonking

💖 XKCDPUNK(1) — General Commands Manual 💖

okay bestie, sit down, because this one is adorable and also genuinely useful. it's called xkcdpunk, it lives in section 1 of the manual (that's the "general commands" girlies, iykyk), and it does exactly one thing and it does it iconically: it puts xkcd comics in your terminal. no browser, no tab hell, no "wait let me open a new window." just vibes and stick figures. 🎀

✨ NAME ✨

xkcdpunk — display XKCD comics directly in your terminal 🦋

🌸 SYNOPSIS 🌸

xkcdpunk [-offline] [INPUT ...]
xkcdpunk -h | --help

💅 DESCRIPTION 💅

so here's the tea ☕: xkcdpunk will display a given xkcd comic and its alt-text directly in your terminal. yes, the alt-text too, the little hidden joke, the main character of every xkcd, we are NOT skipping it. 🫶

if you give it no argument at all, it just shows you the latest known comic. lowkey the easiest way to start your day. and if you pass random as the argument, it'll give you a random comic instead — chaos, but make it ✨educational✨.

🎀 Positional arguments 🎀

  • INPUT — the XKCD number, bestie. besides just a plain number, you can also pass "latest" or "random" as accepted values. and if you just… don't pass anything? "latest" is assumed. it's giving "we got you." 💖

🧚 Keyword arguments 🧚

  • --offline — only access already cached comics and do not download anything. no cap, no network, no new downloads. heads up though: "latest" will fail if no comic has ever been cached, and "random" might fail if there aren't enough cached comics. so like… make sure you've got a stash first. 😭

🚦 EXIT STATUS 🚦

the xkcdpunk utility exits 0 on success, and >0 if an error occurs. so 0 = slay, anything else = something went sideways, periodt. 💀

👀 SEE ALSO 👀

ansicat(1), netcache(1), offpunk(1), openk(1), and the whole vibe at https://offpunk.net/ 🌈

👑 AUTHORS 👑

Lionel Dricot (Ploum) <offpunk2 at ploum.eu> — an absolute icon, fr fr. 🫡

and that's the page, babes. this Debian-flavored edition is dated February 9, 2026, and it's straight from the XKCDPUNK(1) corner of the general commands manual. go read a comic, you deserve it. 💜

📦 where this page comes from