1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
|
# Dosage
[](https://github.com/webcomics/dosage/actions/workflows/ci.yaml)
[](https://qlty.sh/gh/webcomics/projects/dosage)
[](https://codecov.io/gh/webcomics/dosage)
[](https://github.com/pre-commit/pre-commit)
Dosage is designed to keep a local copy of specific webcomics and other
picture-based content such as Picture of the Day sites. With the dosage
commandline script you can get the latest strip of a webcomic, or catch-up to
the last strip downloaded, or download a strip for a particular date/index (if
the webcomic's site layout allows this).
Multiple webcomics can be downloaded in parallel, making the update of comic
strips faster.
Dosage is licensed under the [MIT license](COPYING)
## Notice
This software is in no way intended to publically "broadcast" comic strips, it
is purely for personal use. Please be aware that by making downloaded strips
publically available (without the explicit permission of the author) you may be
infringing upon various copyrights.
In any case, you should support the authors of the comics you are downloading,
either by buying some of their products or even donating them some money since
they provide the comics you like and read.
Additionally, Dosage respects (part of) the `robots.txt` exclusion protocol.
This makes it easy for publishers to disallow Dosage access to their site. On
the other hand, Dosage is no classic "crawler" oder "bot", so global rules in
`robots.txt` are ignored.
If you are a publisher of comics and don't want Dosage to access your files,
either open an issue and request removal (this is the preferred solution, since
it documents your wishes to us) or add the following entry to your robots.txt
file:
User-agent: Dosage
Disallow: *
## Usage
List available comics (ca. 3000 at the moment):
$ dosage --list
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 strip
of all of them:
$ dosage @
To help others find good comics, you can vote for your favourite ones:
$ dosage --vote @
For advanced options and features execute `dosage --help`.
### Adult content
Some comics contain adult content and require age confirmation. These comics
can only be downloaded by using the `--adult` option, which confirms that you
are old enough to view them.
## Installation
### Dependencies
Since dosage is written in [Python](http://www.python.org/), a Python
installation is required: Dosage needs at least Python 3.8. Dosage requires
some Python modules from PyPI, so installation with `pip` is recommended.
### Optional dependencies
Some features require optional dependencies, which can be installed by specifying them
while installing Dosage:
- `bash` - Installs shell completion support using the [argcomplete] package.
You still need to register support in your shell using
`eval "$(register-python-argcomplete dosage)"` or using `argcomplete`'s
global completion mode. `argcomplete` officially only supports bash & zsh, but
has limited support for [other shells].
- `compression` - Enables Brotli & zstandard compression - These modern HTTP
compression methods can reduce transferred file size and improve performance.
- `dev` - Dependencies only required for running Dosage's test suite.
[argcomplete]: https://github.com/kislyuk/argcomplete#argcomplete---bashzsh-tab-completion-for-argparse
[other shells]: https://github.com/kislyuk/argcomplete/blob/main/contrib/README.rst
### Using the Windows binary
Windows users can download a complete binary (including Python) from the
[release page].
[release page]: https://github.com/webcomics/dosage/releases/latest
### Install with pipx
The simplest way to install and upgrade dosage is with [pipx]. To install the
newest stable version with all optional features use:
pipx install dosage[bash,compression]
To install the newest development version, use:
pipx install "dosage[bash,compression] @ git+https://github.com/webcomics/dosage.git"
To upgrade such installations, just run:
pipx upgrade dosage
### Installation for development
If you want to run dosage directly from the source code, you should install
it in "[editable]" mode, preferable in a [virtual environment]:
pip install -e .[bash,compression,dev]
After that, `dosage` should be available as a normal command.
[pipx]: https://github.com/pipxproject/pipx
[editable]: https://pip.pypa.io/en/stable/reference/pip_install/#editable-installs
[virtual environment]: https://docs.python.org/3/library/venv.html
## Code Style
This project currently has a pretty "loose" code style. Please use
[`pre-commit`](https://pre-commit.com/#install) to keep the code style
consistent. You can ignore flake8 warnings in code you didn't touch (Set
`SKIP=flake8` before commiting if `pre-commit` doesn't let you).
## Reporting Bugs
You can report bugs, patches or requests at the [GitHub issue
tracker](https://github.com/webcomics/dosage/issues) - Dosage currently
supports a large number of comics and that number grows on a regular basis. If
you feel that there are comics that Dosage does not currently support, but
should support, please feel free to request them.
## Extending Dosage
In order to add a new webcomic, a new module class has to be created in one of
the *.py files in one the `dosagelib/plugins` subdirectory. Look at the
[documentation for adding modules](doc/adding_new_comics.md) and at
existing module classes for examples.
### Test suite status
Dosage has unit tests to ensure code quality. GitHub Actions are used for
continuous build and test integration. See the badges at the top of this page
for the current status.
|
