Metadata-Version: 2.1
Name: tankobon
Version: 2021.10.2
Summary: Yet another manga scraper and downloader
Home-page: https://github.com/ongyx/tankobon
Author: Ong Yong Xin
Author-email: ongyongxin2020+github@gmail.com
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Dist: bbcode>=1.1.0
Requires-Dist: beautifulsoup4>=4.9.1
Requires-Dist: click>=7.1.2
Requires-Dist: coloredlogs>=14.0
Requires-Dist: fake-useragent>=0.1.11
Requires-Dist: filetype>=1.0.7
Requires-Dist: fpdf>=1.7.2
Requires-Dist: html5lib>=1.1
Requires-Dist: imagesize>=1.2.0
Requires-Dist: MangaDex.py>=2.0.3
Requires-Dist: natsort>=7.1.0
Requires-Dist: requests>=2.24.0
Requires-Dist: pytest ; extra == "dev"
Requires-Dist: pytest-flake8 ; extra == "dev"
Requires-Dist: pytest-mypy ; extra == "dev"
Requires-Dist: pydoc-markdown>=3.10.1 ; extra == "dev"
Requires-Dist: PySide6>=6.0.3 ; extra == "gui"
Provides-Extra: dev
Provides-Extra: gui

# ![logo](https://raw.githubusercontent.com/ongyx/tankobon/master/.github/logo.jpg) tankobon

![gui](https://raw.githubusercontent.com/ongyx/tankobon/master/example.png "tankobon")

[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![PyPI - Downloads](https://img.shields.io/pypi/dm/tankobon)](https://pypi.org/project/tankobon)
![PyPI - License](https://img.shields.io/pypi/l/tankobon)
![PyPI](https://img.shields.io/pypi/v/tankobon)
![PyPI - Python Version](https://img.shields.io/pypi/pyversions/tankobon)
![Lines of code](https://img.shields.io/tokei/lines/github/ongyx/tankobon)
![calver](https://img.shields.io/badge/calver-YY.MM.MICRO-22bfda.svg)

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](API.md) and [there](CHANGELOG.md).

## Usage (CLI)

```bash
# 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:

```bash
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:

```bash
$ 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:

```bash
$ 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

- [x] tests and docs (docs done)
- [x] create GUI to make downloading easier, like youtube-DLG
- [x] 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:

```bash
$ 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](https://github.com/feathericons/feather) for the icons (all svgs) in the [`resources`](./resources) folder.

## License

MIT.

