Skip to main content

Yet another manga scraper and downloader

Project description

logo tankobon

gui

Code style: black PyPI - Downloads PyPI - License PyPI PyPI - Python Version Lines of code calver

Pure-python manga downloader.

The following websites are currently supported:

  • catmanga.org
  • mangakakalot.com
  • mangadex.org
  • https://genshin.mihoyo.com/en/manga

API Docs / Changelog

See here and there.

Usage (CLI)

# Add a manga url to the cache (at ~/.tankobon):
tankobon refresh https://catmanga.org/series/komi

# Then download it (to the current folder)...
tankobon download https://catmanga.org/series/komi

# ...and pack it into a nice pdf file for use with your favourite e-reader.
tankobon pdfify -o komi.pdf

Or maybe you might want to use the GUI instead:

tankobon gui

What it can do:

  • Add/refresh/delete manga
  • Show HTML-based previews of the manga cover, description, etc.
  • Download manga

What it can't do:

  • Show manga pages (pdf reader?)

Multilingual Support

tankobon now supports manga with multiple language translations (especially for Mangadex)!

Configuration (CLI)

First check the languages the manga supports:

$ tankobon info <shorthash> | grep languages -A10
...
languages: čeština, český jazyk (cs)
           English (en)
           Italiano (it)
           Русский (ru)
           Español (es)
           Português (pt)
           Bahasa Indonesia (id)
           język polski, polszczyzna (pl)
           Nederlands, Vlaams (nl)
           français, langue française (fr)

Next, set the language:

$ tankobon config lang <code>

where code is the two-letter ISO 639-1 id (i.e fr for français) beside the language's native name.

Configuration (GUI)

On the menu bar, click File -> Settings and change the language using the drop-down menu. Once the settings are closed, the manga currently being displayed will be reloaded to show the selected language.

Todo

  • tests and docs (docs done)
  • create GUI to make downloading easier, like youtube-DLG
  • Add user configuration to select another language
  • Searcher class (to search for manga?)
  • i18n for selected language?

Install

pip install tankobon

Contributing

Just send in a PR with your feature changes/bug fixes. To set up development builds for tankobon, do the following:

$ git clone https://github.com/ongyx/tankobon && cd tankobon

# (create and enter a virtualenv if you want)
$ flit install -s  # Install tankobon as a symlink (any changes to source code will be reflected immediately)

# (make your code changes here...)

# Make sure to fix any style/type errors if they show up by running this.
$ pytest --flake8 --mypy

Credits

feather for the icons (all svgs) in the resources folder.

License

MIT.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tankobon-2021.7.11.tar.gz (914.9 kB view hashes)

Uploaded Source

Built Distribution

tankobon-2021.7.11-py3-none-any.whl (105.0 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page