Kemono-Downloader/readme.md

# 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