Skip to main content

Yet another manga scraper and downloader

Project description

tankobon

logo

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

What?

tankobon is (somewhat) like youtube-dl for manga websites: you can fetch manga from a few sources (websites).

Currently, the following websites are supported:

  • catmanga.org
  • mangakakalot.com
  • mangadex.org

Versioning Change

tankobon will now use the version format YYYY.MM.MICRO:

  • YYYY is the full 4-digit year.
  • MM is the 1-2 digit month.
  • MICRO is the release number for that month.

API Docs

See here.

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?)

Note on mangadex

Since mangadex's frontend isn't really done yet, manga hosted there do not have a 'public' url yet. To add a mangadex manga, the url must look like this:

https://mangadex.org/(manga uuid)

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?)

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.6.3.tar.gz (135.8 kB view hashes)

Uploaded Source

Built Distribution

tankobon-2021.6.3-py3-none-any.whl (91.1 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