Malin/Kemono-Downloader
1
0
Fork 0
mirror of https://github.com/Yuvi9587/Kemono-Downloader.git synced 2025-12-29 16:14:44 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update readme.md

Browse Source
This commit is contained in:
Yuvi9587
2025-07-11 01:26:57 -07:00
parent 404c4ca59a
commit 4f383910d2
1 changed files with 94 additions and 80 deletions
Download Patch File Download Diff File Expand all files Collapse all files

174
readme.md
View File

@@ -1,124 +1,138 @@
<h1 align="center">Kemono Downloader v5.6.0</h1> <h1 align="center">Kemono Downloader v6.0.0</h1>
<table align="center"> <div align="center">
<table>
<tr> <tr>
<td align="center"> <td align="center">
<img src="Read/Read.png" alt="Default Mode" width="400"/><br> <img src="Read/Read.png" alt="Default Mode" width="400"><br>
<strong>Default</strong> <strong>Default</strong>
</td> </td>
<td align="center"> <td align="center">
<img src="Read/Read1.png" alt="Favorite Mode" width="400"/><br> <img src="Read/Read1.png" alt="Favorite Mode" width="400"><br>
<strong>Favorite mode</strong> <strong>Favorite Mode</strong>
</td> </td>
</tr> </tr>
<tr> <tr>
<td align="center"> <td align="center">
<img src="Read/Read2.png" alt="Single Post" width="400"/><br> <img src="Read/Read2.png" alt="Single Post" width="400"><br>
<strong>Single Post</strong> <strong>Single Post</strong>
</td> </td>
<td align="center"> <td align="center">
<img src="Read/Read3.png" alt="Manga/Comic Mode" width="400"/><br> <img src="Read/Read3.png" alt="Manga/Comic Mode" width="400"><br>
<strong>Manga/Comic Mode</strong> <strong>Manga/Comic Mode</strong>
</td> </td>
</tr> </tr>
</table> </table>
</div>
--- ---
A powerful, feature-rich GUI application for downloading content from **[Kemono.su](https://kemono.su)** (and its mirrors like kemono.party) and **[Coomer.party](https://coomer.party)** (and its mirrors like coomer.su). A powerful, feature-rich GUI application for downloading content from **[Kemono.su](https://kemono.su)** (and its mirrors like kemono.party) and **[Coomer.party](https://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.
*This v5.0.0 release marks a significant feature milestone. Future updates are expected to be less frequent, focusing on maintenance and minor refinements.* 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.
*Update v5.2.0 introduces multi-language support, theme selection, and further UI refinements.*
<p align="center"> <div align="center">
<a href="features.md">
<img alt="Features" src="https://img.shields.io/badge/📚%20Full%20Feature%20List-FFD700?style=for-the-badge&logoColor=black&color=FFD700"> [![](https://img.shields.io/badge/Full_Feature_List-FFD700?style=for-the-badge&logoColor=black&color=FFD700)](features.md)
</a> [![](https://img.shields.io/badge/License-90EE90?style=for-the-badge&logoColor=black&color=90EE90)](LICENSE)
<a href="LICENSE"> [![](https://img.shields.io/badge/Important_Note-FFCCCB?style=for-the-badge&logoColor=black&color=FFCCCB)](note.md)
<img alt="License" src="https://img.shields.io/badge/📝%20License-90EE90?style=for-the-badge&logoColor=black&color=90EE90">
</a> </div>
<a href="note.md">
<img alt="Note" src="https://img.shields.io/badge/⚠️%20Important%20Note-FFCCCB?style=for-the-badge&logoColor=black&color=FFCCCB">
</a>
</p>
--- ---
## Feature Overview ## 🚀 Feature Overview
Kemono Downloader offers a range of features to streamline your content downloading experience: Kemono Downloader offers a wide range of features to streamline your content downloading experience:
- **User-Friendly Interface:** A modern PyQt5 GUI for easy navigation and operation. ### 🎛️ User-Friendly Interface
- **Flexible Downloading:** - Built with PyQt5 for a modern and intuitive experience.
- Download content from Kemono.su (and mirrors) and Coomer.party (and mirrors).
- Supports creator pages (with page range selection) and individual post URLs. ### 📥 Flexible Downloading
- Standard download controls: Start, Pause, Resume, and Cancel. - Download from Kemono.su and Coomer.party (and their mirrors).
- **Powerful Filtering:** - Supports full creator pages and individual post URLs.
- **Character Filtering:** Filter content by character names. Supports simple comma-separated names and grouped names for shared folders. - Standard download controls: Start, Pause, Resume, Cancel.
- **Keyword Skipping:** Skip posts or files based on specified keywords.
- **Filename Cleaning:** Remove unwanted words or phrases from downloaded filenames. ### 🔎 Powerful Filtering
- **File Type Selection:** Choose to download all files, or limit to images/GIFs, videos, audio, or archives. Can also extract external links only. - **Character Filtering**: Filter by comma-separated or grouped character names.
- **Customizable Downloads:** - **Keyword Skipping**: Skip posts/files by keywords.
- **Thumbnails Only:** Option to download only small preview images. - **Filename Cleaning**: Clean downloaded filenames.
- **Content Scanning:** Scan post HTML for `<img>` tags and direct image links, useful for images embedded in descriptions. - **File Type Selection**: Choose all, images, videos, audio, archives, or external links only.
- **WebP Conversion:** Convert images to WebP format for smaller file sizes (requires Pillow library).
- **Organized Output:** ### 📁 Customizable Downloads
- **Automatic Subfolders:** Create subfolders based on character names (from filters or `Known.txt`) or post titles. - **Thumbnails Only**: Download preview images only.
- **Per-Post Subfolders:** Option to create an additional subfolder for each individual post. - **Content Scanning**: Finds `<img>` tags and image links in HTML.
- **Manga/Comic Mode:** - **WebP Conversion**: Convert images to WebP (requires Pillow).
- Downloads posts from a creator's feed in chronological order (oldest to newest).
- Offers various filename styling options for sequential reading (e.g., post title, original name, global numbering). ### 🗂 Organized Output
- **⭐ Favorite Mode:** - **Subfolders by Character or Post Title**
- Directly download from your favorited artists and posts on Kemono.su. - **Per-Post Subfolders**: Optional for better organization.
- Requires a valid cookie and adapts the UI for easy selection from your favorites.
- Supports downloading into a single location or artist-specific subfolders. ### 📚 Manga/Comic Mode
- **Performance & Advanced Options:** - Downloads posts chronologically.
- **Cookie Support:** Use cookies (paste string or load from `cookies.txt`) to access restricted content. - Various filename styles for reading convenience.
- **Multithreading:** Configure the number of simultaneous downloads/post processing threads for improved speed.
- **Logging:** ### ⭐ Favorite Mode
- A detailed progress log displays download activity, errors, and summaries. - Download from your favorited artists and posts.
- **Multi-language Interface:** Choose from several languages for the UI (English, Japanese, French, Spanish, German, Russian, Korean, Chinese Simplified). - Requires a valid cookie.
- **Theme Customization:** Selectable Light and Dark themes for user comfort. - Supports global or per-artist subfolders.
### ⚙️ Performance & Advanced Options
- **Cookie Support**: Paste string or use `cookies.txt`.
- **Multithreading**: Configure threads for speed.
### 🧾 Logging
- Detailed logs of download activity, errors, and status.
### 🌐 Multi-language Support
- UI in English, Japanese, French, Spanish, German, Russian, Korean, Chinese (Simplified).
### 🎨 Theme Customization
- Light and Dark themes available.
--- ---
## ✨ What's New in v5.3.0 ## ✨ What's New in v6.0.0
- **Multi-Creator Post Fetching & Queuing:**
- The **Creator Selection popup** (🎨 icon) has been significantly enhanced. ### 🔔 New Features
- After selecting multiple creators, you can now click a new "**Fetch Posts**" button.
- This will retrieve and display posts from all selected creators in a new view within the popup. - **Live Error Count**: Error button shows live count like `(3) Error`.
- You can then browse these fetched posts (with search functionality) and select individual posts. - **Date Prefix for Subfolders**: Adds upload date to subfolder names (e.g. `2025-07-11 Post Title`).
- A new "**Add Selected Posts to Queue**" button allows you to add your chosen posts directly to the main download queue, streamlining the process of gathering content from multiple artists. - **Keep Duplicates**: Save all files in a post, even with duplicate names (adds `_1`, `_2`, etc.).
- The traditional "**Add Selected to URL**" button is still available if you prefer to populate the main URL field with creator names.
- **Improved Favorite Download Queue Handling:** ### 🐞 Bug Fixes & Improvements
- When items are added to the download queue from the Creator Selection popup, the main URL input field will now display a placeholder message (e.g., "{count} items in queue from popup").
- The queue is now more robustly managed, especially when interacting with the main URL input field after items have been queued from the popup. - `.part` files now correctly renamed after completion.
- Failed files list is saved/restored with sessions.
- Download location now remembered after clicking "Reset".
- "Cancel" is available on session restore.
- Cleaner final download log.
--- ---
## ✨ What's New in v5.1.0 ## 🛠️ Planned for v6.1.0
- **Enhanced Error File Management**: The "Error" button now opens a dialog listing files that failed to download. This dialog includes:
- An option to **retry selected** failed downloads.
- A new **"Export URLs to .txt"** button, allowing users to save links of failed downloads either as "URL only" or "URL with details" (including post title, ID, and original filename).
- Fixed a bug where files skipped during retry (due to existing hash match) were not correctly removed from the error list.
- **Improved UI Stability**: Addressed issues with UI state management to more accurately reflect ongoing download activities (including retries and external link downloads). This prevents the "Cancel" button from becoming inactive prematurely while operations are still running.
## ✨ What's New in v5.2.0 ### 🔖 Tag Filtering
- **Multi-language Support:** The interface now supports multiple languages: English, Japanese, French, Spanish, German, Russian, Korean, and Chinese (Simplified). Select your preferred language in the new Settings dialog. - Filter posts by **tags**.
- **Theme Selection:** Choose between Light and Dark application themes via the Settings dialog for a personalized viewing experience. - Combine with existing filters.
- **Centralized Settings:** A new Settings dialog (accessible via a settings button, often with a gear icon) provides a dedicated space for language and appearance customizations. - Use tag presets for repeatable workflows.
- **Internal Localization:** Introduced `languages.py` for managing UI translations, streamlining the addition of new languages by contributors.
### 📁 Creator Download History
- Save a `.json` with already-downloaded posts.
- Skip previously downloaded posts automatically.
--- ---
## Installation ## 📦 Installation
### Requirements ### Requirements
- Python 3.6 or higher
- pip (Python package installer) - Python 3.6 or newer
- `pip` (Python package installer)
### Install Dependencies ### Install Dependencies
Open your terminal or command prompt and run:
```bash ```bash
pip install PyQt5 requests Pillow mega.py pip install PyQt5 requests Pillow mega.py