Simple manga console downloader
Project description
simple-manga-downloader
Simple manga console downloader written in python.
Currently supports:
Note: mangadex and mangasee are the main supported sites, the others will 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
Note:
You can't add and remove at the same time, if both -a
and -r
are present it will only add manga.
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
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for simple-manga-downloader-1.8.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9fb47c0cea41a026b250bfd43a61a70b79a44eda1128d0e1ce4a3fa4b767aa59 |
|
MD5 | c776fdb0e6785f878ad19c1620aa7e97 |
|
BLAKE2b-256 | 865f4d5764162965a339be0fcc5a555a88af71330749ff1cd1a39c7d495d5952 |
Hashes for simple_manga_downloader-1.8.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | fd582f806ecca3cfe17f4d20ea7a0dac6873dedf8d0bc75a3ce317ce8a8b7455 |
|
MD5 | 29797fc26f197bfce2f085adf34bb985 |
|
BLAKE2b-256 | 31d378ac362b0f852f796b3d9c8c578372bf7909b0c8d44793786f5039323c06 |