letanphuc/comics-downloader

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

Comics Downloader

Supported Sites

• https://comicextra.net/
• https://readcomiconline.li/
• https://www.mangareader.tv/
• https://www.mangatown.com/
• https://mangadex.org/
• https://mangakakalot.com/
• https://manganato.com/

Getting Started

Installing

Download the latest release:

• Linux (x86-64)
• Linux (386)
• Mac OSX (Arm64)
• Mac OSX (x86-64)
• Windows
• Windows (386)
• Windows (x86-64)
• Linux ARM
• Linux ARM64

Download the latest GUI release:

• Linux
• Mac OSX
• Windows

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

• go
• gofpdf
• go-epub
• soup
• progressbar
• logrus
• archiver
• regexp2

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