Skip to main content

Simple manga console downloader

Project description

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.

Project details


Download files

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

Source Distribution

simple-manga-downloader-1.16.1.tar.gz (33.6 kB view details)

Uploaded Source

Built Distribution

simple_manga_downloader-1.16.1-py3-none-any.whl (37.3 kB view details)

Uploaded Python 3

File details

Details for the file simple-manga-downloader-1.16.1.tar.gz.

File metadata

File hashes

Hashes for simple-manga-downloader-1.16.1.tar.gz
Algorithm Hash digest
SHA256 4d0a1549160c025637310dfbe1280f73f36391f1a2ccdea1e32924245a638f5d
MD5 4b21b0bf15af13ff167ddba92b60489a
BLAKE2b-256 8f4ae5c1657374e25e2cf9a1a719ad7520588ec0697ceff46615a0867bb4c3ed

See more details on using hashes here.

File details

Details for the file simple_manga_downloader-1.16.1-py3-none-any.whl.

File metadata

File hashes

Hashes for simple_manga_downloader-1.16.1-py3-none-any.whl
Algorithm Hash digest
SHA256 5c205493cd7e04db70c57b6fafbf14177b2cb76c6ca0ff7adbb670046ad920de
MD5 b9d09eed57f33fc3bac06339d42eb9a9
BLAKE2b-256 a6cddfb4eee69be970da0334c9d56250c7e8266696a97f318480457535734532

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page