A modified version of https://github.com/webcomics/dosage
Find a file
2019-12-17 01:28:02 +01:00
.github Don't fail website deployment if nothing changed 2019-12-05 21:35:31 +01:00
doc Add StaticSite config and theme. 2018-03-11 01:21:30 +01:00
dosagelib Add Anaria 2019-12-17 01:28:02 +01:00
scripts Mark KeenSpot/GeneCatlow completed :( 2019-12-17 00:05:47 +01:00
tests Add some tests for the update check 2019-12-05 22:23:48 +01:00
.codeclimate.yml Add CodeClimate config. 2016-03-06 00:41:10 +01:00
.gitattributes Remove more old stuff. 2016-03-20 18:59:42 +01:00
.gitignore Replace pbr with plain setuptools 2019-12-01 18:04:38 +01:00
.mailmap Switch build to PBR. 2015-11-03 23:27:53 +01:00
.staticsite.py Enable warnings and fix some of them 2018-05-23 00:54:40 +02:00
.travis.yml Travis-CI: Don't use shallow clones 2019-12-05 22:54:43 +01:00
CHANGELOG.md Mention progress bar removal in changelog 2019-11-25 18:35:43 +01:00
COPYING Update copyright year. 2018-03-11 01:17:43 +01:00
dosage Update copyright year. 2018-03-11 01:17:43 +01:00
Jenkinsfile Jenkins: Use modern coverage api 2019-10-28 16:15:26 +01:00
MANIFEST.in Remove more old stuff. 2016-03-20 18:59:42 +01:00
README.md Test with Python 3.8 (and drop support for 3.4) 2019-10-28 16:00:38 +01:00
requirements.txt Switch from pkg_resources to importlib 2019-12-05 21:40:45 +01:00
setup.cfg Switch from pkg_resources to importlib 2019-12-05 21:40:45 +01:00
setup.py Replace pbr with plain setuptools 2019-12-01 18:04:38 +01:00
tox.ini Test with Python 3.8 (and drop support for 3.4) 2019-10-28 16:00:38 +01:00

Dosage

Build Status Code Climate codecov Maintenance

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: *

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.

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.

Dependencies

Python: for Python 2.x at least 2.7.0, for Python 3.x at least Python 3.5. Dosage requires the following Python modules:

  • colorama
  • lxml
  • requests
  • six

For certain modules, you need the cssselect module, for bash argument completion you need the argcomplete module.

Installation

The easy way with pip:

pip install --user dosage

You can invoke Dosage directly from the source code as ./dosage. Alternatively, you can install Dosage using setuptools by invoking setup.py in the root of the distribution. For example:

python setup.py install

or if you do not have root permissions:

python setup.py install --home=$HOME

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.