Kemono Downloader v3.4.0

Kemono Downloader
--- A powerful, feature-rich GUI application for downloading content from **[Kemono.su](https://kemono.su)** and **[Coomer.party](https://coomer.party)**. Built with **PyQt5**, this tool is ideal for users who want deep filtering, customizable folder structures, efficient downloads, and intelligent automation β€” all within a modern, user-friendly graphical interface. --- ## ✨ What's New in v3.4.0? This version brings significant enhancements to manga/comic downloading, filtering capabilities, and user experience: ### πŸ“– Enhanced Manga/Comic Mode - **New "Date Based" Filename Style:** - Perfect for truly sequential content! Files are named numerically (e.g., `001.jpg`, `002.jpg`, `003.ext`...) across an *entire creator's feed*, strictly following post publication order. - **Smart Numbering:** Automatically resumes from the highest existing number found in the series folder (and subfolders, if "Subfolder per Post" is enabled). - **Guaranteed Order:** Disables multi-threading for post processing to ensure sequential accuracy. - Works alongside the existing "Post Title" and "Original File Name" styles. --- ### βœ‚οΈ "Remove Words from Filename" Feature - Specify comma-separated words or phrases (case-insensitive) that will be automatically removed from filenames. - Example: `patreon, [HD], _final` transforms `AwesomeArt_patreon` `Hinata_Hd` into `AwesomeArt.jpg` `Hinata.jpg`. --- ### πŸ“¦ New "Only Archives" File Filter Mode - Exclusively downloads `.zip` and `.rar` files. - Automatically disables conflicting options like "Skip .zip/.rar" and external link logging. --- ### πŸ—£οΈ Improved Character Filter Scope - "Comments (Beta)" - **File-First Check:** Prioritizes matching filenames before checking post comments for character names. - **Comment Fallback:** Only checks comments if no filename match is found, reducing unnecessary API calls. --- ### 🧐 Refined "Missed Character Log" - Displays a capitalized, alphabetized list of key terms from skipped post titles. - Makes it easier to spot patterns or characters that might be unintentionally excluded. --- ### πŸš€ Enhanced Multi-part Download Progress - Granular visibility into active chunk downloads and combined speed for large files. --- ### πŸ—ΊοΈ Updated Onboarding Tour - Improved guide for new users, covering v3.4.0 features and existing core functions. --- ### πŸ›‘οΈ Robust Configuration Path - Settings and `Known.txt` are now stored in the system-standard application data folder (e.g., `AppData`, `~/.local/share`). --- ## πŸ–₯️ Core Features --- ### User Interface & Workflow - **Clean PyQt5 GUI** β€” Simple, modern, and dark-themed. - **Persistent Settings** β€” Saves preferences between sessions. - **Download Modes:** - Single Post URL - Entire Creator Feed - **Flexible Options:** - Specify Page Range (disabled in Manga Mode) - Custom Folder Name for single posts --- ### 🧠 Smart Filtering - **Character Name Filtering:** - Use `Tifa, Aerith` or group `(Boa, Hancock)` β†’ folder `Boa Hancock` - **Filter Scopes:** - `Files` - `Title` - `Both (Title then Files)` - `Comments (Beta - Files first)` - **Skip with Words:** - Exclude with `WIP, sketch, preview` - **Skip Scopes:** - `Files` - `Posts` - `Both (Posts then Files)` - **File Type Filters:** - `All`, `Images/GIFs`, `Videos`, `πŸ“¦ Only Archives`, `πŸ”— Only Links` - **Filename Cleanup:** - Remove illegal and unwanted characters or phrases --- ### πŸ“š Manga/Comic Mode (Creator Feeds Only) - **Chronological Processing** β€” Oldest posts first - **Filename Style Options:** - `Name: Post Title (Default)` - `Name: Original File` - `Name: Date Based (New)` - **Best With:** Character filters set to manga/series title --- ### πŸ“ Folder Structure & Naming - **Subfolders:** - Auto-created based on character name, post title, or `Known.txt` - "Subfolder per Post" option for further nesting - **Smart Naming:** Cleans invalid characters and structures logically --- ### πŸ–ΌοΈ Thumbnail & Compression Tools - **Download Thumbnails Only** - **Compress to WebP** (via Pillow) - Converts large images to smaller WebP versions --- ### βš™οΈ Performance Features - **Multithreading:** - For both post processing and file downloading - **Multi-part Downloads:** - Toggleable in GUI - Splits large files into chunks - Granular chunk-level progress display --- ### πŸ“‹ Logging & Progress - **Real-time Logs:** Activity, errors, skipped posts - **Missed Character Log:** Shows skipped keywords in easy-to-read list - **External Links Log:** Shows links (unless disabled in some modes) - **Export Links:** Save `.txt` of links (Only Links mode) --- ### πŸ—ƒοΈ Config System - **Known.txt:** - Stores names for smart folder suggestions - Supports aliases via `(alias1, alias2)` - **Stored in Standard App Data Path** - **Editable Within GUI** --- ## πŸ’» Installation --- ### Requirements - Python 3.6 or higher - pip --- ### Install Dependencies ```bash pip install PyQt5 requests Pillow ``` *** ## **πŸ› οΈ Build a Standalone Executable (Optional)** 1. Install PyInstaller: ```bash pip install pyinstaller ``` 2. Run: ```bash pyinstaller --name "Kemono Downloader" --onefile --windowed --icon="Kemono.ico" main.py ``` 3. Output will be in the `dist/` folder. *** ## **πŸ—‚ Config Files** - `Known.txt` β€” character/show names used for folder organization - Supports grouped names in format: `(Name1, Name2)` *** ## **πŸ’¬ Feedback & Support** Issues? Suggestions? Open an issue on the [GitHub repository](https://github.com/Yuvi9587/kemono-downloader) or join our community.