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. * **Session Resuming**
* **Enhanced Logging**: * Automatically saves and resumes incomplete downloads.
* Toggle between **Basic** and **Advanced** views. * **Retry on Failure**
* Live log resizing and improved readability. * Failed files auto-retry up to 3 times.
* **Dynamic Thread Control**: * Clear logging for each retry attempt.
* Adjustable worker thread count. * **Batch URL Import**
* Warnings and auto-caps on high thread values to prevent system slowdown or site rate-limiting. * Load multiple creator or post URLs from a `.txt` file.
* **Advanced Skip Filters**:
* Skip posts/files based on title/filename keywords. * **Improved Manga Mode**
* Visual cues in logs when posts are skipped. * Better post ordering and handling of missing or untitled posts.
* **External Link Detection**: Option to show extracted cloud/drive links in the log. * Optional numeric-only sorting for consistent naming.
* **Cleaner UI**:
* Redesigned layout. * **UI Enhancements**
* Collapsible advanced settings. * Settings persist across sessions.
* Real-time feedback with improved progress indicators. * 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 ## 🧩 Core Features
* **GUI Interface**: User-friendly PyQt5-based design. * **Simple GUI**
* **Supports Post and Creator URLs**: Handles individual post downloads or full creator feeds. Built with PyQt5 for a clean, responsive experience.
* **Smart Folder System**:
* Organizes downloads using post title, known character/show names, or a custom folder per post. * **Supports Both Post and Creator URLs**
* Automatically detects and names folders based on matching keywords. Download a single post or an entire feed with one click.
* **Known Names Manager**:
* Add, search, and delete known characters/shows for smarter file organization. * **Smart Folder System**
* Persistently saved to `Known.txt`. Organize files using post titles, known character/show names, or a folder per post.
* **Advanced Filters**: Detects and auto-names folders based on custom keywords.
* Filter posts by known names in titles. * **Known Names Manager**
* Skip posts or files containing words like `WIP`, `sketch`, etc. Add, search, and delete tags for smarter organization.
* Filter by media type: images, GIFs, or videos only. Saved to `Known.txt` for reuse.
* **Archive Control**:
* Skip `.zip` and `.rar` files. * **Advanced Filters**
* **Image Compression**: * 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). * **Manga Mode**
* **Thumbnails Only**: 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. * **Image Compression**
* **Multithreaded Downloads**: Auto-convert large images (>1.5MB) to WebP (requires Pillow).
* Adjustable thread count with warnings at unsafe values. * **Multithreaded Downloads**
* Full threading support for creators, single-threaded fallback for single posts. Adjustable worker count with warnings at unsafe levels.
* **Download Management**: Full threading for creators, single-thread fallback for post mode.
* Cancel in-progress downloads. * **Download Controls**
* Skip current file in single-thread mode. Cancel, pause, or skip files mid-download.
* **Dark Mode**: Clean and modern dark UI theme. 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. * **Retry Logic**
* **Hash-based Deduplication**: Auto-retries individual failed files before skipping.
Logs all failures with HTTP codes and reasons.
* Avoids re-downloading content already present. * **Hash-Based Deduplication**
* **Smart File Naming**: Prevents redownloading of previously saved files.
* Handles inconsistent naming in multi-language manga posts. * **Smart Naming**
* Applies cleaned post titles with page indices. Cleans and standardizes inconsistent post titles.
* **Efficient Progress Tracking**: Adds page indices for manga.
* Shows percentage, active download status, and current file. * **Efficient Logging**
* Summarizes per-post download outcomes. Toggle between basic and advanced views.
* **Error Handling**: Live feedback with color-coded logs.
* Catches broken links, HTTP issues, and content skips with clear log feedback.
--- ---
## 📦 Installation ## 📦 Installation
### Requirements: ### Requirements
* Python 3.6+ * Python 3.6+
* Pip packages: * Pip packages:
```bash ```bash
pip install PyQt5 requests Pillow 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