Skip to main content

mangapy

Manga downloader supporting the following sources:

  • fanfox.net
  • mangadex.org (via api.mangadex.org)

Installation

pipx install mangapy

Or, on macOS with Homebrew:

brew install alemar11/tap/mangapy

Usage

Terminal

Mangapy let you download manga chapters as images (default) or pdfs. Use 'mangapy -h' to get a list of all the availabe options.

Downloads all Bleach chatpers as images inside the Downloads folder (from Fanfox source).

mangapy title bleach -a -o ~/Downloads

Downloads all Bleach chatpers as a single .pdf file inside the Downloads folder (from Fanfox source).

mangapy title bleach -a -o ~/Downloads --pdf

Downloads Bleach chatper 1 as images inside the Downloads folder (from Fanfox source).

mangapy title bleach -c 1 -o ~/Downloads

Downloads Bleach chatpers from 0 to 10 (included) as images inside the Downloads folder using Fanfox as source.

mangapy title bleach -c 0-10 -o ~/Downloads -s fanfox

Disable network retries (useful for benchmarking).

mangapy title bleach -c 1 -o ~/Downloads --no-retry

Disable progress output.

mangapy title bleach -c 1 -o ~/Downloads --no-progress

You may need a proxy to download certain manga, to do so use the option -p or --proxy: Downloads the last One Piece chapter as images inside the Downloads folder (from Fanfox source) using the proxy during the search.

mangapy title "one piece" -o ~/Downloads -p '{"http": "194.226.34.132:8888", "https": "194.226.34.132:8888"}'

YAML

Mangapy let you download multiple manga chapters as images (default) or pdfs from a .yaml file. For every manga you can choose:

  • source (fanfox, mangadex)
  • whether or not save the manga as a single pdf
  • which chapter to download (single, range, all, last)
  • MangaDex-only options: translated_language, content_rating, data_saver
mangapy yaml PATH_TO_YOUR_YAML_FILE

Samples for YAML mode live in samples/. For local testing from source, run:

uv run python3 scripts/dev_run.py <sample-filename.yaml>
--- 
 debug: true # optional
 no_retry: false # optional, disable retries
 no_progress: false # optional, disable progress output
 output: "~/Downloads/mangapy"
 proxy: # optional
  http: "http://31.14.131.70:8080"
  https: "http://31.14.131.70:8080" 
 downloads:
  - source: "fanfox"
    title: "bleach"
    pdf: true
    download_single_chapter: "10"
    no_retry: true
  - source: "fanfox"
    title: "naruto"
    pdf: true
    download_chapters: "10-13"
  - source: "mangadex"
    title: "blue lock"
    translated_language: ["en"]
    content_rating: ["safe", "suggestive", "erotica"]
    data_saver: false
    download_all_chapters: true

Download files

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

Source Distribution

mangapy-4.0.1.tar.gz (23.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mangapy-4.0.1-py3-none-any.whl (19.5 kB view details)

Uploaded Python 3

File details

Details for the file mangapy-4.0.1.tar.gz.

File metadata

  • Download URL: mangapy-4.0.1.tar.gz
  • Upload date:
  • Size: 23.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.12.2 {"installer":{"name":"uv","version":"0.12.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for mangapy-4.0.1.tar.gz
Algorithm Hash digest
SHA256 adaa46345ba33dbf667f5a310bbe3c9104c6eb600eeddb19e288e6bcb20c58d5
MD5 1a277026e068e47a508df87a3826798e
BLAKE2b-256 c1fa69b6e2bdab8e5704546c21095296423a0f0f56c64c263d66b874e8425603

See more details on using hashes here.

File details

Details for the file mangapy-4.0.1-py3-none-any.whl.

File metadata

  • Download URL: mangapy-4.0.1-py3-none-any.whl
  • Upload date:
  • Size: 19.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.12.2 {"installer":{"name":"uv","version":"0.12.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for mangapy-4.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 dc3818ad558c77f921c13609822c34284b520c2a1b464948a6f410c5bde5a4a4
MD5 6a9b12c1195d2757f619a3c6029634e2
BLAKE2b-256 73f32d4e845cd16c2ab8d3dda1930f1b9834e473b85330d46d078bd4e4b71135

See more details on using hashes here.

Release history Release notifications | RSS feed

4.1.1

2 files

4.1.0

2 files

This release

4.0.1 This release

2 files

4.0.0

2 files

3.0.2

2 files

3.0.1

2 files

3.0.0

2 files

2.1.0

2 files

2.0.5

2 files

2.0.4

2 files

2.0.2

2 files

2.0.1

2 files

2.0.0

2 files

1.5.6

2 files

1.5.5

2 files

1.5.4

2 files

1.5.3

2 files

1.5.2

2 files

1.5.1

2 files

1.5.0

2 files

1.4.0

2 files

1.3.4

2 files

1.3.3

2 files

1.3.2

2 files

1.3.1

2 files

1.2.0

2 files

1.1.1

2 files

1.1.0

2 files

1.0.3

2 files

1.0.2

2 files

1.0.1

2 files

1.0.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page