Skip to main content

simple-manga-downloader

Simple manga console downloader written in python. Made for Linux but should work on any platform.

Currently supports:

Note: mangadex is the main supported site, the others might be maintained but they are not my top priority.

Allows you to download manga in 5 ways:

  • all chapters of a series
  • a range of chapters (from 5 to 15)
  • a selection of chapters (5, 7, 10, 20)
  • only the newest chapter
  • check for new chapters for the tracked manga

Additional features of the downloader:

  • It will check if a chapter on mangadex.org has multiple uploads by different groups and ask which one to download
  • It handles the MangaPlus chapters on mangadex
  • Allows to use data saver images from Mangadex
  • It can download the cover(s) for the manga (off by default)
  • You can specify the language (mangadex only)
  • You can specify which chapters to exclude from the download
  • You can change the directory where the manga is saved
  • You can add ongoing manga to the tracked list for a easy way to check for new chapters
  • Config is saved as a .json for readability and easy modification
  • The downloader has a config "mode" that allows the modification of the config file without having to edit the .json manually
  • It can check for new available versions
  • It will remove (or replace) characters from titles that could cause problems, by default removes / \ | ? > < . : ? * "

Installation

Requirements

  • BeautifulSoup 4
  • requests

Releases form PyPI

Installing using pip will handle the requirements automatically. I would also recommend using pipx instead of just pip.

pip install simple-manga-downloader

Using the git repo

Installing using pip

To install from the master branch

pip install git+https://github.com/Kanjirito/simple-manga-downloader@master

Using the git repo without installing

Copy the repo, install the requirements and use the entry script in the main repo directory

cd path/to/repo
chmod +x SMD.py
pip install -r requirements.txt
./SMD.py [mode] [arguments]

USAGE

General info

For all commands you can either use SMD or smd.

The default manga download directory is ~/Manga this can be changed in the config file or in the command. The config directory is $XDG_CONFIG_HOME/SMD (~/.config/SMD if variable not set), you can specify a different config to be used like this:

SMD -c "path/to/config" mode arguments

Examples:

SMD -c "~/Downloader/config.json" down link_to_manga -l
SMD -c "~/Downloader/config.json" update

To create the config file the downloader needs to successfully finish. If you want to have the config created before you use the downloader you can do:

SMD conf

Details

For a more detailed explanation of the modes and their available arguments read the USAGE.md file in the git repo.

Changelog

Changelog can be found in CHANGELOG.md in the git repo.

Release files for simple-manga-downloader 1.16.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for simple-manga-downloader 1.16.1
File Size Uploaded
simple-manga-downloader-1.16.1.tar.gz 33.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for simple-manga-downloader 1.16.1
File Interpreter ABI Platform
simple_manga_downloader-1.16.1-py3-none-any.whl Python 3 none any Details

Total release size: 70.9 kB

Release files / simple-manga-downloader-1.16.1.tar.gz

Download URL simple-manga-downloader-1.16.1.tar.gz
Size 33.6 kB
Tags Source
SHA-256 checksum
How to use checksums
4d0a1549160c025637310dfbe1280f73f36391f1a2ccdea1e32924245a638f5d
BLAKE2b-256 checksum
How to use checksums
8f4ae5c1657374e25e2cf9a1a719ad7520588ec0697ceff46615a0867bb4c3ed
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.10.4

Release files / simple_manga_downloader-1.16.1-py3-none-any.whl

Download URL simple_manga_downloader-1.16.1-py3-none-any.whl
Size 37.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5c205493cd7e04db70c57b6fafbf14177b2cb76c6ca0ff7adbb670046ad920de
BLAKE2b-256 checksum
How to use checksums
a6cddfb4eee69be970da0334c9d56250c7e8266696a97f318480457535734532
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.10.4

Release history Release notifications | RSS feed

This release

1.16.1 This release

2 release files

1.16.0

2 release files

1.15.4

2 release files

1.15.3

2 release files

1.15.1

2 release files

1.15.0

2 release files

1.14.0

2 release files

1.13.0

2 release files

1.12.0

2 release files

1.11.2

2 release files

1.11.1

2 release files

1.11.0

2 release files

1.10.0

2 release files

1.9.3

2 release files

1.9.2

2 release files

1.9.1

2 release files

1.9.0

2 release files

1.8.0

2 release files

1.7.0

2 release files

1.6.1

2 release files

1.6.0

2 release files

1.5.1

2 release files

1.5.0

2 release files

1.4.1

2 release files

1.4.0

2 release files

1.3.0

2 release files

1.2.1

2 release files

1.2.0

2 release files

1.1.1

2 release files

1.0.1

2 release 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