Kemono Downloader v4.0.1

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 v4.0.0? Version 3.5.0 focuses on enhancing access to content and providing even smarter organization: ### Cookie Management - **Access Content:** Seamlessly download from Kemono/Coomer as if you were logged in by using your browser's cookies. - **Flexible Input:** - Directly paste your cookie string (e.g., `name1=value1; name2=value2`). - Browse and load cookies from a `cookies.txt` file (Netscape format). - Automatic fallback to a `cookies.txt` file in the application directory if "Use Cookie" is enabled and no other source is specified. - **Easy Activation:** A simple "Use Cookie" checkbox in the UI controls this feature. - *Important Note: Cookie settings (text, file path, and enabled state) are configured per session and are not saved when the application is closed. You will need to re-apply them on each launch if needed.* --- ### Advanced `Known.txt` and Character Filtering The `Known.txt` system has been revamped for improved performance and stability. The previous method of handling known names could become resource-intensive with large lists, potentially leading to application slowdowns or crashes. This new, streamlined system offers more direct control and robust organization. The `Known.txt` file and the "Filter by Character(s)" input field work together to provide powerful and flexible content organization. The `Known.txt` file itself has a straightforward syntax, while the UI input allows for more complex session-specific grouping and alias definitions that can then be added to `Known.txt`. **1. `Known.txt` File Syntax (Located in App Directory):** `Known.txt` stores your persistent list of characters, series, or keywords for folder organization. Each line is an entry: - **Simple Entries:** - A line like `My Awesome Series` or `Nami`. - **Behavior:** Content matching this term will be saved into a folder named "My Awesome Series" or "Nami" respectively (if "Separate Folders" is enabled). **2. "Filter by Character(s)" UI Input Field:** This field allows for dynamic filtering for the current download session and provides options for how new entries are added to `Known.txt`. - **Standard Names:** - Input: `Nami, Robin` - Session Behavior: Filters for "Nami" OR "Robin". If "Separate Folders" is on, creates folders "Nami" and "Robin". - `Known.txt` Addition: If "Nami" is new and selected for addition in the confirmation dialog, it's added as `Nami` on a new line in `Known.txt`. - **Grouped Aliases for a Single Character (using `(...)~` syntax):** - Input: `(Boa, Hancock)~` - Meaning: "Boa" and "Hancock" are different names/aliases for the *same character*. The names are listed within parentheses separated by commas (e.g., `name1, alias1, alias2`), and the entire group is followed by a `~` symbol. This is useful when a creator uses different names for the same character. - Session Behavior: Filters for "Boa" OR "Hancock". If "Separate Folders" is on, creates a single folder named "Boa Hancock". - `Known.txt` Addition: If this group is new and selected for addition, it's added to `Known.txt` as a grouped alias entry, typically `(Boa Hancock)`. The first name in the `Known.txt` entry (e.g., "Boa Hancock") becomes the primary folder name. - **Combined Folder for Distinct Characters (using `(...)` syntax):** - Input: `(Vivi, Uta)` - Meaning: "Vivi" and "Uta" are *distinct characters*, but for this download session, their content should be grouped into a single folder. The names are listed within parentheses separated by commas. This is useful for grouping art of less frequent characters without creating many small individual folders. - Session Behavior: Filters for "Vivi" OR "Uta". If "Separate Folders" is on, creates a single folder named "Vivi Uta". - `Known.txt` Addition: If this "combined group" is new and selected for addition, "Vivi" and "Uta" are added to `Known.txt` as *separate, individual simple entries* on new lines: ``` Vivi Uta ``` The combined folder "Vivi Uta" is a session-only convenience; `Known.txt` stores them as distinct entities for future individual use. **3. Interaction with `Known.txt`:** - **Adding New Names from Filters:** When you use the "Filter by Character(s)" input, if any names or groups are new (not already in `Known.txt`), a dialog will appear after you start the download. This dialog allows you to select which of these new names/groups should be added to `Known.txt`, formatted according to the rules described above. - **Intelligent Fallback:** If "Separate Folders by Name/Title" is active, and content doesn't match the "Filter by Character(s)" UI input, the downloader consults your `Known.txt` file for folder naming. - **Direct Management:** You can add simple entries directly to `Known.txt` using the list and "Add" button in the UI's `Known.txt` management section. For creating or modifying complex grouped alias entries directly in the file, or for bulk edits, click the "Open Known.txt" button. The application reloads `Known.txt` on startup or before a download process begins. --- ## What's in v3.5.0? (Previous Update) 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 v4.0.0 features and existing core functions. --- ### Robust Configuration Path - Settings and `Known.txt` are now stored in the same folder as app. --- ## 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` - Flexible input for current session and for adding to `Known.txt`. - Examples: - `Nami` (simple character) - `(Boa Hancock)~` (aliases for one character, session folder "Boa Hancock", adds `(Boa Hancock)` to `Known.txt`) - `(Vivi, Uta)` (distinct characters, session folder "Vivi Uta", adds `Vivi` and `Uta` separately to `Known.txt`) - See "Advanced `Known.txt` and Character Filtering" for full details. - **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` for Smart Folder Naming (Located in App Directory):** - A user-editable file that stores a list of preferred names, series titles, or keywords. - It's primarily used as an intelligent fallback for folder creation when "Separate Folders by Name/Title" is enabled. - **Syntax:** - Simple entries: `My Favorite Series` (creates folder "My Favorite Series", matches "My Favorite Series"). - Grouped entries: `(Desired Folder Name, alias1, alias2)` (creates folder "Desired Folder Name"; matches "Desired Folder Name", "alias1", or "alias2"). - **Settings Stored in App Directory** - **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** - `settings.json` — Stores your UI preferences and settings. - `Known.txt` — Stores character names, series titles, or keywords for organizing downloaded content into specific folders. - Supports simple entries (e.g., `My Series`) and grouped entries for aliases (e.g., `(Folder Name, alias1, alias2)` where "Folder Name" is the name of the created folder, and all terms are used for matching). *** ## ** Feedback & Support** Issues? Suggestions? Open an issue on the [GitHub repository](https://github.com/Yuvi9587/kemono-downloader) or join our community.