simple-manga-downloader 1.9.1

Simple manga console downloader

simple-manga-downloader

Simple manga console downloader written in python.

Currently supports:

• mangadex
• mangaseeonline
• mangatown
• mangakakalot
• manganelo

Note: mangadex and mangasee are the main supported sites, 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
• It can download the cover 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

Installation

Requirements

• BeautifulSoup 4
• requests

pip

Installing using pip will handle the requirements automatically

PyPI

pip install simple-manga-downloader

Git

Copy the repo, cd into it and run

pip install .

Using the git repo

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

The default manga download directory is ~/Manga this can be changed in the config file or in the command. The config directory is ~/.config/SMD, 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

Download mode

This mode will download the manga from the link based on your selection, accepts multiple links.

Download all of the chapters:

SMD down link_to_manga [more_links]

Download a range of chapters (both ends are inclusive):

SMD down link_to_manga [more_links] -r 1 20
SMD down link_to_manga [more_links] --range 1 20

Download specific chapters (works if numbers are not in order):

SMD down link_to_manga [more_links] -s 1 10 5 15
SMD down link_to_manga [more_links] --selection 1 10 5 15

Download the newest chapter (based on chapter number not time of upload):

SMD down link_to_manga [more_links] -l
SMD down link_to_manga [more_links] --latest

Exclude chapters from download (works together with -r and -s):

SMD down link_to_manga [more_links] -e 5 10 1
SMD down link_to_manga [more_links] --exclude 5 10 1

Download into a different directory:

SMD down link_to_manga -d "some/custom/path"
SMD down link_to_manga --directory "some/custom/path"

Download using a custom name:

SMD down link_to_manga -n Some new name
SMD down link_to_manga --name Some new name

Warning: Using a custom name when downloading multiple manga at once will cause overwriting of the files since all of them will be assigned the same name

Download a manga from the tracked list by index:

SMD down 1 3 5

Download manga without asking for any input:

SMD down manga_url -i
SMD down manga_url --ignore_input

Same as above but without downloading:

SMD down manga_url -c
SMD down manga_url --check

Update mode

This mode will go over every manga tracked in the config and download every missing chapter

SMD update

Use a custom directory:

SMD update -d "some/custom/path"
SMD update --directory "some/custom/path"

To only check for new chapters without downloading or needing input:

SMD update -c
SMD update --check

Same as above but without downloading:

SMD update -i
SMD update --ignore_input

Config mode

This mode allows the modification of the config file.

Changing the mangadex language:

SMD conf --change_lang code

Listing available language codes:

SMD conf --list_lang

Adding a manga to the tracked list:

SMD conf -a link_to_manga [more_links]
SMD conf --add-tracked link_to_manga [more_links]

Removing a manga from the tracked list using links:

SMD conf -r link_to_manga [more_links]
SMD conf --remove-tracked link_to_manga [more_links]

Removing a manga from the tracked list by index:

SMD conf -r 5 1 3
SMD conf --remove-tracked 5 1 3

Removing a manga from the tracked list by title:

SMD conf -r title "title with spaces"
SMD conf --remove-tracked title "title with spaces"

Removal by index, title and link can be used together (works if multiple point to the same manga):

SMD conf -r link_to_manga 5 "sample title" link_to_manga 2

Clearing the tracked list:

SMD conf -t
SMD conf --clear-tracked

Changing the manga download directory:

SMD conf -s path/to/directory
SMD conf --save-directory path/to/directory

Toggle the covers setting:

SMD conf -c
SMD conf --covers

Reset the config to the default:

SMD conf -d
SMD conf --default

Listing all of the tracked manga(add -v/--verbose flag to also print the links):

SMD conf -l (-v)
SMD conf --list-tracked (--verbose)

Change the position of a manga:

SMD conf -m
SMD conf --modify-position

Print the current settings:

SMD conf -p
SMD conf --print_conf

Change the page download timeout (in seconds):

SMD conf --timeout seconds

Version mode

To print the current version:

SMD version

To check for new versions

SMD version -c
SMD version --check