Kemono Downloader

Default	Favorite Mode
Single Post	Manga/Comic Mode

---

A powerful, feature-rich GUI application for downloading content from Kemono.su (and its mirrors like kemono.party) and Coomer.party (and its mirrors like coomer.su).

Built with PyQt5, this tool is designed for users who want deep filtering capabilities, customizable folder structures, efficient downloads, and intelligent automation — all within a modern and user-friendly graphical interface.

Core Capabilities Overview

High-Performance Downloading

• Multi-threading: Processes multiple posts simultaneously to greatly accelerate downloads from large creator profiles.
• Multi-part Downloading: Splits large files into chunks and downloads them in parallel to maximize speed.
• Resilience: Supports pausing, resuming, and restoring downloads after crashes or interruptions.

Advanced Filtering & Content Control

• Content Type Filtering: Select whether to download all files or limit to images, videos, audio, or archives only.
• Keyword Skipping: Automatically skips posts or files containing certain keywords (e.g., "WIP", "sketch").
• Character Filtering: Restricts downloads to posts that match specific character or series names.

File Organization & Renaming

• Automated Subfolders: Automatically organizes downloaded files into subdirectories based on character names or per post.
• Advanced File Renaming: Flexible renaming options, especially in Manga Mode, including:
  • Post Title: Uses the post's title (e.g., Chapter-One.jpg).
  • Date + Original Name: Prepends the publication date to the original filename.
  • Date + Title: Combines the date with the post title.
  • Sequential Numbering (Date Based): Simple sequence numbers (e.g., 001.jpg, 002.jpg).
  • Title + Global Numbering: Uses post title with a globally incrementing number across the session.
  • Post ID: Names files using the post’s unique ID.

Specialized Modes

• Manga/Comic Mode: Sorts posts chronologically before downloading to ensure pages appear in the correct sequence.
• Favorite Mode: Connects to your account and downloads from your favorites list (artists or posts).
• Link Extraction Mode: Extracts external links from posts for export or targeted downloading.
• Text Extraction Mode: Saves post descriptions or comment sections as PDF, DOCX, or TXT files.

Utility & Advanced Features

• Cookie Support: Enables access to subscriber-only content via browser session cookies.
• Duplicate Detection: Prevents saving duplicate files using content-based comparison, with configurable limits.
• Image Compression: Automatically converts large images to .webp to reduce disk usage.
• Creator Management: Built-in creator browser and update checker for downloading only new posts from saved profiles.
• Error Handling: Tracks failed downloads and provides a retry dialog with options to export or redownload missing files.

💻 Installation

Requirements

• Python 3.6 or higher
• pip (Python package installer)

Install Dependencies

pip install PyQt5 requests Pillow mega.py fpdf2 python-docx

Running the Application

Navigate to the application's directory in your terminal and run:

python main.py

Optional Setup

• Main Inputs:
• Place your cookies.txt in the root directory (if using cookies).
• Prepare your Known.txt and creators.json in the same directory for advanced filtering and selection features.

---

Troubleshooting

AttributeError: module 'asyncio' has no attribute 'coroutine'

If you encounter an error message similar to:

AttributeError: module 'asyncio' has no attribute 'coroutine'. Did you mean: 'coroutines'?

This usually means that a dependency, often tenacity (used by mega.py), is an older version that's incompatible with your Python version (typically Python 3.10+).

To fix this, activate your virtual environment and run the following commands to upgrade the libraries:

pip install --upgrade tenacity
pip install --upgrade mega.py

---

Contribution

Feel free to fork this repo and submit pull requests for bug fixes, new features, or UI improvements!

---

License

This project is under the MIT Licence

Star History