simple-manga-downloader

Simple manga console downloader


Keywords
manga, downloader, command-line-tool, manga-downloader, mangadex, pipfile, python
License
GPL-3.0
Install
pip install simple-manga-downloader==1.10.0

Documentation

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.