.\" This was generated by help2man 1.49.3. and a bit cleaned up
.TH DOSAGE "1" "December 2023" "dosage 3.0" "User Commands"
.SH NAME
dosage \- comic strip downloader and archiver
.SH DESCRIPTION
usage: dosage [\-h] [\-v] [\-n NUMSTRIPS] [\-a] [\-c] [\-b PATH] [\-\-baseurl PATH]
.IP
[\-l] [\-\-singlelist] [\-\-version] [\-\-vote] [\-m] [\-t]
[\-o {html,json,rss}] [\-\-no\-downscale] [\-p PARALLEL] [\-\-adult]
[\-\-allow\-multiple]
[comic ...]
.PP
A comic downloader and archiver.
.SS "positional arguments:"
.TP
comic
comic module name (including case insensitive
substrings)
.SS "options:"
.TP
\fB\-h\fR, \fB\-\-help\fR
show this help message and exit
.TP
\fB\-v\fR, \fB\-\-verbose\fR
provides verbose output, use multiple times for more
verbosity
.TP
\fB\-n\fR NUMSTRIPS, \fB\-\-numstrips\fR NUMSTRIPS
traverse and retrieve the given number of comic
strips; use \fB\-\-all\fR to retrieve all comic strips
.TP
\fB\-a\fR, \fB\-\-all\fR
traverse and retrieve all comic strips
.TP
\fB\-c\fR, \fB\-\-continue\fR
traverse and retrieve comic strips until an existing
one is found
.TP
\fB\-b\fR PATH, \fB\-\-basepath\fR PATH
set the path to create invidivual comic directories
in, default is Comics
.TP
\fB\-\-baseurl\fR PATH
the base URL of your comics directory (for RSS, HTML,
etc.); this should correspond to \fB\-\-base\-path\fR
.TP
\fB\-l\fR, \fB\-\-list\fR
list available comic modules
.TP
\fB\-\-singlelist\fR
list available comic modules in a single column list
.TP
\fB\-\-version\fR
display the version number
.TP
\fB\-\-vote\fR
vote for the selected comics
.TP
\fB\-m\fR, \fB\-\-modulehelp\fR
display help for comic modules
.TP
\fB\-t\fR, \fB\-\-timestamps\fR
print timestamps for all output at any info level
.TP
\fB\-o\fR {html,json,rss}, \fB\-\-output\fR {html,json,rss}
sets output handlers for downloaded comics
.TP
\fB\-\-no\-downscale\fR
prevent downscaling when using html or rss handler
.TP
\fB\-p\fR PARALLEL, \fB\-\-parallel\fR PARALLEL
fetch comics in parallel. Specify the number of
connections
.TP
\fB\-\-adult\fR
confirms that you are old enough to view adult content
.TP
\fB\-\-allow\-multiple\fR
allows multiple instances to run at the same time. Use
if you know what you are doing.
.PP
EXAMPLES
List available comics:
.IP
dosage \fB\-l\fR
.PP
Get the latest comic of for example CalvinAndHobbes and save it in the "Comics"
directory:
.IP
dosage CalvinAndHobbes
.PP
If you already have downloaded several comics and want to get the latest
strips of all of them:
.IP
dosage \fB\-\-continue\fR @
.PP
User plugin directory: /home/tchet/.local/share/dosage/plugins
.PP
Using Python 3.11.6 (CPython) on Linux\-6.5.0\-4\-amd64\-x86_64\-with\-glibc2.37
Copyright \(co 2004\-2008 Tristan Seligmann and Jonathan Jacobs
Copyright \(co 2012\-2014 Bastian Kleineidam
Copyright \(co 2015\-2020 Tobias Gruetzmacher
Copyright \(co 2019\-2020 Daniel Ring
.PP
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
.SH "SEE ALSO"
The full documentation for
.B dosage
is maintained as a Texinfo manual.  If the
.B info
and
.B dosage
programs are properly installed at your site, the command
.IP
.B info dosage
.PP
should give you access to the complete manual.