CLI that downloads comic and manga chapters and packs them into CBZ, ZIP, or CBT with ComicInfo.xml metadata.
Point comic-dl at a page and it does the rest:
- Point — a chapter URL, a series URL, or a file of URLs.
- Pick — series, chapters, and pages from the picker.
- Pack — SHA-256-verified pages plus
ComicInfo.xmlinto a CBZ, ZIP, or CBT archive.
comic-dl is not an aggregator and does not bypass authentication, paywalls, or region locks: it downloads only what the site serves you.
| Instead of | comic-dl does |
|---|---|
| Clicking 30 "next" pages and zipping a folder | One URL, verified and numbered page images |
| An ad-hoc per-site script that breaks on redesigns | 34 built-in scrapers plus a plugin system |
| A folder of loose images with no metadata | Reader-ready CBZ/ZIP/CBT with ComicInfo.xml |
Above that, it resumes missing pages, dedupes images by SHA-256, and records finished chapters in a local SQLite library.
Warning
comic-dl is an early release. Commands, flags, and site support can change between releases.
Download a prebuilt package from GitHub Releases:
| Platform | Package |
|---|---|
| Windows | .exe or .zip |
| Debian/Ubuntu | .deb (amd64, arm64) |
| Fedora | .rpm (x86_64, aarch64) |
| Arch | .pkg.tar.zst (x86_64) |
| Any (Python 3.11+) | .whl — install with pip from the file |
| macOS | no native package — see docs/install.md |
comic-dl --versionVerify the download against the release SHA256SUMS; see
docs/install.md.
To run from source, install Python 3.11+ and uv:
git clone https://github.com/fallen020/comic-dl
cd comic-dl
uv sync
uv run comic-dl --versionUse uv run comic-dl from a source checkout. Full per-OS instructions are in
docs/install.md.
Warning
pip install comic-dl is not supported; the PyPI name belongs to an
unrelated project.
comic-dl -u "<gallery-url>" # any URL from a supported site
comic-dl --help # all flagsReplace <gallery-url> with a URL from a
supported site.
The full documentation index lists every page by audience. The ones most readers open first:
- Usage — flags, chapter and page selection, output layout
- Configuration — paths, per-site overrides, cache
- CLI reference — every command and flag
- Write a scraper — add a new site
- Architecture and releasing for contributors
Pull requests are welcome; see CONTRIBUTING.md. Development setup and the test, lint, build, and documentation gates are documented in docs/develop/setup.md.
Download only content you are authorized to access and follow the source site's terms and applicable law. See the Legal and Privacy pages for the full terms and data-handling description.
MIT. Third-party components retain their own terms; see Third-Party-Licenses.