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

Commit

Browse Source
This commit is contained in:
Yuvi9587
2025-05-10 11:11:35 +05:30
parent aec44f1782
commit 8982026d79
1 changed files with 64 additions and 109 deletions
Download Patch File Download Diff File Expand all files Collapse all files

173
readme.md
View File

@@ -1,150 +1,105 @@
# Kemono Downloader v3.0.0
# 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) pages. It offers a wide array of filtering, organizing, and performance-tuning options including manga-specific handling, content deduplication, thread control, and smart folder creation.
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.0.0
## 🚀 What's New in v3.1.0
* **Manga Mode**: Smart file renaming based on post titles and upload sequence; handles single-image-per-post manga.
* **Enhanced Logging**:
* **Session Resuming**
* Automatically saves and resumes incomplete downloads.
* Toggle between **Basic** and **Advanced** views.
* Live log resizing and improved readability.
* **Dynamic Thread Control**:
* **Retry on Failure**
* Failed files auto-retry up to 3 times.
* Clear logging for each retry attempt.
* Adjustable worker thread count.
* Warnings and auto-caps on high thread values to prevent system slowdown or site rate-limiting.
* **Advanced Skip Filters**:
* **Batch URL Import**
* Load multiple creator or post URLs from a `.txt` file.
* Skip posts/files based on title/filename keywords.
* Visual cues in logs when posts are skipped.
* **External Link Detection**: Option to show extracted cloud/drive links in the log.
* **Cleaner UI**:
* **Improved Manga Mode**
* Better post ordering and handling of missing or untitled posts.
* Optional numeric-only sorting for consistent naming.
* Redesigned layout.
* Collapsible advanced settings.
* Real-time feedback with improved progress indicators.
* **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
* **GUI Interface**: User-friendly PyQt5-based design.
* **Supports Post and Creator URLs**: Handles individual post downloads or full creator feeds.
* **Smart Folder System**:
* **Simple GUI**
Built with PyQt5 for a clean, responsive experience.
* Organizes downloads using post title, known character/show names, or a custom folder per post.
* Automatically detects and names folders based on matching keywords.
* **Known Names Manager**:
* **Supports Both Post and Creator URLs**
Download a single post or an entire feed with one click.
* Add, search, and delete known characters/shows for smarter file organization.
* Persistently saved to `Known.txt`.
* **Advanced Filters**:
* **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.
* Filter posts by known names in titles.
* Skip posts or files containing words like `WIP`, `sketch`, etc.
* Filter by media type: images, GIFs, or videos only.
* **Archive Control**:
* **Known Names Manager**
Add, search, and delete tags for smarter organization.
Saved to `Known.txt` for reuse.
* Skip `.zip` and `.rar` files.
* **Image Compression**:
* **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.
* Convert large images (>1.5MB) to WebP (requires Pillow).
* **Thumbnails Only**:
* **Manga Mode**
Rename and sort manga posts by title and upload order.
Handles one-image-per-post formats cleanly.
* Uses a local API to fetch and download thumbnail previews instead of full files.
* **Multithreaded Downloads**:
* **Image Compression**
Auto-convert large images (>1.5MB) to WebP (requires Pillow).
* Adjustable thread count with warnings at unsafe values.
* Full threading support for creators, single-threaded fallback for single posts.
* **Download Management**:
* **Multithreaded Downloads**
Adjustable worker count with warnings at unsafe levels.
Full threading for creators, single-thread fallback for post mode.
* Cancel in-progress downloads.
* Skip current file in single-thread mode.
* **Dark Mode**: Clean and modern dark UI theme.
* **Download Controls**
Cancel, pause, or skip files mid-download.
Visual progress tracking with per-post summaries.
* **Dark Mode**
Clean and modern dark-themed interface.
---
## 🔧 Backend Logic Enhancements
## 🔧 Backend Enhancements
* **Post Order Management**:
* **Session File Support**
Downloads can be resumed even after a crash or restart.
Session progress is saved automatically.
* Manga Mode reverses post fetch order to preserve original upload sequence.
* **Hash-based Deduplication**:
* **Retry Logic**
Auto-retries individual failed files before skipping.
Logs all failures with HTTP codes and reasons.
* Avoids re-downloading content already present.
* **Smart File Naming**:
* **Hash-Based Deduplication**
Prevents redownloading of previously saved files.
* Handles inconsistent naming in multi-language manga posts.
* Applies cleaned post titles with page indices.
* **Efficient Progress Tracking**:
* **Smart Naming**
Cleans and standardizes inconsistent post titles.
Adds page indices for manga.
* Shows percentage, active download status, and current file.
* Summarizes per-post download outcomes.
* **Error Handling**:
* Catches broken links, HTTP issues, and content skips with clear log feedback.
* **Efficient Logging**
Toggle between basic and advanced views.
Live feedback with color-coded logs.
---
## 📦 Installation
### Requirements:
### Requirements
* Python 3.6+
* Pip packages:
```bash
pip install PyQt5 requests Pillow
```
### Run it:
```bash
python main.py
```
---
## 🖥️ Build as .EXE
Use `PyInstaller` for a single-file Windows executable:
1. Convert `.png` icon to `.ico` format (if needed).
2. Run:
```bash
pyinstaller --noconsole --onefile --name "Kemono Downloader" --icon=Kemono.ico main.py
```
3. Your `.exe` will be inside the `dist/` folder.
---
## 💡 Usage Tips
1. **Enter a Creator/Post URL**.
2. **Set your Download Location**.
3. (Optional) Choose known characters to filter or organize.
4. Apply filters (skip keywords, file types).
5. Tweak thread settings or enable Manga Mode if needed.
6. Hit **Start Download** and monitor progress!
---
## 🗃️ Configuration File
* `Known.txt` stores known character/show names.
* Each name should be on a new line.
---
## 🤝 Contributing
Contributions are welcome! Open an issue or submit a pull request if you have improvements, bug reports, or feature ideas.
---
Jett, Neon, Reyna, Clove, Viper, Sage