{"id":27154737,"url":"https://github.com/potatoeggy/mandown","last_synced_at":"2025-04-08T18:33:29.133Z","repository":{"id":38274308,"uuid":"444216670","full_name":"potatoeggy/mandown","owner":"potatoeggy","description":"Comic/manga/webtoon downloader and CBZ/EPUB/MOBI/PDF converter","archived":false,"fork":false,"pushed_at":"2024-05-19T03:13:15.000Z","size":449,"stargazers_count":41,"open_issues_count":4,"forks_count":7,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-05-19T04:22:58.345Z","etag":null,"topics":["cbz","comics","converter","downloader","ebook","epub","ereader","kobo","manga","pdf","python","python3","webtoon","webtoons"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/potatoeggy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-01-03T22:27:32.000Z","updated_at":"2024-05-19T04:22:59.498Z","dependencies_parsed_at":"2024-05-16T06:08:02.260Z","dependency_job_id":null,"html_url":"https://github.com/potatoeggy/mandown","commit_stats":{"total_commits":225,"total_committers":5,"mean_commits":45.0,"dds":"0.40888888888888886","last_synced_commit":"7640a57b741f9714b850def462e9adc2d3cf48e9"},"previous_names":[],"tags_count":30,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/potatoeggy%2Fmandown","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/potatoeggy%2Fmandown/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/potatoeggy%2Fmandown/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/potatoeggy%2Fmandown/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/potatoeggy","download_url":"https://codeload.github.com/potatoeggy/mandown/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247902394,"owners_count":21015439,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cbz","comics","converter","downloader","ebook","epub","ereader","kobo","manga","pdf","python","python3","webtoon","webtoons"],"created_at":"2025-04-08T18:32:29.646Z","updated_at":"2025-04-08T18:33:29.125Z","avatar_url":"https://github.com/potatoeggy.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# mandown\n\n![Supported Python versions](https://img.shields.io/pypi/pyversions/mandown)\n[![Checked with mypy](http://www.mypy-lang.org/static/mypy_badge.svg)](http://mypy-lang.org/)\n[![Download from PyPI](https://img.shields.io/pypi/v/mandown)](https://pypi.org/project/mandown)\n[![Download from the AUR](https://img.shields.io/aur/version/mandown-git)](https://aur.archlinux.org/packages/mandown-git)\n[![Latest release](https://img.shields.io/github/v/release/potatoeggy/mandown?display_name=tag)](https://github.com/potatoeggy/mandown/releases/latest)\n[![License](https://img.shields.io/github/license/potatoeggy/mandown)](/LICENSE)\n\nMandown is a comic downloader and a CBZ, EPUB, MOBI, and/or PDF converter. It also supports image post-processing to make them more readable on certain devices similarly to [Kindle Comic Converter](https://github.com/ciromattia/kcc).\n\n## Features\n\n- Download comics from [supported sites](#supported-sites)\n  - Supports downloading a range of chapters\n  - Supports multithreaded downloading\n- Process downloaded images\n  - Rotate or split double-page spreads\n  - Trim borders\n  - Resize images\n- Convert downloaded comics to CBZ, EPUB, MOBI, or PDF\n  - Convert any other CBZ, EPUB, MOBI, or PDF comic to CBZ, EPUB, MOBI, or PDF\n- [A library to easily do all of this from other Python scripts](#basic-library-usage)\n\n## Usage\n\nRun `mandown --help` or see the [docs](/docs/) for more information and examples.\n\n```\nmandown get \u003cURL\u003e\n```\n\nTo convert the downloaded contents to CBZ/EPUB/MOBI/PDF, append the `--convert` option. To apply image processing to the downloaded images, append the `--process` option.\n\n```\nmandown get \u003cURL\u003e --convert epub --process rotate_double_pages\n```\n\nTo download only a certain range of chapters, append the `--start` and/or `--end` options.\n\n\u003e **Note:** `--start` and `--end` are _inclusive_, i.e., using `--start 2 --end 3` will download chapters 2 and 3.\n\nTo convert an existing folder or comic file without downloading anything (like a stripped-down version of \u003chttps://github.com/ciromattia/kcc\u003e), use the `convert` command.\n\n```\nmandown convert \u003cFORMAT\u003e \u003cPATH_TO_COMIC\u003e\n```\n\nTo process an existing folder without downloading anything, use the `process` command.\n\n```\nmandown process \u003cPROCESS_OPERATIONS\u003e \u003cPATH_TO_FOLDER\u003e\n```\n\nWhere `PROCESS_OPERATIONS` is an option found from running `mandown process --help`.\n\n## Installation\n\nInstall the package from PyPI:\n\n```\npip3 install mandown\n```\n\nInstall the optional large dependencies for some features of Mandown:\n\n```\n# graphical interface (GUI)\npip3 install PySide6\n```\n\nArch Linux users may also install the package from the [AUR](https://aur.archlinux.org/packages/mandown-git):\n\n```\ngit clone https://aur.archlinux.org/mandown-git.git\nmakepkg -si\n```\n\nOr, to build from source:\n\nMandown uses [poetry](https://github.com/python-poetry/poetry) for dependency management.\n\n```\ngit clone https://github.com/potatoeggy/mandown.git\npoetry install\npoetry build\npip3 install dist/mandown*.whl\n```\n\n## Supported sites\n\nTo request a new site, please file a [new issue](https://github.com/potatoeggy/mandown/issues/new?title=Source%20request:).\n\n- \u003chttps://bato.to\u003e\n- \u003chttps://blogtruyenmoi.com\u003e\n- \u003chttps://comicfury.com\u003e\n- https://\\*.thecomicseries.com\n- \u003chttps://mangasee123.com\u003e\n- \u003chttps://manganato.com\u003e\n- \u003chttps://webtoons.com\u003e\n- \u003chttps://mangadex.org\u003e\n- \u003chttps://mangakakalot.com\u003e\n- \u003chttps://manhuaaz.com\u003e\n- \u003chttps://readcomiconline.li\u003e\n- \u003chttps://www.kuaikanmanhua.com\u003e\n\n## Basic library usage\n\nSee the [docs](/docs/) for more information and examples.\n\nTo just download the images:\n\n```python\nimport mandown\n\nmandown.download(\"https://comic-site.com/the-best-comic\")\n```\n\nTo download and convert to EPUB:\n\n```python\nimport mandown\n\ncomic = mandown.query(\"https://comic-site.com/the-best-comic\")\nmandown.download(comic)\nmandown.convert(comic, title=comic.metadata.title, to=\"epub\")\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpotatoeggy%2Fmandown","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpotatoeggy%2Fmandown","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpotatoeggy%2Fmandown/lists"}