Skip to main content

A simple terminal CLI app

Project description

ComicFury Scraper

A powerful command-line tool to scrape and download comics from ComicFury.com, creating neatly organized CBZ files for offline reading.

Features

  • Scrape comic chapters and pages from ComicFury.com
  • Multi-threaded downloading for improved performance
  • Automatic CBZ file creation with proper ordering
  • Simple command-line interface with multiple options
  • Support for both URL and comic ID input methods
  • Configurable output directories

Installation

Prerequisites

  • Python 3.9 or higher
  • Internet connection

Dependencies

  • requests
  • beautifulsoup4
  • argparse
  • concurrent.futures (standard library)

Installing

  1. Clone this repository or download the source code:
git clone https://github.com/yourusername/ComicsInfiniteScroll.git
cd ComicsInfiniteScroll
  1. Install the required dependencies:
pip install -r requirements.txt
cd src

or download the executable at the release page

Usage

Basic Usage

Get the comic ID from the profile page

URL Bar

Then execute:

python cli.py -i COMIC_ID -d

OR

comicfuryscraper.exe -i COMIC_ID -d

Command Line Arguments

Argument Description
-u, --url URL of the webpage to scrape
-i, --id ID of the comic to scrape (alternative to URL)
-t, --max-threads Maximum number of threads to use (default: 4)
-d, --download Download the comic and create CBZ files
-o, --output Output directory for downloaded files
-v, --verbose Enable verbose output

Examples

  1. Scrape comic information without downloading:
python cli.py -i yourcomicid

This will generate a chapters.json file with all chapters and pages information.

  1. Download a comic using its ID and save to a specific folder:
python cli.py -i yourcomicid -d -o "My Comics/ComicName"
  1. Download a comic using its URL with verbose output:
python cli.py -u "https://comicfury.com/read/yourcomicid/archive" -d -v
  1. Increase download speed by using more threads:
python cli.py -i yourcomicid -d -t 8

How It Works

  1. The scraper first extracts all chapters from the comic's archive page
  2. For each chapter, it finds all pages and their image URLs
  3. When downloading, it creates a temporary directory for each chapter
  4. Images are downloaded with proper ordering (001.jpg, 002.jpg, etc.)
  5. A CBZ file is created for each chapter with numbered prefixes for proper ordering
  6. Temporary directories are cleaned up automatically

Output

Downloaded comics are saved as CBZ files in the specified output directory (or a directory named after the comic ID by default). Files are named with numerical prefixes to ensure proper ordering, for example:

01_Chapter_Name.cbz
02_Another_Chapter.cbz
etc...

Limitations

  • Only works on Comic With Infinite Scroll if comic has infinite scroll disabled, please use ComicFury-Scrape

Infinite Scroll Example

License

MIT License

Contributing

Contributions, issues, and feature requests are welcome!

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

comicfuryscraper-1.0.0.tar.gz (6.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

comicfuryscraper-1.0.0-py3-none-any.whl (7.6 kB view details)

Uploaded Python 3

File details

Details for the file comicfuryscraper-1.0.0.tar.gz.

File metadata

  • Download URL: comicfuryscraper-1.0.0.tar.gz
  • Upload date:
  • Size: 6.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for comicfuryscraper-1.0.0.tar.gz
Algorithm Hash digest
SHA256 6b5c47f00954d58c36a033c018d94b881b22ff0bd4abba49753a2613a2041008
MD5 6ee74c75f93573de9d6dab78783f152f
BLAKE2b-256 7d64e22ac82935d7d53b72fce0247fcb451d9094259fff4cbc78e281f6c73a1d

See more details on using hashes here.

File details

Details for the file comicfuryscraper-1.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for comicfuryscraper-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 98b76c93fda77b5212837bf6915fecc116b59003fb0a1f56876dfe37dd5663e8
MD5 b7cf6c31c74a1c7f595b837efc450948
BLAKE2b-256 72ba98012033d483cc1abd732e0fa59473a3284730afa4ffb439d7a41deb5fc0

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page