mirror of
https://github.com/Yuvi9587/Kemono-Downloader.git
synced 2025-12-29 16:14:44 +00:00
100 lines
2.8 KiB
Markdown
100 lines
2.8 KiB
Markdown
# Kemono Downloader v3.1.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.
|
|
|
|
---
|
|
|
|
## 🚀 What's New in v3.1.0
|
|
|
|
* **Session Resuming**
|
|
* Automatically saves and resumes incomplete downloads.
|
|
|
|
* **Retry on Failure**
|
|
* Failed files auto-retry up to 3 times.
|
|
* Clear logging for each retry attempt.
|
|
|
|
* **Improved Manga Mode**
|
|
* Better post ordering and handling of missing or untitled posts.
|
|
* Optional numeric-only sorting for consistent naming.
|
|
|
|
* **UI Enhancements**
|
|
* Settings persist across sessions.
|
|
* Improved layout spacing, tooltips, and status indicators.
|
|
|
|
* **Stability & Speed**
|
|
* Faster post fetching with lower memory usage.
|
|
* Minor bug fixes (duplicate folders, empty post crashes).
|
|
|
|
---
|
|
|
|
## 🧩 Core Features
|
|
|
|
* **Simple GUI**
|
|
Built with PyQt5 for a clean, responsive experience.
|
|
|
|
* **Supports Both Post and Creator URLs**
|
|
Download a single post or an entire feed with one click.
|
|
|
|
* **Smart Folder System**
|
|
Organize files using post titles, known character/show names, or a folder per post.
|
|
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**
|
|
* 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**
|
|
Rename and sort manga posts by title and upload order.
|
|
Handles one-image-per-post formats cleanly.
|
|
|
|
* **Image Compression**
|
|
Auto-convert large images (>1.5MB) to WebP (requires Pillow).
|
|
|
|
* **Multithreaded Downloads**
|
|
Adjustable worker count with warnings at unsafe levels.
|
|
Full threading for creators, single-thread fallback for post mode.
|
|
|
|
* **Download Controls**
|
|
Cancel files mid-download.
|
|
Visual progress tracking with per-post summaries.
|
|
|
|
* **Dark Mode**
|
|
Clean and modern dark-themed interface.
|
|
|
|
---
|
|
|
|
## 🔧 Backend Enhancements
|
|
|
|
* **Retry Logic**
|
|
Auto-retries individual failed files before skipping.
|
|
Logs all failures with HTTP codes and reasons.
|
|
|
|
* **Hash-Based Deduplication**
|
|
Prevents redownloading of previously saved files.
|
|
|
|
* **Smart Naming**
|
|
Cleans and standardizes inconsistent post titles.
|
|
Adds page indices for manga.
|
|
|
|
* **Efficient Logging**
|
|
Toggle between basic and advanced views.
|
|
Live feedback with color-coded logs.
|
|
|
|
---
|
|
|
|
## 📦 Installation
|
|
|
|
### Requirements
|
|
|
|
* Python 3.6+
|
|
* Pip packages:
|
|
|
|
```bash
|
|
pip install PyQt5 requests Pillow
|
|
|