diff --git a/readme.md b/readme.md index 1042c77..e31ea8b 100644 --- a/readme.md +++ b/readme.md @@ -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 \ No newline at end of file