e1821e23ba
* Fix Twokinds * Fix XKCD * Fix Unsounded * Fix SluggyFreelance * Fix Oglaf * Fix missing and incorrect renames * Fix WLP/PeterIsTheWolf{General,Adult} |
||
---|---|---|
.github | ||
doc | ||
dosagelib | ||
scripts | ||
tests | ||
.codeclimate.yml | ||
.gitattributes | ||
.gitignore | ||
.mailmap | ||
.staticsite.py | ||
.travis.yml | ||
CHANGELOG.md | ||
COPYING | ||
dosage | ||
Jenkinsfile | ||
MANIFEST.in | ||
README.md | ||
requirements.txt | ||
setup.cfg | ||
setup.py | ||
tox.ini |
Dosage
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.
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.
Additionally, Dosage respects the robots.txt exclusion protocol. This makes sure no content is accessed in an automatic way without consent by the publishers.
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.
If you are a publisher of comics and want Dosage to access your files, add the following entry to your robots.txt file:
User-agent: Dosage
Allow: *
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, a Python
installation is required: Dosage needs at least Python 3.5. Dosage requires
some Python modules from PyPI, so installation with pip
is recommended.
Using the Windows binary
Windows users can download a complete binary (including Python) from the release page.
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 --spec dosage[css,bash] dosage
To install the newest development version, use:
pipx install --spec "dosage[css,bash] @ git+https://github.com/webcomics/dosage.git" dosage
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 .[css,bash]
You can invoke Dosage directly from the source code as ./dosage
, but this
mode of operation is discouraged, since dependencies might be missing.
Reporting Bugs
You can report bugs, patches or requests at the GitHub issue tracker - 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 the dosagelib/plugins
subdirectory. Look at the
documentation for adding modules and at
existing module classes for examples.
Test suite status
Dosage has extensive unit tests to ensure the code quality. Travis-CI is used for continuous build and test integration. See the badges at the top of this page for the current status.