Kemono-Downloader/readme.md

Kemono Downloader v3.1.0

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. 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:

pip install PyQt5 requests Pillow