DOSAGE(1)

💖 DOSAGE(1) 💖 — User Commands

okay so bestie, this is the manual page for dosage, and it lives in section 1 of the manual (that's the User Commands zone, aka the "stuff you actually type" section). grab a strawberry drink, we're doing this 🍓

---

🌸 NAME 🌸

dosage — comic strip downloader and archiver. that's it. that's the whole name section. iconic brevity 💅

---

✨ DESCRIPTION ✨

here's the whole shape of the thing, exactly as it wants to be called:

usage: dosage [-h] [-v] [-n NUMSTRIPS] [-a] [-c] [-b PATH] [--baseurl PATH]
              [-l] [--singlelist] [--version] [--vote] [-m] [-t]
              [-o {html,json,rss}] [--no-downscale] [-p PARALLEL] [--adult]
              [--allow-multiple] [comic ...]

A comic downloader and archiver. no cap, that's literally the whole description line and honestly? it ate. 🔥

🎀 positional arguments: 🎀

• comic — comic module name (including case insensitive substrings). so you can be lazy with the capitalization and it still knows what you mean, we love a flexible king 👑

💅 options: 💅

• -h, --help — show this help message and exit. the classic. the "help me help you" flag.
• -v, --verbose — provides verbose output, use multiple times for more verbosity. stack it like a combo, each -v turns the volume up 🔊
• -n NUMSTRIPS, --numstrips NUMSTRIPS — traverse and retrieve the given number of comic strips; use --all to retrieve all comic strips.
• -a, --all — traverse and retrieve all comic strips. every single one. no crumbs left. 🍽️
• -c, --continue — traverse and retrieve comic strips until an existing one is found. it stops the second it hits something you already have, so it's like "oh you've been here before, say less" 🫶
• -b PATH, --basepath PATH — set the path to create invidivual comic directories in, default is Comics.
• --baseurl PATH — the base URL of your comics directory (for RSS, HTML, etc.); this should correspond to --base-path.
• -l, --list — list available comic modules. window shopping fr fr 🛍️
• --singlelist — list available comic modules in a single column list. one per line, tidy, clean girl aesthetic ✨
• --version — display the version number.
• --vote — vote for the selected comics.
• -m, --modulehelp — display help for comic modules.
• -t, --timestamps — print timestamps for all output at any info level.
• -o {html,json,rss}, --output {html,json,rss} — sets output handlers for downloaded comics. pick your format, bestie, those are the three options and there is no fourth 💀
• --no-downscale — prevent downscaling when using html or rss handler.
• -p PARALLEL, --parallel PARALLEL — fetch comics in parallel. Specify the number of connections. go fast, but like, respectfully 🏃‍♀️
• --adult — confirms that you are old enough to view adult content.
• --allow-multiple — allows multiple instances to run at the same time. Use if you know what you are doing.

⚠️ okay so about that last one: --allow-multiple is very much a "Use if you know what you are doing" situation. if you don't know what you're doing, don't do it. that's the whole vibe check. 🚨

---

🌈 EXAMPLES 🌈

List available comics:

dosage -l

Get the latest comic of for example CalvinAndHobbes and save it in the "Comics" directory:

dosage CalvinAndHobbes

If you already have downloaded several comics and want to get the latest strips of all of them:

dosage --continue @

look at that @ doing the absolute most. main character energy, periodt 👑

---

🦋 the receipts 🦋

User plugin directory: /home/tchet/.local/share/dosage/plugins — that's where your little plugin babies live 💜

Using Python 3.11.6 (CPython) on Linux-6.5.0-4-amd64-x86_64-with-glibc2.37

Copyright © 2004-2008 Tristan Seligmann and Jonathan Jacobs Copyright © 2012-2014 Bastian Kleineidam Copyright © 2015-2020 Tobias Gruetzmacher Copyright © 2019-2020 Daniel Ring

shoutout to the whole squad who built this, we love a group project that actually shipped 🫶✨

🚨 dosage comes with ABSOLUTELY NO WARRANTY! This is free software, and you are welcome to redistribute it under certain conditions. Look at the file COPYING within this distribution. For support see https://github.com/webcomics/dosage/issues

so yeah — free software, certain conditions, read COPYING, and if something breaks, the issues page is right there, bestie. no cap. 💖

---

👀 SEE ALSO 👀

The full documentation for dosage is maintained as a Texinfo manual. If the info and dosage programs are properly installed at your site, the command

info dosage

should give you access to the complete manual.

---

and that's the whole page, angel 💅 this was <bold-ish>dosage 3.0</bold-ish>, from <bold-ish>December 2023</bold-ish> — go download some comics, you've earned it 🌸🦋💖