Kemono Downloader v9.0.1

[Yuvi9587]

Rule34 Downloader v2.0

Version 2.0 replaces the basic script with a full GUI dashboard, giving you complete control over exactly what gets downloaded and exactly where it goes.

---

🎛️ The Control Panel (Inputs & Checkboxes)

The new UI lets you filter content with precision before a single file is downloaded.

• One-Click Safety Checkboxes: Instantly block extreme content. A series of checkboxes allows you to exclude Gore, Scatology, Hardcore Furry, Loli, Vore, Insects, and Necrophilia. Hovering over any checkbox reveals the exact Rule34 tags it blocks.
• Granular Download Limits: Use the input fields to set strict rules. You can define a Minimum Score to weed out low-quality art, set a Maximum Download limit to save disk space, and filter by Rating (Safe, Questionable, or Explicit).
• Media Toggles: Simple checkboxes to choose whether you want to download static Images (JPG/PNG), animated Videos (MP4/WEBM), or both.
• Custom Blacklists & Whitelists: Text inputs allow you to define your own custom blacklist. Alternatively, the Whitelist input acts as an absolute override—if a post contains a whitelisted tag (like a favorite artist), it downloads immediately, ignoring other filters.
• API Authentication: An input field to securely save your Rule34 User ID and API Key, preventing rate-limits and IP bans.

📁 The Automated Folder System

Instead of dumping everything into one messy directory, the app now builds a clean, nested folder structure based on the image tags.

• Character Folders: The app compares tags against your characters.json database and creates dedicated folders for matches (e.g., \Tsunade\).
• ⭐ Favorites Manager & Strict Mode: Maintain a curated list of your favorite characters directly in the UI (or by editing your JSON). You can toggle a strict "Favorites Only" mode, which ensures folders are only created for your absolute favorites, sending any unrecognized characters to an \Unknown\ directory.
• ⚡ Bulk Autocomplete (Ctrl + Down): The Favorites input features a smart autocomplete engine powered by your database. Press Ctrl + Down Arrow to rapidly chain and harvest multiple character names at once without ever taking your hands off the keyboard!
• Priority Scene Routing: If the image matches a scene tag you've defined, it creates a sub-folder (e.g., \Tsunade\Bikini\). Because posts often have multiple tags, the UI allows you to reorder your scene list by moving tags up and down. The engine respects this hierarchy—the tag at the top of your list always wins the folder assignment!
• The \~Scenes Master Folder: If an image has a scene tag (like "beach") but no recognized character, it gets routed to a master folder at the bottom of your directory (e.g., \~Scenes\Beach\). This keeps your main list of characters alphabetical and uncluttered.
• Clean Names: The engine automatically strips messy Rule34 metadata (like _(series) or bracketed franchise names) so your final folders look clean and human-readable.

⚙️ Under the Hood

• Duplicate Prevention (MD5): The app logs the unique hash of every file. If a deleted post is re-uploaded with a new ID, the app recognizes you already own it and skips it.
• Tie-Breaker Penalties (*): Adding a * to a name in your database (e.g., naruto*) penalizes that character's score.
  • Example: If an image contains both "Naruto" (200,000 posts) and "Hinata" (50,000 posts), the app defaults to the highest score, meaning the massive franchise "Naruto" will steal the folder assignment. By tagging him as naruto*, his score is artificially lowered during routing, allowing the image to correctly drop into the \Hinata\ folder.
• Tag Aliases: You can map synonymous tags together in a comma-separated list (e.g., bikini = swimsuit, swimwear, two-piece) so your routing logic never misses an image due to a slightly different Rule34 tag.

---

This discussion was created from the release Kemono Downloader v9.0.1.