Skip to content

enzomtpYT/ComicFury-AutoCBZ

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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
  • Use existing JSON files for faster downloads without re-scraping

Installation

Prerequisites

  • Python 3.9 or higher
  • Internet connection

Dependencies

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

Installing

Method 1: From python code

  1. Clone this repository or download the source code:
git clone https://github.com/enzomtpYT/ComicFury-AutoCBZ.git
cd ComicsInfiniteScroll
  1. Install the required dependencies:
pip install -r requirements.txt
cd src
  1. To use you have to execute following command in terminal:
python cli.py

Method 2: From github releases

  1. Download the executable at the release page

  2. To use you have to execute following command in terminal:

comicfuryscraper.exe

Method 3: From pip install

  1. Install pip package
pip install comicfuryscraper
  1. To use you have to execute following command in terminal:
comicfuryscraper

Usage

Basic Usage

Get the comic ID from the profile page

URL Bar

Then execute (depending on how you installed it):

python cli.py -i COMIC_ID -d

OR

comicfuryscraper.exe -i COMIC_ID -d

OR

comicfuryscraper -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
-j, --json Path to a JSON file with chapter data (skips scraping)

Examples

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

This will generate a yourcomicid-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/comicprofile.php?url=yourcomicid" -d -v
  1. Increase download speed by using more threads:
python cli.py -i yourcomicid -d -t 8
  1. Use a previously generated JSON file to download without scraping:
python cli.py -j yourcomicid-chapters.json -d
  1. Download a comic using an existing JSON file and save to a specific directory:
python cli.py -j yourcomicid-chapters.json -d -o "My Comics/ComicName"

How It Works

  1. The scraper first checks if a JSON file with chapter data exists
    • If specified with -j flag, it uses that file
    • Otherwise, it looks for a default file named [comic-id]-chapters.json
  2. If no JSON file is found, it scrapes all chapters from the comic's archive page
  3. For each chapter, it finds all pages and their image URLs
  4. When downloading, it creates a temporary directory for each chapter
  5. Images are downloaded with proper ordering (001.jpg, 002.jpg, etc.)
  6. A CBZ file is created for each chapter with numbered prefixes for proper ordering
  7. 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!

About

An efficient way to scrape entire comics for ComicFury into a CBZ format for offline reading.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages