/comics-downloader

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

Primary LanguageGoMIT LicenseMIT

Comics Downloader

Build Status Coverage Status Go Report Card Github All Releases Release License

Supported Sites

Getting Started

Installing

Download the latest release:

Download the latest GUI release:

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
  -create-default-path comics/[source]/[name]/
        Using this flag your comics/issue will be downloaded without prepending the default folder structure, comics/[source]/[name]/ (default true)
  -custom-comic-name string
        Use a custom name for the comic output.
  -daemon
        Run the download as daemon
  -daemon-timeout int
        DaemonTimeout (seconds), specifies how often the downloader runs (default 600)
  -debug
    	Shows Debug log
  -format string
        Comic format output, supported formats are pdf,epub,cbr,cbz (default "pdf")
  -force-aspect
        Force images to A4 Portrait aspect ratio
  -images-format
        To use with images-only flag, choose the image format, available png,jpeg,img (default "jpg")
  -images-only
        Download comic/manga images
  -issue-number-only
        Force only saving with issue number instead of chapter name + issue number.
  -last
        Download the last Comic issue
  -output string
        Folder where the comics will be saved
  -range
        Range of issues to download, example 3-9
  -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://readallcomics.com
http://www.comicextra.com/
http://www.mangatown.com/
https://mangadex.org/
https://readcomiconline.li/
https://www.mangareader.tv/
https://www.mangakalot.com/
https://www.manganato.com/

Checking for mangas using a Raspberry Pi

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

Multiple URLs

./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 range of issues

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

example:

./comics-downloader -url=[your url] -range=[start-end]

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 -daemon-timeout flag.

./comics-downloader -url=[your url] -daemon -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

Avoid Default Folder Structure

The default folder structure that will be created is: /comics/[source]/[name]/. To avoid that use -create-default-path flag.

./comics-downloader -url=[your url] -create-default-path=false

Built With

Contributing

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

License

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