{"id":29436958,"url":"https://github.com/norkzyt/comic-downloader","last_synced_at":"2025-07-13T05:41:28.652Z","repository":{"id":286540648,"uuid":"954919928","full_name":"NorkzYT/comic-downloader","owner":"NorkzYT","description":"Fast, reliable, and easy-to-use CLI tool for downloading comics (manga, manhwa, and more) from popular websites.","archived":false,"fork":false,"pushed_at":"2025-07-11T06:30:14.000Z","size":23893,"stargazers_count":5,"open_issues_count":3,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-11T10:19:01.195Z","etag":null,"topics":["cli","comic-downloader","comics","downloader","linux","macos","manga","manga-downloader","manhwa","reading","windows"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NorkzYT.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"NorkzYT","custom":["https://paypal.me/PolymathNorkz"]}},"created_at":"2025-03-25T20:25:41.000Z","updated_at":"2025-06-05T17:11:12.000Z","dependencies_parsed_at":"2025-07-11T08:24:34.884Z","dependency_job_id":"5258c5c6-a56a-42b0-90b5-c12bf62cee8e","html_url":"https://github.com/NorkzYT/comic-downloader","commit_stats":null,"previous_names":["norkzyt/comic-downloader"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/NorkzYT/comic-downloader","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NorkzYT%2Fcomic-downloader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NorkzYT%2Fcomic-downloader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NorkzYT%2Fcomic-downloader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NorkzYT%2Fcomic-downloader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NorkzYT","download_url":"https://codeload.github.com/NorkzYT/comic-downloader/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NorkzYT%2Fcomic-downloader/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265096706,"owners_count":23710778,"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":["cli","comic-downloader","comics","downloader","linux","macos","manga","manga-downloader","manhwa","reading","windows"],"created_at":"2025-07-13T05:41:22.135Z","updated_at":"2025-07-13T05:41:28.644Z","avatar_url":"https://github.com/NorkzYT.png","language":"Go","funding_links":["https://github.com/sponsors/NorkzYT","https://paypal.me/PolymathNorkz"],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/NorkzYT/comic-downloader/refs/heads/main/docs/content/assets/img/comic-downloader-cover-rl.png\" width=\"490\" alt=\"Comic Downloader\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  Fast, reliable, and easy-to-use CLI tool for downloading comics (manga, manhwa, and more) from popular websites.\n\u003c/p\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003c!-- Contributions Welcome --\u003e\n  \u003ca href=\"CODE_OF_CONDUCT.md\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/contributions-welcome-brightgreen?logo=github\" alt=\"Contributions Welcome\"\u003e\n  \u003c/a\u003e\n  \u003c!-- Commits per Month --\u003e\n  \u003ca href=\"https://github.com/NorkzYT/comic-downloader/pulse\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/commit-activity/m/NorkzYT/comic-downloader\" alt=\"Commits per Month\"\u003e\n  \u003c/a\u003e\n  \u003c!-- License --\u003e\n  \u003ca href=\"https://github.com/NorkzYT/comic-downloader/blob/main/LICENSE\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/license-GNUv3-purple\" alt=\"License\"\u003e\n  \u003c/a\u003e\n  \u003c!-- Contributor Covenant --\u003e\n  \u003ca href=\"https://contributor-covenant.org/version/2/1/code_of_conduct/\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Contributor%20Covenant-2.1-purple\" alt=\"Contributor Covenant 2.1\"\u003e\n  \u003c/a\u003e\n  \u003c!-- GitHub Stars --\u003e\n  \u003ca href=\"https://github.com/NorkzYT/comic-downloader/stargazers\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/stars/NorkzYT/comic-downloader\" alt=\"GitHub Stars\"\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n## 📚 Table of Contents\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eExpand Table of Contents\u003c/strong\u003e\u003c/summary\u003e\n\n- [Supported Websites](#-supported-websites)\n- [Installation](#-installation)\n  - [Linux \u0026 macOS](#linux--macos)\n  - [Windows](#%EF%B8%8F-windows)\n  - [Docker](#-docker)\n- [Usage](#-usage)\n  - [Basic Usage](#basic-usage)\n  - [Chapter Range](#chapter-range)\n  - [Language Selection](#language-selection)\n  - [Bundling Chapters](#bundling-chapters)\n  - [Help](#help)\n- [Troubleshooting](#%EF%B8%8F-troubleshooting)\n- [Contribution](#-contribution)\n- [Star History](#-star-history)\n\n\u003c/details\u003e\n\n\u003cp\u003e\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/NorkzYT/comic-downloader/refs/heads/main/demos/prompt.gif\" alt=\"prompt img\"\u003e\n\u003c/p\u003e\n\n## 🌐 Supported Websites\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eExpand Supported Websites\u003c/strong\u003e\u003c/summary\u003e\n\nCurrently, comic-downloader supports the following websites:\n\n- [Asura Scans](https://asuracomic.net)\n- [CypherScans](https://cypheroscans.xyz)\n- [InManga](https://inmanga.com)\n- [KappaBeast](https://kappabeast.com)\n- [Mangabuddy](https://mangabuddy.com)\n- [MangaDex](https://mangadex.org)\n- [MangaMonk](https://mangamonk.com)\n- [MangaWorldNZ](https://www.mangaworld.nz)\n- [ReaperScans](https://reaperscans.com)\n- [Toongod](https://toongod.org)\n- [ToonClash](https://toonclash.com)\n- [Zonatmo](https://zonatmo.com)\n\nIf a site you use isn't listed, please [open an issue](https://github.com/NorkzYT/comic-downloader/issues) or contribute directly via pull request.\n\n\u003c/details\u003e\n\n## 🚀 Installation\n\n### Linux \u0026 macOS\n\n1. Download the latest binary from the [Releases page](https://github.com/NorkzYT/comic-downloader/releases).\n2. Extract the downloaded archive.\n3. Move the binary into a directory within your system's `PATH`:\n\n```bash\nsudo mv comic-downloader /usr/local/bin/\n```\n\nOr create Symbolic Link. This way, if you rebuild the binary, the link will still point to the updated file.\n\n```bash\nsudo ln -s comic-downloader /usr/local/bin/comic-downloader\n```\n\n#### macOS Users\n\nTo bypass the Gatekeeper security prompt, run:\n\n```bash\nsudo spctl --master-disable\n```\n\n### 🖥️ Windows\n\n1. Download the latest `.exe` from [Releases](https://github.com/NorkzYT/comic-downloader/releases).\n2. Place the `.exe` in a directory in your system's `PATH` (e.g., `C:\\Windows\\System32`).\n\nRun via Command Prompt:\n\n```cmd\ncomic-downloader [URL] [range]\n```\n\n### 🐳 Docker\n\nBefore running **comic‑downloader** (whether you use the local CLI or the Docker image), you must start your Browserless \u0026 Tenshi containers:\n\n```bash\nmake up\n```\n\n#### comic-downloader Container\n\nRrun comic-downloader via Docker Compose with:\n\n```bash\ndocker compose -f docker/containers/comic-downloader/docker-compose.yml up -d --force-recreate\n```\n\n\u003e **Note:** Downloads will be saved in your current working directory.\n\n## 🔧 Environment Setup\n\n1. Copy the example file:\n\n   ```bash\n   cp .env.example .env\n   ```\n\n2. Open `.env` and fill in each value (the example is below). At minimum you need:\n\n   ```dotenv\n   # Enable compose bake (optional)\n   COMPOSE_BAKE=true\n\n   # Tenshi (FastAPI) container credentials\n   TENSHI_PASSWORD='tenshi'\n   TENSHI_VNC_PASSWORD='xxx'\n\n   # Browserless (Chromium) settings\n   BROWSERLESS_HOST_IP='xxx.xxx.xxx.xx'\n   BROWSERLESS_TOKEN='your_token_here'\n   REMOTE_DEBUG_URL='http://localhost:6082'\n   FASTAPI_BASE_URL='http://localhost:6081'\n\n   # Toggle Docker mode and debug logs\n   DOCKER=false\n   DEBUG=false\n   ```\n\n3. Make sure those containers are up:\n\n   ```bash\n   make up\n   ```\n\n\u003e **Important:** If **Browserless** (port 8454 or 3000 in Docker) or **Tenshi** (port 6081) aren’t reachable, **comic-downloader** will refuse to start.\n\nIf you're running locally, the application will connect to:\n\n```\nws://${BROWSERLESS_HOST_IP}:8454?token=${BROWSERLESS_TOKEN}\n```\n\nIf you're running under Docker (i.e. `DOCKER=true`), it will connect to:\n\n```\nws://comic-downloader-browserless:3000?token=${BROWSERLESS_TOKEN}\n```\n\n\u003e **Note:** Make sure your `.env` file is correctly configured; otherwise, comic-downloader will not be able to establish a connection with Browserless.\n\n## 💻 Usage\n\n### Basic Usage\n\nInteractive download of all chapters:\n\n```bash\ncomic-downloader [URL]\n```\n\n\u003cp\u003e\u003c/p\u003e\n\u003cp align=\"\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/NorkzYT/comic-downloader/refs/heads/main/demos/download.gif?raw=true\" alt=\"download img\"\u003e\n\u003c/p\u003e\n\nThe URL must be the series' main page.\n\n### Chapter Range\n\nSpecify specific chapters or ranges:\n\n```bash\ncomic-downloader [URL] 1-50\n```\n\n### Language Selection\n\nExplicitly select a language:\n\n```bash\ncomic-downloader [URL] 1-10 --language en\n```\n\n### Bundling Chapters\n\nCombine chapters into a single `.cbz` file:\n\n```bash\ncomic-downloader [URL] 1-2 --bundle\n```\n\n\u003cp\u003e\u003c/p\u003e\n\u003cp align=\"\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/NorkzYT/comic-downloader/refs/heads/main/demos/bundle.gif?raw=true\" alt=\"bundle img\"\u003e\n\u003c/p\u003e\n\n### Help\n\nView all commands and options:\n\n```bash\ncomic-downloader help\n```\n\n\u003cp\u003e\u003c/p\u003e\n\u003cp align=\"\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/NorkzYT/comic-downloader/refs/heads/main/demos/help.gif?raw=true\" alt=\"help img\"\u003e\n\u003c/p\u003e\n\n## 🛠️ Troubleshooting\n\n- **\"Command not recognized\":** Verify the binary is in a PATH-accessible location.\n- **macOS unsigned binary error:** Run `sudo spctl --master-disable`.\n\n## 🤝 Contribution\n\nContributions, issues, and pull requests are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n## 📈 Star History\n\n\u003ca href=\"https://star-history.com/#NorkzYT/comic-downloader\"\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/svg?repos=NorkzYT/comic-downloader\u0026type=Date\u0026theme=dark\"\u003e\n    \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/svg?repos=NorkzYT/comic-downloader\u0026type=Date\"\u003e\n    \u003cimg alt=\"Star History Chart\" src=\"https://api.star-history.com/svg?repos=NorkzYT/comic-downloader\u0026type=Date\"\u003e\n  \u003c/picture\u003e\n\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnorkzyt%2Fcomic-downloader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnorkzyt%2Fcomic-downloader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnorkzyt%2Fcomic-downloader/lists"}