{"id":13467835,"url":"https://github.com/Girbons/comics-downloader","last_synced_at":"2025-03-26T03:31:10.630Z","repository":{"id":33802788,"uuid":"157590891","full_name":"Girbons/comics-downloader","owner":"Girbons","description":"tool to download comics and manga in pdf/epub/cbr/cbz from a website","archived":false,"fork":false,"pushed_at":"2024-07-22T07:08:11.000Z","size":62293,"stargazers_count":488,"open_issues_count":9,"forks_count":54,"subscribers_count":12,"default_branch":"master","last_synced_at":"2024-10-29T21:59:05.602Z","etag":null,"topics":["cbr","cbz","comic","comic-downloader","comicextra","comics-downloader","command-line-tool","download-comics","epub","fyne","go","linux","manga","manga-downloader","manga-scraper","mangatown","osx","pdf","windows"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Girbons.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-11-14T18:12:05.000Z","updated_at":"2024-10-26T15:14:01.000Z","dependencies_parsed_at":"2024-04-19T11:27:13.519Z","dependency_job_id":"45bb0a6d-12f2-490d-9311-46a03aba2bc8","html_url":"https://github.com/Girbons/comics-downloader","commit_stats":{"total_commits":208,"total_committers":18,"mean_commits":"11.555555555555555","dds":"0.12019230769230771","last_synced_commit":"90322c0b290eed6c74d678333b06ff02eddada24"},"previous_names":[],"tags_count":81,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Girbons%2Fcomics-downloader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Girbons%2Fcomics-downloader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Girbons%2Fcomics-downloader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Girbons%2Fcomics-downloader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Girbons","download_url":"https://codeload.github.com/Girbons/comics-downloader/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245584705,"owners_count":20639610,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cbr","cbz","comic","comic-downloader","comicextra","comics-downloader","command-line-tool","download-comics","epub","fyne","go","linux","manga","manga-downloader","manga-scraper","mangatown","osx","pdf","windows"],"created_at":"2024-07-31T15:01:01.146Z","updated_at":"2025-03-26T03:31:10.127Z","avatar_url":"https://github.com/Girbons.png","language":"Go","funding_links":[],"categories":["Go","Download utilities"],"sub_categories":["Application-specific"],"readme":"# Comics Downloader\n\n[![Build Status](https://app.travis-ci.com/Girbons/comics-downloader.svg?branch=master)](https://app.travis-ci.com/Girbons/comics-downloader)\n[![Coverage Status](https://img.shields.io/coveralls/github/Girbons/comics-downloader.svg?style=flat-square)](https://coveralls.io/github/Girbons/comics-downloader?branch=master)\n[![Go Report Card](https://goreportcard.com/badge/github.com/Girbons/comics-downloader)](https://goreportcard.com/report/github.com/Girbons/comics-downloader)\n[![Github All Releases](https://img.shields.io/github/downloads/Girbons/comics-downloader/total.svg?style=flat-square)]()\n[![Release](https://img.shields.io/github/release/Girbons/comics-downloader.svg?style=flat-square)](https://github.com/Girbons/comics-downloader/releases/latest)\n[![License](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)](LICENSE)\n\n## Supported Sites\n\n- https://comicextra.net/\n- https://readcomiconline.li/\n- https://www.mangareader.tv/\n- https://www.mangatown.com/\n- https://mangadex.org/\n- https://mangakakalot.com/\n- https://manganato.com/\n\n## Getting Started\n\n### Installing\n\nDownload the latest release:\n\n- [Linux (x86-64)](https://github.com/Girbons/comics-downloader/releases/download/v0.33.9/comics-downloader-linux-x86-64)\n- [Linux (386)](https://github.com/Girbons/comics-downloader/releases/download/v0.33.9/comics-downloader-linux-386)\n- [Mac OSX (Arm64)](https://github.com/Girbons/comics-downloader/releases/download/v0.33.9/comics-downloader-osx-arm)\n- [Mac OSX (x86-64)](https://github.com/Girbons/comics-downloader/releases/download/v0.33.9/comics-downloader-osx-x86-64)\n- [Windows](https://github.com/Girbons/comics-downloader/releases/download/v0.33.9/comics-downloader.exe)\n- [Windows (386)](https://github.com/Girbons/comics-downloader/releases/download/v0.33.9/comics-downloader-win-386.exe)\n- [Windows (x86-64)](https://github.com/Girbons/comics-downloader/releases/download/v0.33.9/comics-downloader-win-x86-64.exe)\n- [Linux ARM](https://github.com/Girbons/comics-downloader/releases/download/v0.33.9/comics-downloader-linux-arm)\n- [Linux ARM64](https://github.com/Girbons/comics-downloader/releases/download/v0.33.9/comics-downloader-linux-arm64)\n\nDownload the latest GUI release:\n\n- [Linux](https://github.com/Girbons/comics-downloader/releases/download/v0.33.9/comics-downloader-gui)\n- [Mac OSX](https://github.com/Girbons/comics-downloader/releases/download/v0.33.9/comics-downloader-gui-osx)\n- [Windows](https://github.com/Girbons/comics-downloader/releases/download/v0.33.9/comics-downloader-gui-windows.exe)\n\n## Usage\n\n\u003cimg src=\"img/usage.gif?raw=true\" /\u003e\n\nYou can invoke the `--help`:\n\n```\nUsage:\n  -all\n        Download all issues of the Comic or Comics\n  -country string\n        Set the country to retrieve a manga, Used by MangaDex which uses ISO 3166-1 codes\n  -create-default-path comics/[source]/[name]/\n        Using this flag your comics/issue will be downloaded without prepending the default folder structure, comics/[source]/[name]/ (default true)\n  -custom-comic-name string\n        Use a custom name for the comic output.\n  -daemon\n        Run the download as daemon\n  -daemon-timeout int\n        DaemonTimeout (seconds), specifies how often the downloader runs (default 600)\n  -debug\n    \tShows Debug log\n  -format string\n        Comic format output, supported formats are pdf,epub,cbr,cbz (default \"pdf\")\n  -force-aspect\n        Force images to A4 Portrait aspect ratio\n  -images-format\n        To use with images-only flag, choose the image format, available png,jpeg,img (default \"jpg\")\n  -images-only\n        Download comic/manga images\n  -issue-number-only\n        Force only saving with issue number instead of chapter name + issue number.\n  -last\n        Download the last Comic issue\n  -output string\n        Folder where the comics will be saved\n  -range\n        Range of issues to download, example 3-9\n  -url string\n        Comic URL or Comic URLS by separating each site with a comma without the use of spaces\n  -version\n        Display release version\n```\n\n## Options supported\n\n| Source                      | all      | country  | last     |\n| --------------------------- | -------- | -------- | -------- |\n| http://readallcomics.com    | \u0026#x2713; | \u0026#x2717; | \u0026#x2713; |\n| http://www.comicextra.com/  | \u0026#x2713; | \u0026#x2717; | \u0026#x2713; |\n| http://www.mangatown.com/   | \u0026#x2713; | \u0026#x2717; | \u0026#x2713; |\n| https://mangadex.org/       | \u0026#x2713; | \u0026#x2713; | \u0026#x2717; |\n| https://readcomiconline.li/ | \u0026#x2713; | \u0026#x2717; | \u0026#x2713; |\n| https://www.mangareader.tv/ | \u0026#x2713; | \u0026#x2717; | \u0026#x2713; |\n| https://www.mangakalot.com/ | \u0026#x2713; | \u0026#x2717; | \u0026#x2713; |\n| https://www.manganato.com/  | \u0026#x2713; | \u0026#x2717; | \u0026#x2713; |\n\n### Checking for mangas using a Raspberry Pi\n\nIf you'd like to track your favourite mangas you can use this bash [script](https://gist.github.com/nestukh/5397b836c8e5f34f6feb4ec4efe6b86a).\n\n### Multiple URLs\n\n```bash\n./comics-downloader -url=url,url2,url3\n```\n\n### Specify the format output\n\navailable formats:\n\n- pdf\n- epub\n- cbr\n- cbz\n\nDefault format is **pdf**.\n\nexample:\n\n```bash\n./comics-downloader -url=[your url] -format=epub\n```\n\n### Download the whole comic\n\nProvide the comic url and use the `-all` flag. The url provided can be any issue of the comic, or the main comic page url.\n\nexample:\n\n```bash\n./comics-downloader -url=[your url] -all\n```\n\n### Download the range of issues\n\nProvide the comic url and use the `-range` flag. The url provided can be any issue of the comic, or the main comic page url.\n\nexample:\n\n```bash\n./comics-downloader -url=[your url] -range=[start-end]\n```\n\n### Download the last comic issue\n\nTo download the last comic issue use `-last` flag.\n\n```bash\n./comics-downloader -url=[your url] -last\n```\n\n### Download to custom folder\n\nTo download to a custom folder use the `-output` flag.\nThe folder will be created if not already existing.\n\n```bash\n./comics-downloader -url=[your url] -output=[your path]\n```\n\n### Run as daemon\n\nYou can run the CLI downloader as daemon using `-daemon` flag.\nworks only if `-all` or `-last` flags are specified.\n\n```bash\n./comics-downloader -url=[your url] -daemon\n```\n\nYou can customize the daemon timeout using the `-daemon-timeout` flag.\n\n```bash\n./comics-downloader -url=[your url] -daemon -daemon-timeout=300\n```\n\n### Download Only the Images\n\nYou can download only the images using `-images-only` flag.\n\n```bash\n./comics-downloader -url=[your url] -images-only\n```\n\nTo choose the format use `-images-format` flag, the available formats are:\n\n- img\n- png\n- jpg\n\nDefault is **jpg**.\n\n```bash\n./comics-downloader -url=[your url] -images-only -images-format=jpg\n```\n\n### Avoid Default Folder Structure\n\nThe default folder structure that will be created is: `/comics/[source]/[name]/`.\nTo avoid that use `-create-default-path` flag.\n\n```bash\n./comics-downloader -url=[your url] -create-default-path=false\n```\n\n## Built With\n\n- [go](https://github.com/golang/go)\n- [gofpdf](https://github.com/jung-kurt/gofpdf)\n- [go-epub](http://github.com/bmaupin/go-epub)\n- [soup](https://github.com/anaskhan96/soup)\n- [progressbar](https://github.com/schollz/progressbar)\n- [logrus](https://github.com/sirupsen/logrus)\n- [archiver](https://github.com/mholt/archiver)\n- [regexp2](https://github.com/dlclark/regexp2)\n\n## Contributing\n\nFeel free to submit a pull request, a guide to setup the development environment is available [here](docs/dev.md)\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FGirbons%2Fcomics-downloader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FGirbons%2Fcomics-downloader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FGirbons%2Fcomics-downloader/lists"}