Yuvi

These are the primary controls you'll interact with to initiate and manage downloads.

1. Main Inputs

• 🔗 Kemono Creator/Post URL Input Field:

  Purpose: This is where you paste the URL of the content you want to download.

  Usage: Supports full URLs for:

  • Kemono.su (and mirrors like kemono.party) creator pages (e.g., https://kemono.su/patreon/user/12345).
  • Kemono.su (and mirrors) individual posts (e.g., https://kemono.su/patreon/user/12345/post/98765).
  • Coomer.party (and mirrors like coomer.su) creator pages.
  • Coomer.party (and mirrors) individual posts.

  Note:

  • When ⭐ Favorite Mode is active, this field is disabled and shows a "Favorite Mode active" message.
  • This field can also be populated with a placeholder message (e.g., "{count} items in queue from popup") if posts are added to the download queue directly from the 'Creator Selection' dialog's 'Fetched Posts' view.
• 🎨 Creator Selection Button:

  Icon: 🎨 (Artist Palette)

  Location: Next to the URL input field.

  Purpose: Opens the "Creator Selection" dialog to easily add multiple creators to the URL field.

• Page Range (Start to End) Input Fields:

  Purpose: For creator URLs, specify a range of pages to fetch and process.

  Usage: Enter the starting page number in the first field and the ending page number in the second.

• 📁 Download Location Input Field & Browse Button:

  Purpose: Specify the main directory where all downloaded files and folders will be saved.

  Requirement: This field must be filled unless you are using the "🔗 Only Links" filter mode.

2. Action Buttons

• ⬇️ Start Download / 🔗 Extract Links Button: Initiates downloading or link extraction.
• ⏸️ Pause / ▶️ Resume Download Button: Temporarily halt or continue the ongoing process.
• ❌ Cancel & Reset UI Button: Immediately stops the current operation and performs a "soft" reset.
• 🔄 Reset Button (located in the log area): Performs a "hard" reset of the UI when no operation is active.

These options allow you to precisely control what content is downloaded or skipped.

• 🎯 Filter by Character(s) Input Field: Download content for specific characters using simple names, (Grouped, Names), or aliased names like (Boa, Hancock)~.
• Filter: [Type] Button: Cycles the character filter scope through Files, Title, Both, or Comments (Beta).
• 🚫 Skip with Words Input Field: Exclude posts or files containing specified keywords.
• Scope: [Type] Button: Cycles the skip word scope through Files, Posts, or Both.
• ✂️ Remove Words from name Input Field: Clean up filenames by removing unwanted words.
• Filter Files (Radio Buttons): Select file types to download: All, Images/GIFs, Videos, Only Archives, Only Audio, or Only Links.
• Skip .zip / Skip .rar Checkboxes: Individually choose to skip downloading archive files.

Options to further refine the download process and output.

• Download Thumbnails Only Checkbox: Download only small preview images instead of full-resolution files.
• Scan Content for Images Checkbox: Scan post content for embedded <img> tags to find images not listed as attachments.
• Compress to WebP Checkbox: Convert images to WebP format to save space (requires Pillow library).
• 🗄️ Custom Folder Name (Single Post Only) Input Field: Specify a custom folder name when downloading a single post.

Specialized mode for downloading creator feeds in chronological order, suitable for sequential reading.

• Activation: Active when downloading a creator's feed with a relevant "Filename Style".
• Core Behavior: Processes posts from oldest to newest, disabling page range selection.
• Filename Style Toggle Button: Controls how files are named.
  • Name: Post Title: First file is named after the post title.
  • Name: Original File: Keeps original filenames.
  • Name: Title+G.Num: Globally sequential numbering across all posts (e.g., Chapter 1_001.jpg).
  • Name: Date Based: Sequentially numbered based on post date.
• Optional Filename Prefix Input Field: Appears for some styles to add a custom prefix to all filenames.

Controls for how downloaded content is structured into folders.

• Separate Folders by Name/Title Checkbox: Creates subfolders based on character filters or post titles.
• Subfolder per Post Checkbox: Creates an additional layer of subfolders for each individual post.
• Known.txt Management UI: Manage a local list of names for automatic folder organization and filter suggestions. Includes tools to add, delete, and apply names to the character filter.

Download directly from your favorited artists and posts on Kemono.su.

• Enable Checkbox ("⭐ Favorite Mode"): Switches the downloader to operate on your Kemono.su favorites, disabling the URL input.
• 🖼️ Favorite Artists Button & Dialog: Fetches and lets you download from your favorited artists.
• 📄 Favorite Posts Button & Dialog: Fetches and lets you download specific favorited posts.
• Favorite Download Scope Button: Determines if downloads go into the main location or into artist-specific subfolders.

🍪 Cookie Management

• Use Cookie Checkbox: Enables use of browser cookies for restricted content.
• Cookie Text Field / Browse... Button: Paste a cookie string or select a cookies.txt file.

Use Multithreading

• Use Multithreading Checkbox & Threads Input Field: Configure the number of simultaneous download threads to speed up the process.

Multi-part Download

• Multi-part Download Toggle Button: Enables multi-segment downloading for individual large files to increase download speed.

• 📜 Progress Log Area: Displays detailed messages about the ongoing process, errors, and skipped items.
• 👁️ / 🙈 Log View Toggle Button: Switches between the main progress log and a "Missed Character Log" to see terms that didn't match your filters.
• Show External Links in Log Checkbox: Displays external links (e.g., Mega, Google Drive) in a separate panel.
• Export Links Button: Saves extracted links to a .txt file when in "Only Links" mode.
• Progress Labels/Bars: Provide a visual and textual representation of download progress.

• 🆘 Error Button (Main UI): Becomes active if files failed to download. Clicking it opens a dialog to manage failed files.
• "Files Skipped Due to Errors" Dialog:
  • Lists all files that failed to download.
  • Allows you to select and retry downloading specific files.
  • Provides an option to export the URLs of failed files to a text file for manual download or use in other tools.

These settings allow you to customize the application's appearance and language.

• ⚙️ Settings Button: Opens the "Settings" dialog.
• "Settings" Dialog:
  • Appearance: Switch between Light and Dark visual themes.
  • Language Settings: Change the display language of the application interface. A restart is required for changes to take full effect.

• Retry Failed Downloads Prompt: Appears at the end of a session if files failed, asking if you want to retry them.
• New Name Confirmation Dialog: Prompts you to add new, unrecognized names from the character filter into your Known.txt file.
• Onboarding Tour / Help Guide Button (❓): Opens a built-in help guide explaining the application's features.