/comics-downloader

tool to download comics and manga in pdf/epub/cbr/cbz from a website

Primary LanguageGoMIT LicenseMIT

Comics Downloader

CircleCI Coverage Status Go Report Card Github All Releases Release License

Supported Sites

Getting Started

Installing

Download the latest release:

Download the latest GUI release:

Put the script under a folder.

Usage

You can invoke the --help:

Usage:
  -all
        Download all issues of the Comic or Comics
  -country string
        Set the country to retrieve a manga, Used by MangaDex which uses ISO 3166-1 codes
  -daemon
        Run the download as daemon
  -format string
        Comic format output, supported formats are pdf,epub,cbr,cbz (default "pdf")
  -images-format
        To use with images-only flag, choose the image format, available png,jpeg,img (default "jpg")
  -images-only
        Download comic/manga images
  -last
        Download the last Comic issue
  -output string
        Folder where the comics will be saved
  -timeout int
        Timeout (seconds), specifies how often the downloader runs (default 600)
  -url string
        Comic URL or Comic URLS by separating each site with a comma without the use of spaces
  -version
        Display release version

Options supported

Source all country last
http://www.comicextra.com/
https://www.mangareader.net/
http://www.mangatown.com/
https://mangadex.cc/
https://mangadex.org/

Checking for mangas using a Raspberry Pi

If you'd like to track your favourite mangas you can use this bash script.

Multiple URLs

Without url parameter:

./comics-downloader url1 url2 url3

With url parameter:

./comics-downloader -url=url,url2,url3

Specify the format output

available formats:

  • pdf
  • epub
  • cbr
  • cbz

Default format is pdf.

example:

./comics-downloader -url=[your url] -format=epub

Download the whole comic

Provide the comic url and use the -all flag. The url provided can be any issue of the comic, or the main comic page url.

example:

./comics-downloader -url=[your url] -all

Download the last comic issue

To download the last comic issue use -last flag.

./comics-downloader -url=[your url] -last

Download to custom folder

To download to a custom folder use the -output flag. The folder will be created if not already existing.

./comics-downloader -url=[your url] -output=[your path]

Run as daemon

You can run the CLI downloader as daemon using -daemon flag. works only if -all or -last flags are specified.

./comics-downloader -url=[your url] -daemon

You can customize the daemon timeout using the -timeout flag.

./comics-downloader -url=[your url] -daemon -timeout=300

Download Only the Images

You can download only the images using -images-only flag.

./comics-downloader -url=[your url] -images-only

To choose the format use -images-format flag, the available formats are:

  • img
  • png
  • jpg

Default is jpg.

./comics-downloader -url=[your url] -images-only -images-format=jpg

Built With

Contribuiting

Feel free to submit a pull request, a guide to setup the development enviroment is available here

License

This project is licensed under the MIT License - see the LICENSE file for details