mirror of
https://github.com/Yuvi9587/Kemono-Downloader.git
synced 2025-12-29 16:14:44 +00:00
Commit
This commit is contained in:
Yuvi9587
222
readme.md
222
readme.md
@@ -1,98 +1,204 @@
|
|||||||
# Kemono Downloader v3.1.0
|
# Kemono Downloader v3.2.0
|
||||||
|
|
||||||
A feature-rich GUI application built with PyQt5 to download content from [Kemono.su](https://kemono.su) or [Coomer.party](https://coomer.party). Offers robust filtering, smart organization, manga-specific handling, and performance tuning. Now with session resuming, better retry logic, and smarter file management.
|
A feature-rich GUI application built with PyQt5 to download content from **Kemono.su** or **Coomer.party**.
|
||||||
|
Offers robust filtering, smart organization, manga-specific handling, and performance tuning.
|
||||||
|
|
||||||
|
This version introduces:
|
||||||
|
- Multi-part downloads
|
||||||
|
- Character filtering by comments
|
||||||
|
- Filename word removal
|
||||||
|
- Various UI/workflow enhancements
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🚀 What's New in v3.1.0
|
## 🚀 What's New in v3.2.0
|
||||||
|
|
||||||
* **Session Resuming**
|
### 🔹 Character Filter by Post Comments (Beta)
|
||||||
* Automatically saves and resumes incomplete downloads.
|
|
||||||
|
|
||||||
* **Retry on Failure**
|
- New "Comments" scope for the 'Filter by Character(s)' feature.
|
||||||
* Failed files auto-retry up to 3 times.
|
|
||||||
* Clear logging for each retry attempt.
|
|
||||||
|
|
||||||
* **Improved Manga Mode**
|
**How it works:**
|
||||||
* Better post ordering and handling of missing or untitled posts.
|
1. Checks if any **filenames** match your character filter. If yes → downloads the post (skips comment check).
|
||||||
* Optional numeric-only sorting for consistent naming.
|
2. If no filename matches → scans the **post's comments**. If matched → downloads the post.
|
||||||
|
|
||||||
* **UI Enhancements**
|
- Prioritizes filename-matched character name for folder naming, otherwise uses comment match.
|
||||||
* Settings persist across sessions.
|
- Cycle through filter scopes with the `Filter: [Scope]` button next to the character input.
|
||||||
* Improved layout spacing, tooltips, and status indicators.
|
|
||||||
|
|
||||||
* **Stability & Speed**
|
---
|
||||||
* Faster post fetching with lower memory usage.
|
|
||||||
* Minor bug fixes (duplicate folders, empty post crashes).
|
### ✂️ Remove Specific Words from Filenames
|
||||||
|
|
||||||
|
- Input field: `"✂️ Remove Words from name"`
|
||||||
|
- Enter comma-separated words (e.g., `patreon, kemono, [HD], _final`)
|
||||||
|
- These are removed from filenames (case-insensitive) to improve organization.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 🧩 Multi-part Downloads for Large Files
|
||||||
|
|
||||||
|
- Toggle multi-part downloads (OFF by default).
|
||||||
|
- Improves speed on large files (e.g., >10MB videos, zips).
|
||||||
|
- Falls back to single-stream on failure.
|
||||||
|
- Toggle via `Multi-part: ON/OFF` in the log header.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 🧠 UI and Workflow Enhancements
|
||||||
|
|
||||||
|
- **Updated Welcome Tour**
|
||||||
|
Shows on first launch, covers all new and core features.
|
||||||
|
|
||||||
|
- **Smarter Cancel/Reset**
|
||||||
|
Cancels active tasks and resets UI — but retains URL and Download Directory fields.
|
||||||
|
|
||||||
|
- **Simplified Interface**
|
||||||
|
- Removed "Skip Current File" and local API server for a cleaner experience.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 📁 Refined File & Duplicate Handling
|
||||||
|
|
||||||
|
- **Duplicate Filenames**
|
||||||
|
Adds numeric suffix (`file.jpg`, `file_1.jpg`, etc.).
|
||||||
|
Removed the "Duplicate" subfolder system.
|
||||||
|
|
||||||
|
- **Efficient Hash Check**
|
||||||
|
Detects and skips duplicate files within the same session (before writing to disk).
|
||||||
|
|
||||||
|
- **Better Temp File Cleanup**
|
||||||
|
Cleans up `.part` files — especially if duplicate or compressed post-download.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🧩 Core Features
|
## 🧩 Core Features
|
||||||
|
|
||||||
* **Simple GUI**
|
### 🎛 Simple GUI
|
||||||
Built with PyQt5 for a clean, responsive experience.
|
- Built with **PyQt5**
|
||||||
|
- Dark theme, responsive layout
|
||||||
|
|
||||||
* **Supports Both Post and Creator URLs**
|
### 📥 Supports Post and Creator URLs
|
||||||
Download a single post or an entire feed with one click.
|
- Download a single post or an entire creator’s feed.
|
||||||
|
|
||||||
* **Smart Folder System**
|
### 🔢 Page Range Support
|
||||||
Organize files using post titles, known character/show names, or a folder per post.
|
- Choose page range when downloading creator feeds (except in Manga Mode).
|
||||||
Detects and auto-names folders based on custom keywords.
|
|
||||||
|
|
||||||
* **Known Names Manager**
|
---
|
||||||
Add, search, and delete tags for smarter organization.
|
|
||||||
Saved to `Known.txt` for reuse.
|
|
||||||
|
|
||||||
* **Advanced Filters**
|
### 🗂 Smart Folder System
|
||||||
* Skip posts or files with specific keywords (e.g. `WIP`, `sketch`).
|
|
||||||
* Filter by media type: images, videos, or GIFs.
|
|
||||||
* Skip `.zip` and `.rar` archives.
|
|
||||||
|
|
||||||
* **Manga Mode**
|
- Organize by character names, post titles, or custom labels.
|
||||||
Rename and sort manga posts by title and upload order.
|
- Option to create a separate folder for each post.
|
||||||
Handles one-image-per-post formats cleanly.
|
- Uses `Known.txt` for fallback names.
|
||||||
|
|
||||||
* **Image Compression**
|
---
|
||||||
Auto-convert large images (>1.5MB) to WebP (requires Pillow).
|
|
||||||
|
|
||||||
* **Multithreaded Downloads**
|
### 📚 Known Names Manager
|
||||||
Adjustable worker count with warnings at unsafe levels.
|
|
||||||
Full threading for creators, single-thread fallback for post mode.
|
|
||||||
|
|
||||||
* **Download Controls**
|
- Add/edit/delete known characters/shows
|
||||||
Cancel files mid-download.
|
- Saves entries in `Known.txt` for automatic folder naming.
|
||||||
Visual progress tracking with per-post summaries.
|
|
||||||
|
|
||||||
* **Dark Mode**
|
---
|
||||||
Clean and modern dark-themed interface.
|
|
||||||
|
### 🔍 Advanced Filtering
|
||||||
|
|
||||||
|
- **Filter by Character(s)**
|
||||||
|
Scope: `Files`, `Post Titles`, `Both`, or `Post Comments (Beta)`
|
||||||
|
|
||||||
|
- **Skip with Words**
|
||||||
|
Skip posts or files based on keywords. Toggle scope.
|
||||||
|
|
||||||
|
- **Media Type Filters**
|
||||||
|
Choose: `All`, `Images/GIFs`, `Videos`, `📦 Only Archives (.zip/.rar)`
|
||||||
|
|
||||||
|
- **🔗 Only Links Mode**
|
||||||
|
Extracts links from post descriptions.
|
||||||
|
|
||||||
|
- **Skip Archives**
|
||||||
|
Ignore `.zip`/`.rar` unless in "Only Archives" mode.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 📖 Manga/Comic Mode (Creator URLs Only)
|
||||||
|
|
||||||
|
- Downloads posts oldest-to-newest.
|
||||||
|
|
||||||
|
**Filename Style Toggle:**
|
||||||
|
- `Post Title` (default): Names first file in post after title.
|
||||||
|
- `Original File`: Uses original file names.
|
||||||
|
|
||||||
|
- Uses manga/series title for filtering and folder naming.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 🖼️ Image Compression
|
||||||
|
|
||||||
|
- Converts large images to **WebP** if it significantly reduces size.
|
||||||
|
- Requires `Pillow` library.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 🖼 Download Thumbnails Only
|
||||||
|
|
||||||
|
- Option to fetch only small preview images.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### ⚙️ Multithreaded Downloads
|
||||||
|
|
||||||
|
- Adjustable threads for:
|
||||||
|
- Multiple post processing (creator feeds)
|
||||||
|
- File-level concurrency (within a post)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### ⏯ Download Controls
|
||||||
|
|
||||||
|
- Start and cancel active operations.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 🌙 Dark Mode Interface
|
||||||
|
|
||||||
|
- Modern, dark-themed GUI for comfort and clarity.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🔧 Backend Enhancements
|
## 🔧 Backend Enhancements
|
||||||
|
|
||||||
* **Retry Logic**
|
### ♻️ Retry Logic
|
||||||
Auto-retries individual failed files before skipping.
|
|
||||||
Logs all failures with HTTP codes and reasons.
|
|
||||||
|
|
||||||
* **Hash-Based Deduplication**
|
- Retries failed file and chunk downloads before skipping.
|
||||||
Prevents redownloading of previously saved files.
|
|
||||||
|
|
||||||
* **Smart Naming**
|
---
|
||||||
Cleans and standardizes inconsistent post titles.
|
|
||||||
Adds page indices for manga.
|
|
||||||
|
|
||||||
* **Efficient Logging**
|
### 🧬 Session-wide Deduplication
|
||||||
Toggle between basic and advanced views.
|
|
||||||
Live feedback with color-coded logs.
|
- Uses **MD5 hashes** to avoid saving identical files during a session.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 🧹 Smart Naming & Cleanup
|
||||||
|
|
||||||
|
- Cleans special characters in names.
|
||||||
|
- Applies numeric suffixes on collision.
|
||||||
|
- Removes specified unwanted words.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 📋 Efficient Logging
|
||||||
|
|
||||||
|
- Toggle verbosity: `Basic` (important) or `Full` (everything).
|
||||||
|
- Separate panel for extracted external links.
|
||||||
|
- Real-time feedback with clear statuses.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 📦 Installation
|
## 📦 Installation
|
||||||
|
|
||||||
### Requirements
|
### Requirements
|
||||||
|
- Python 3.6+
|
||||||
|
- Pip (Python package manager)
|
||||||
|
|
||||||
* Python 3.6+
|
### Install Libraries
|
||||||
* Pip packages:
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
pip install PyQt5 requests Pillow
|
pip install PyQt5 requests Pillow
|
||||||
|
|||||||
Reference in New Issue
Block a user