mirror of
https://github.com/Yuvi9587/Kemono-Downloader.git
synced 2025-12-17 15:36:51 +00:00
Update readme.md
This commit is contained in:
Yuvi9587
parent
a5cb04ea6f
commit
e9be13c4e3
139
readme.md
139
readme.md
@ -41,108 +41,53 @@ Built with PyQt5, this tool is designed for users who want deep filtering capabi
|
|||||||
|
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
|
<h2><strong>Core Capabilities Overview</strong></h2>
|
||||||
|
|
||||||
---
|
<h3><strong>High-Performance Downloading</strong></h3>
|
||||||
|
<ul>
|
||||||
|
<li><strong>Multi-threading:</strong> Processes multiple posts simultaneously to greatly accelerate downloads from large creator profiles.</li>
|
||||||
|
<li><strong>Multi-part Downloading:</strong> Splits large files into chunks and downloads them in parallel to maximize speed.</li>
|
||||||
|
<li><strong>Resilience:</strong> Supports pausing, resuming, and restoring downloads after crashes or interruptions.</li>
|
||||||
|
</ul>
|
||||||
|
|
||||||
## Feature Overview
|
<h3><strong>Advanced Filtering & Content Control</strong></h3>
|
||||||
|
<ul>
|
||||||
|
<li><strong>Content Type Filtering:</strong> Select whether to download all files or limit to images, videos, audio, or archives only.</li>
|
||||||
|
<li><strong>Keyword Skipping:</strong> Automatically skips posts or files containing certain keywords (e.g., "WIP", "sketch").</li>
|
||||||
|
<li><strong>Character Filtering:</strong> Restricts downloads to posts that match specific character or series names.</li>
|
||||||
|
</ul>
|
||||||
|
|
||||||
Kemono Downloader offers a range of features to streamline your content downloading experience:
|
<h3><strong>File Organization & Renaming</strong></h3>
|
||||||
|
<ul>
|
||||||
|
<li><strong>Automated Subfolders:</strong> Automatically organizes downloaded files into subdirectories based on character names or per post.</li>
|
||||||
|
<li><strong>Advanced File Renaming:</strong> Flexible renaming options, especially in Manga Mode, including:
|
||||||
|
<ul>
|
||||||
|
<li><strong>Post Title:</strong> Uses the post's title (e.g., <code>Chapter-One.jpg</code>).</li>
|
||||||
|
<li><strong>Date + Original Name:</strong> Prepends the publication date to the original filename.</li>
|
||||||
|
<li><strong>Date + Title:</strong> Combines the date with the post title.</li>
|
||||||
|
<li><strong>Sequential Numbering (Date Based):</strong> Simple sequence numbers (e.g., <code>001.jpg</code>, <code>002.jpg</code>).</li>
|
||||||
|
<li><strong>Title + Global Numbering:</strong> Uses post title with a globally incrementing number across the session.</li>
|
||||||
|
<li><strong>Post ID:</strong> Names files using the post’s unique ID.</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
|
||||||
- **User-Friendly Interface:** A modern PyQt5 GUI for easy navigation and operation.
|
<h3><strong>Specialized Modes</strong></h3>
|
||||||
|
<ul>
|
||||||
|
<li><strong>Manga/Comic Mode:</strong> Sorts posts chronologically before downloading to ensure pages appear in the correct sequence.</li>
|
||||||
|
<li><strong>Favorite Mode:</strong> Connects to your account and downloads from your favorites list (artists or posts).</li>
|
||||||
|
<li><strong>Link Extraction Mode:</strong> Extracts external links from posts for export or targeted downloading.</li>
|
||||||
|
<li><strong>Text Extraction Mode:</strong> Saves post descriptions or comment sections as <code>PDF</code>, <code>DOCX</code>, or <code>TXT</code> files.</li>
|
||||||
|
</ul>
|
||||||
|
|
||||||
- **Flexible Downloading:**
|
<h3><strong>Utility & Advanced Features</strong></h3>
|
||||||
- Download content from Kemono.su (and mirrors) and Coomer.party (and mirrors).
|
<ul>
|
||||||
- Supports creator pages (with page range selection) and individual post URLs.
|
<li><strong>Cookie Support:</strong> Enables access to subscriber-only content via browser session cookies.</li>
|
||||||
- Standard download controls: Start, Pause, Resume, and Cancel.
|
<li><strong>Duplicate Detection:</strong> Prevents saving duplicate files using content-based comparison, with configurable limits.</li>
|
||||||
|
<li><strong>Image Compression:</strong> Automatically converts large images to <code>.webp</code> to reduce disk usage.</li>
|
||||||
- **Powerful Filtering:**
|
<li><strong>Creator Management:</strong> Built-in creator browser and update checker for downloading only new posts from saved profiles.</li>
|
||||||
- **Character Filtering:** Filter content by character names. Supports simple comma-separated names and grouped names for shared folders.
|
<li><strong>Error Handling:</strong> Tracks failed downloads and provides a retry dialog with options to export or redownload missing files.</li>
|
||||||
- **Keyword Skipping:** Skip posts or files based on specified keywords.
|
</ul>
|
||||||
- **Filename Cleaning:** Remove unwanted words or phrases from downloaded filenames.
|
|
||||||
- **File Type Selection:** Choose to download all files, or limit to images/GIFs, videos, audio, or archives. Can also extract external links only.
|
|
||||||
|
|
||||||
- **Customizable Downloads:**
|
|
||||||
- **Thumbnails Only:** Option to download only small preview images.
|
|
||||||
- **Content Scanning:** Scan post HTML for `<img>` tags and direct image links, useful for images embedded in descriptions.
|
|
||||||
- **WebP Conversion:** Convert images to WebP format for smaller file sizes (requires Pillow library).
|
|
||||||
|
|
||||||
- **Organized Output:**
|
|
||||||
- **Automatic Subfolders:** Create subfolders based on character names (from filters or `Known.txt`) or post titles.
|
|
||||||
- **Per-Post Subfolders:** Option to create an additional subfolder for each individual post.
|
|
||||||
|
|
||||||
- **Manga/Comic Mode:**
|
|
||||||
- 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).
|
|
||||||
|
|
||||||
- **⭐ Favorite Mode:**
|
|
||||||
- Directly download from your favorited artists and posts on Kemono.su.
|
|
||||||
- Requires a valid cookie and adapts the UI for easy selection from your favorites.
|
|
||||||
- Supports downloading into a single location or artist-specific subfolders.
|
|
||||||
|
|
||||||
- **Performance & Advanced Options:**
|
|
||||||
- **Cookie Support:** Use cookies (paste string or load from `cookies.txt`) to access restricted content.
|
|
||||||
- **Multithreading:** Configure the number of simultaneous downloads/post processing threads for improved speed.
|
|
||||||
|
|
||||||
- **Logging:**
|
|
||||||
- A detailed progress log displays download activity, errors, and summaries.
|
|
||||||
|
|
||||||
- **Multi-language Interface:** Choose from several languages for the UI (English, Japanese, French, Spanish, German, Russian, Korean, Chinese Simplified).
|
|
||||||
|
|
||||||
- **Theme Customization:** Selectable Light and Dark themes for user comfort.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## ✨ What's New in v6.0.0
|
|
||||||
|
|
||||||
This release focuses on providing more granular control over file organization and improving at-a-glance status monitoring.
|
|
||||||
|
|
||||||
### New Features
|
|
||||||
|
|
||||||
- **Live Error Count on Button**
|
|
||||||
The **"Error" button** now dynamically displays the number of failed files during a download. Instead of opening the dialog, you can quickly see a live count like `(3) Error`, helping you track issues at a glance.
|
|
||||||
|
|
||||||
- **Date Prefix for Post Subfolders**
|
|
||||||
A new checkbox labeled **"Date Prefix"** is now available in the advanced settings.
|
|
||||||
When enabled alongside **"Subfolder per Post"**, it prepends the post's upload date to the folder name (e.g., `2025-07-11 Post Title`).
|
|
||||||
This makes your downloads sortable and easier to browse chronologically.
|
|
||||||
|
|
||||||
- **Keep Duplicates Within a Post**
|
|
||||||
A **"Keep Duplicates"** option has been added to preserve all files from a post — even if some have the same name.
|
|
||||||
Instead of skipping or overwriting, the downloader will save duplicates with numbered suffixes (e.g., `image.jpg`, `image_1.jpg`, etc.), which is especially useful when the same file name points to different media.
|
|
||||||
|
|
||||||
### Bug Fixes
|
|
||||||
|
|
||||||
- The downloader now correctly renames large `.part` files when completed, avoiding leftover temp files.
|
|
||||||
- The list of failed files shown in the Error Dialog is now saved and restored with your session — so no errors get lost if you close the app.
|
|
||||||
- Your selected download location is remembered, even after pressing the **Reset** button.
|
|
||||||
- The **Cancel** button is now enabled when restoring a pending session, so you can abort stuck jobs more easily.
|
|
||||||
- Internal cleanup logs (like "Deleting post cache") are now excluded from the final download summary for clarity.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 📅 Next Update Plans
|
|
||||||
|
|
||||||
### 🔖 Post Tag Filtering (Planned for v6.1.0)
|
|
||||||
|
|
||||||
A powerful new **"Filter by Post Tags"** feature is planned:
|
|
||||||
|
|
||||||
- Filter and download content based on specific post tags.
|
|
||||||
- Combine tag filtering with current filters (character, file type, etc.).
|
|
||||||
- Use tag presets to automate frequent downloads.
|
|
||||||
|
|
||||||
This will provide **much greater control** over what gets downloaded, especially for creators who use tags consistently.
|
|
||||||
|
|
||||||
### 📁 Creator Download History (.json Save)
|
|
||||||
|
|
||||||
To streamline incremental downloads, a new system will allow the app to:
|
|
||||||
|
|
||||||
- Save a `.json` file with metadata about already-downloaded posts.
|
|
||||||
- Compare that file on future runs, so only **new** posts are downloaded.
|
|
||||||
- Avoids duplication and makes regular syncs fast and efficient.
|
|
||||||
|
|
||||||
Ideal for users managing large collections or syncing favorites regularly.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 💻 Installation
|
## 💻 Installation
|
||||||
|
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user