Update readme.md

features.md

@@ -1,147 +1,391 @@
 <div>
-    <h1>Kemono Downloader - Comprehensive Feature Guide</h1>
-    <p>This guide provides a detailed overview of all user interface elements, input fields, buttons, popups, and functionalities available in the application.</p>
-    <hr>
-    <h2><strong>Main Window: Core Functionality</strong></h2>
-    <p>The application is divided into a configuration panel on the left and a status/log panel on the right.</p>
-    <h3><strong>Primary Inputs (Top-Left)</strong></h3>
-    <ul>
-        <li><strong>URL Input Field</strong>: This is the starting point for most downloads. You can paste a URL for a specific post or for an entire creator's feed. The application's behavior adapts based on the URL type.</li>
-        <li><strong>🎨 Creator Selection Popup</strong>: This button opens a powerful dialog listing all known creators. From here, you can:
-            <ul>
-                <li><strong>Search and Queue</strong>: Search for creators and check multiple names. Clicking "Add Selected" populates the main input field, preparing a batch download.</li>
-                <li><strong>Check for Updates</strong>: Select a single creator's saved profile. This loads their information and switches the main download button to "Check for Updates" mode, allowing you to download only new content since your last session.</li>
-            </ul>
-        </li>
-        <li><strong>Download Location</strong>: The primary folder where all content will be saved. The <strong>Browse...</strong> button lets you select this folder from your computer.</li>
-        <li><strong>Page Range (Start/End)</strong>: These fields activate only for creator feed URLs. They allow you to download a specific slice of a creator's history (e.g., pages 5 through 10) instead of their entire feed.</li>
-    </ul>
-    <hr>
-    <h2><strong>Filtering & Naming (Left Panel)</strong></h2>
-    <p>These features give you precise control over what gets downloaded and how it's named and organized.</p>
-    <ul>
-        <li><strong>Filter by Character(s)</strong>: A powerful tool to download content featuring specific characters. You can enter multiple names separated by commas.
-            <ul>
-                <li><strong>Filter: [Scope] Button</strong>: This button changes how the character filter works:
-                    <ul>
-                        <li><strong>Title</strong>: Downloads posts only if a character's name is in the post title.</li>
-                        <li><strong>Files</strong>: Downloads posts if a character's name is in any of the filenames within the post.</li>
-                        <li><strong>Both</strong>: Combines the "Title" and "Files" logic.</li>
-                        <li><strong>Comments (Beta)</strong>: Downloads a post if a character's name is mentioned in the comments section.</li>
-                    </ul>
-                </li>
-            </ul>
-        </li>
-        <li><strong>Skip with Words</strong>: A keyword-based filter to avoid unwanted content (e.g., <code>WIP</code>, <code>sketch</code>).
-            <ul>
-                <li><strong>Scope: [Type] Button</strong>: This button changes how the skip filter works:
-                    <ul>
-                        <li><strong>Posts</strong>: Skips the entire post if a keyword is found in the title.</li>
-                        <li><strong>Files</strong>: Skips only individual files if a keyword is found in the filename.</li>
-                        <li><strong>Both</strong>: Applies both levels of skipping.</li>
-                    </ul>
-                </li>
-            </ul>
-        </li>
-        <li><strong>Remove Words from name</strong>: Automatically cleans downloaded filenames by removing any specified words (e.g., "patreon," "HD").</li>
-    </ul>
-    <h3><strong>File Type Filter (Radio Buttons)</strong></h3>
-    <p>This section lets you choose the kind of content you want:</p>
-    <ul>
-        <li><strong>All, Images/GIFs, Videos, 🎧 Only Audio, 📦 Only Archives</strong>: These options filter the downloads to only include the selected file types.</li>
-        <li><strong>🔗 Only Links</strong>: This special mode doesn't download any files. Instead, it scans post descriptions and lists all external links (like Mega, Google Drive) in the log panel.</li>
-        <li><strong>More</strong>: Opens a dialog for text-only downloads. You can choose to save post <strong>descriptions</strong> or <strong>comments</strong> as formatted <strong>PDF, DOCX, or TXT</strong> files. A key feature here is the <strong>"Single PDF"</strong> option, which compiles the text from all downloaded posts into one continuous, sorted PDF document.</li>
-    </ul>
-    <hr>
-    <h2><strong>Download Options & Advanced Settings (Checkboxes)</strong></h2>
-    <ul>
-        <li><strong>Skip .zip</strong>: A simple toggle to ignore archive files during downloads.</li>
-        <li><strong>Download Thumbnails Only</strong>: Downloads only the small preview images instead of the full-resolution files.</li>
-        <li><strong>Scan Content for Images</strong>: A crucial feature that scans the post's text content for embedded images that may not be listed in the API, ensuring a more complete download.</li>
-        <li><strong>Compress to WebP</strong>: Saves disk space by automatically converting large images into the efficient WebP format.</li>
-        <li><strong>Keep Duplicates</strong>: Opens a dialog to control how files with identical content are handled. The default is to skip duplicates, but you can choose to keep all of them or set a specific limit (e.g., "keep up to 2 copies of the same file").</li>
-        <li><strong>Subfolder per Post</strong>: Organizes downloads by creating a unique folder for each post, named after the post's title.</li>
-        <li><strong>Date Prefix</strong>: When "Subfolder per Post" is on, this adds the post's date to the beginning of the folder name (e.g., <code>2025-07-25 Post Title</code>).</li>
-        <li><strong>Separate Folders by Known.txt</strong>: This enables the automatic folder organization system based on your "Known Names" list.</li>
-        <li><strong>Use Cookie</strong>: Allows the application to use browser cookies to access content that might be behind a paywall or login. You can paste a cookie string directly or use <strong>Browse...</strong> to select a <code>cookies.txt</code> file.</li>
-        <li><strong>Use Multithreading</strong>: Greatly speeds up downloads of creator feeds by processing multiple posts at once. The number of <strong>Threads</strong> can be configured.</li>
-        <li><strong>Show External Links in Log</strong>: When checked, a secondary log panel appears at the bottom of the right side, dedicated to listing any external links found.</li>
-    </ul>
-    <hr>
-    <h2><strong>Known Names Management (Bottom-Left)</strong></h2>
-    <p>This powerful feature automates the creation of organized, named folders.</p>
-    <ul>
-        <li><strong>Known Shows/Characters List</strong>: Displays all the names and groups you've saved.</li>
-        <li><strong>Search...</strong>: Filters the list to quickly find a name.</li>
-        <li><strong>Open Known.txt</strong>: Opens the source file in a text editor for advanced manual editing.</li>
-        <li><strong>Add New Name</strong>:
-            <ul>
-                <li><strong>Single Name</strong>: Typing <code>Tifa Lockhart</code> and clicking <strong>➕ Add</strong> creates an entry that will match "Tifa Lockhart".</li>
-                <li><strong>Group</strong>: Typing <code>(Boa, Hancock, Snake Princess)~</code> and clicking <strong>➕ Add</strong> creates a single entry named "Boa Hancock Snake Princess". The application will then look for "Boa," "Hancock," OR "Snake Princess" in titles/filenames and save any matches into that combined folder.</li>
-            </ul>
-        </li>
-        <li><strong>⤵️ Add to Filter</strong>: Opens a dialog with your full Known Names list, allowing you to check multiple entries and add them all to the "Filter by Character(s)" field at once.</li>
-        <li><strong>🗑️ Delete Selected</strong>: Removes highlighted names from your list.</li>
-    </ul>
-    <hr>
-    <h2><strong>Action Buttons & Status Controls</strong></h2>
-    <ul>
-        <li><strong>⬇️ Start Download / 🔗 Extract Links</strong>: The main action button. Its function is dynamic:
-            <ul>
-                <li><strong>Normal Mode</strong>: Starts the download based on the current settings.</li>
-                <li><strong>Update Mode</strong>: After selecting a creator profile, this button changes to <strong>🔄 Check for Updates</strong>.</li>
-                <li><strong>Update Confirmation</strong>: After new posts are found, it changes to <strong>⬇️ Start Download (X new)</strong>.</li>
-                <li><strong>Link Extraction Mode</strong>: The text changes to <strong>🔗 Extract Links</strong>.</li>
-            </ul>
-        </li>
-        <li><strong>⏸️ Pause / ▶️ Resume Download</strong>: Pauses the ongoing download, allowing you to change certain settings (like filters) on the fly. Click again to resume.</li>
-        <li><strong>❌ Cancel & Reset UI</strong>: Immediately stops all download activity and resets the UI to a clean state, preserving your URL and Download Location inputs.</li>
-        <li><strong>Error Button</strong>: If files fail to download, they are logged. This button opens a dialog listing all failed files and will show a count of errors (e.g., <strong>(5) Error</strong>). From the dialog, you can:
-            <ul>
-                <li>Select specific files to <strong>Retry</strong> downloading.</li>
-                <li><strong>Export</strong> the list of failed URLs to a <code>.txt</code> file.</li>
-            </ul>
-        </li>
-        <li><strong>🔄 Reset (Top-Right)</strong>: A hard reset that clears all logs and returns every single UI element to its default state.</li>
-        <li><strong>⚙️ (Settings)</strong>: Opens the main Settings dialog.</li>
-        <li><strong>📜 (History)</strong>: Opens the Download History dialog.</li>
-        <li><strong>? (Help)</strong>: Opens a helpful guide explaining the application's features.</li>
-        <li><strong>❤️ Support</strong>: Opens a dialog with information on how to support the developer.</li>
-    </ul>
-    <hr>
-    <h2><strong>Specialized Modes & Features</strong></h2>
-    <h3><strong>⭐ Favorite Mode</strong></h3>
-    <p>Activating this mode transforms the UI for managing saved collections:</p>
-    <ul>
-        <li>The URL input is disabled.</li>
-        <li>The main action buttons are replaced with:
-            <ul>
-                <li><strong>🖼️ Favorite Artists</strong>: Opens a dialog to browse and queue downloads from your saved favorite creators.</li>
-                <li><strong>📄 Favorite Posts</strong>: Opens a dialog to browse and queue downloads for specific saved favorite posts.</li>
-            </ul>
-        </li>
-        <li><strong>Scope: [Location] Button</strong>: Toggles where the favorited content is saved:
-            <ul>
-                <li><strong>Selected Location</strong>: Saves all content directly into the main "Download Location".</li>
-                <li><strong>Artist Folders</strong>: Creates a subfolder for each artist inside the main "Download Location".</li>
-            </ul>
-        </li>
-    </ul>
-    <h3><strong>📖 Manga/Comic Mode</strong></h3>
-    <p>This mode is designed for sequential content and has several effects:</p>
-    <ul>
-        <li><strong>Reverses Download Order</strong>: It fetches and downloads posts from <strong>oldest to newest</strong>.</li>
-        <li><strong>Enables Special Naming</strong>: A <strong><code>Name: [Style]</code></strong> button appears, allowing you to choose how files are named to maintain their correct order (e.g., by Post Title, by Date, or simple sequential numbering like <code>001, 002, 003...</code>).</li>
-        <li><strong>Disables Multithreading (for certain styles)</strong>: To guarantee perfect sequential numbering, multithreading for posts is automatically disabled for certain naming styles.</li>
-    </ul>
-    <h3><strong>Session & Error Management</strong></h3>
-    <ul>
-        <li><strong>Session Restore</strong>: If the application is closed unexpectedly during a download, it will detect the incomplete session on the next launch. The UI will present a <strong>🔄 Restore Download</strong> button to resume exactly where you left off. You can also choose to discard the session.</li>
-        <li><strong>Update Checking</strong>: By selecting a creator profile via the <strong>🎨 Creator Selection Popup</strong>, you can run an update check. The application compares the posts on the server with your download history for that creator and will prompt you to download only the new content.</li>
-    </ul>
-    <h3><strong>Logging & Monitoring</strong></h3>
-    <ul>
-        <li><strong>Progress Log</strong>: The main log provides real-time feedback on the download process, including status messages, file saves, skips, and errors.</li>
-        <li><strong>👁️ Log View Toggle</strong>: Switches the log view between the standard <strong>Progress Log</strong> and a <strong>Missed Character Log</strong>, which shows potential character names from posts that were skipped by your filters, helping you discover new names to add to your list.</li>
-    </ul>
+  <h1>Kemono Downloader - Comprehensive Feature Guide</h1>
+  <p>This guide provides a detailed overview of all user interface elements, input fields, buttons, popups, and functionalities available in the application.</p>
+  <hr>
+
+  <h2><strong>1. URL Input (🔗)</strong></h2>
+  <p>This is the primary input field where you specify the content you want to download.</p>
+
+  <p><strong>Functionality:</strong></p>
+  <ul>
+    <li><strong>Creator URL:</strong> A link to a creator's main page (e.g., https://kemono.su/patreon/user/12345). Downloads all posts from the creator.</li>
+    <li><strong>Post URL:</strong> A direct link to a specific post (e.g., .../post/98765). Downloads only the specified post.</li>
+  </ul>
+
+  <p><strong>Interaction with Other Features:</strong> The content of this field influences "Manga Mode" and "Page Range". "Page Range" is enabled only with a creator URL.</p>
+
+  <hr>
+
+  <h2><strong>2. Creator Selection & Update (🎨)</strong></h2>
+  <p>The color palette emoji button opens the Creator Selection & Update dialog. This allows managing and downloading from a local creator database.</p>
+
+  <p><strong>Functionality:</strong></p>
+  <ul>
+    <li><strong>Creator Browser:</strong> Loads a list from <code>creators.json</code>. Search by name, service, or paste a URL to find creators.</li>
+    <li><strong>Batch Selection:</strong> Select multiple creators and click "Add Selected" to add them to the batch download session.</li>
+    <li><strong>Update Checker:</strong> Use a saved profile (.json) to download only new content based on previously fetched posts.</li>
+    <li><strong>Post Fetching & Filtering:</strong> "Fetch Posts" loads post titles, allowing you to choose specific posts for download.</li>
+  </ul>
+
+  <hr>
+
+  <h2><strong>3. Download Location Input (📁)</strong></h2>
+  <p>This input defines the destination directory for downloaded files.</p>
+
+  <p><strong>Functionality:</strong></p>
+  <ul>
+    <li><strong>Manual Entry:</strong> Enter or paste the folder path.</li>
+    <li><strong>Browse Button:</strong> Opens a system dialog to choose a folder.</li>
+    <li><strong>Directory Creation:</strong> If the folder doesn't exist, the app can create it after user confirmation.</li>
+  </ul>
+
+  <hr>
+
+  <h2><strong>4. Filter by Character(s) & Scope Button</strong></h2>
+  <p>Used to download content for specific characters or series and organize them into subfolders.</p>
+
+  <p><strong>Input Field (Filter by Character(s)):</strong></p>
+  <ul>
+    <li>Enter comma-separated names (e.g., <code>Tifa, Aerith</code>).</li>
+    <li>Group aliases using parentheses (e.g., <code>(Cloud, Zack)</code>).</li>
+    <li>Names are matched against titles, filenames, or comments.</li>
+    <li>If "Separate Folders by Known.txt" is enabled, the name becomes the subfolder name.</li>
+  </ul>
+
+  <p><strong>Scope Button Modes:</strong></p>
+  <ul>
+    <li><strong>Filter: Title</strong> (default) – Match names in post titles only.</li>
+    <li><strong>Filter: Files</strong> – Match names in filenames only.</li>
+    <li><strong>Filter: Both</strong> – Try title match first, then filenames.</li>
+    <li><strong>Filter: Comments</strong> – Try filenames first, then post comments if no match.</li>
+  </ul>
+
+  <hr>
+
+  <h2><strong>5. Skip with Words & Scope Button</strong></h2>
+  <p>Prevents downloading content based on keywords.</p>
+
+  <p><strong>Input Field (Skip with Words):</strong></p>
+  <ul>
+    <li>Enter comma-separated keywords (e.g., <code>WIP, sketch, preview</code>).</li>
+    <li>Matching is case-insensitive.</li>
+    <li>If a keyword matches, the file or post is skipped.</li>
+  </ul>
+
+  <p><strong>Scope Button Modes:</strong></p>
+  <ul>
+    <li><strong>Scope: Posts</strong> (default) – Skips post if title contains a keyword.</li>
+    <li><strong>Scope: Files</strong> – Skips individual files with keyword matches.</li>
+    <li><strong>Scope: Both</strong> – Skips entire post if title matches, otherwise filters individual files.</li>
+  </ul>
 </div>
+<div>
+  <h2><strong>Filter File Section (Radio Buttons)</strong></h2>
+  <p>This section uses a group of radio buttons to control the primary download mode, dictating which types of files are targeted. Only one of these modes can be active at a time.</p>
+
+  <ul>
+    <li>
+      <strong>All:</strong> Default mode. Downloads every file and attachment provided by the API, regardless of type.
+    </li>
+    <li>
+      <strong>Images/GIFs:</strong> Filters for common image formats (<code>.jpg</code>, <code>.png</code>, <code>.gif</code>, <code>.webp</code>), skipping non-image files.
+    </li>
+    <li>
+      <strong>Videos:</strong> Filters for common video formats like <code>.mp4</code>, <code>.webm</code>, and <code>.mov</code>, skipping all others.
+    </li>
+    <li>
+      <strong>Only Archives:</strong> Downloads only archive files (<code>.zip</code>, <code>.rar</code>). Disables "Compress to WebP" and unchecks "Skip Archives".
+    </li>
+    <li>
+      <strong>Only Audio:</strong> Filters for common audio formats like <code>.mp3</code>, <code>.wav</code>, and <code>.flac</code>.
+    </li>
+    <li>
+      <strong>Only Links:</strong> Extracts external hyperlinks from post descriptions (e.g., Mega, Google Drive) and displays them in the log. Disables all download options.
+    </li>
+    <li>
+      <strong>More:</strong> Opens the "More Options" dialog to download text-based content instead of media files.
+      <ul>
+        <li><strong>Scope:</strong> Choose to extract from post description or comments.</li>
+        <li><strong>Export Format:</strong> Save text as PDF, DOCX, or TXT.</li>
+        <li><strong>Single PDF:</strong> Optionally compile all text into one PDF.</li>
+      </ul>
+    </li>
+  </ul>
+
+  <hr>
+
+  <h2><strong>Check Box Buttons</strong></h2>
+  <p>These checkboxes provide additional toggles to refine the download behavior and enable special features.</p>
+
+  <ul>
+    <li>
+      <strong>⭐ Favorite Mode:</strong> Changes workflow to download from your personal favorites. Disables the URL input.
+      <ul>
+        <li><strong>Favorite Artists:</strong> Opens a dialog to select from your favorited creators.</li>
+        <li><strong>Favorite Posts:</strong> Opens a dialog to select from your favorited posts on Kemono and Coomer.</li>
+      </ul>
+    </li>
+    <li>
+      <strong>Skip Archives:</strong> When checked, archive files (<code>.zip</code>, <code>.rar</code>) are ignored. Disabled in "Only Archives" mode.
+    </li>
+    <li>
+      <strong>Download Thumbnail Only:</strong> Saves only thumbnail previews, not full-resolution files. Enables "Scan Content for Images".
+    </li>
+    <li>
+      <strong>Scan Content for Images:</strong> Parses post HTML for embedded images not listed in the API. Looks for <code>&lt;img&gt;</code> tags and direct image links.
+    </li>
+    <li>
+      <strong>Compress to WebP:</strong> Converts large images (over 1.5 MB) to WebP format using the Pillow library for space-saving.
+    </li>
+    <li>
+      <strong>Keep Duplicates:</strong> Provides control over duplicate handling via the "Duplicate Handling Options" dialog.
+      <ul>
+        <li><strong>Skip by Hash:</strong> Default – skip identical files.</li>
+        <li><strong>Keep Everything:</strong> Save all files regardless of duplication.</li>
+        <li><strong>Limit:</strong> Set a limit on how many copies of the same file are saved. A limit of <code>0</code> means no limit.</li>
+      </ul>
+    </li>
+  </ul>
+</div>
+<h2><strong>Folder Organization Checkboxes</strong></h2>
+<ul>
+  <li>
+    <strong>Separate folders by Known.txt:</strong> Automatically organizes downloads into folders based on name matches.
+    <ul>
+      <li>Uses "Filter by Character(s)" input first, if available.</li>
+      <li>Then checks names in <code>Known.txt</code>.</li>
+      <li>Falls back to extracting from post title.</li>
+    </ul>
+  </li>
+  <li>
+    <strong>Subfolder per post:</strong> Creates a unique folder per post, using the post’s title.
+    <ul>
+      <li>Prevents mixing files from multiple posts.</li>
+      <li>Can be combined with Known.txt-based folders.</li>
+      <li>Ensures uniqueness (e.g., <code>My Post Title_1</code>).</li>
+      <li>Automatically removes empty folders.</li>
+    </ul>
+  </li>
+  <li>
+    <strong>Date prefix:</strong> Enabled only with "Subfolder per post". Prepends the post date (e.g., <code>2025-08-03 My Post Title</code>) for chronological sorting.
+  </li>
+</ul>
+
+<h2><strong>General Functionality Checkboxes</strong></h2>
+<ul>
+  <li>
+    <strong>Use cookie:</strong> Enables login-based access via cookies.
+    <ul>
+      <li>Paste cookie string directly, or browse to select a <code>cookies.txt</code> file.</li>
+      <li>Cookies are used in all authenticated API requests.</li>
+    </ul>
+  </li>
+  <li>
+    <strong>Use Multithreading:</strong> Enables parallel downloading of posts.
+    <ul>
+      <li>Specify the number of worker threads (e.g., 10).</li>
+      <li>Disabled for Manga Mode and Only Links mode.</li>
+    </ul>
+  </li>
+  <li>
+    <strong>Show external links in log:</strong> Adds a secondary log that displays links (e.g., Mega, Dropbox) found in post text.
+  </li>
+  <li>
+    <strong>Manga/Comic mode:</strong> Sorts posts chronologically before download.
+    <ul>
+      <li>Ensures correct page order for comics/manga.</li>
+    </ul>
+    <strong>Scope Button (Name: ...):</strong> Controls filename style:
+    <ul>
+      <li><strong>Name: Post Title</strong> — e.g., <code>Chapter-1.jpg</code></li>
+      <li><strong>Name: Date + Original</strong> — e.g., <code>2025-08-03_filename.png</code></li>
+      <li><strong>Name: Date + Title</strong> — e.g., <code>2025-08-03_Chapter-1.jpg</code></li>
+      <li><strong>Name: Title+G.Num</strong> — e.g., <code>Page_001.jpg</code></li>
+      <li><strong>Name: Date Based</strong> — e.g., <code>001.jpg</code>, with optional prefix</li>
+      <li><strong>Name: Post ID</strong> — uses unique post ID as filename</li>
+    </ul>
+  </li>
+</ul>
+<h2><strong>Start Download</strong></h2>
+<ul>
+  <li>
+    <strong>Default State ("⬇️ Start Download"):</strong> When idle, this button gathers all current settings (URL, filters, checkboxes, etc.) and begins the download process via the DownloadManager.
+  </li>
+  <li>
+    <strong>Restore State:</strong> If an interrupted session is detected, the tooltip will indicate that starting a new download will discard previous session progress.
+  </li>
+  <li>
+    <strong>Update Mode (Phase 1 - "🔄 Check For Updates"):</strong> If a creator profile is loaded, clicking this button will fetch the creator's posts and compare them against your saved profile to identify new content.
+  </li>
+  <li>
+    <strong>Update Mode (Phase 2 - "⬇️ Start Download (X new)"):</strong> After new posts are found, the button text updates to reflect the number. Clicking it downloads only the new content.
+  </li>
+</ul>
+
+<h2><strong>Pause / Resume Download</strong></h2>
+<ul>
+  <li>
+    <strong>While Downloading:</strong> The button toggles between:
+    <ul>
+      <li><strong>"⏸️ Pause Download":</strong> Sets a <code>pause_event</code>, which tells all worker threads to halt their current task and wait.</li>
+      <li><strong>"▶️ Resume Download":</strong> Clears the <code>pause_event</code>, allowing threads to resume their work.</li>
+    </ul>
+  </li>
+  <li>
+    <strong>While Idle:</strong> The button is disabled.
+  </li>
+  <li>
+    <strong>Restore State:</strong> Changes to "🔄 Restore Download", which resumes the last session from saved data.
+  </li>
+</ul>
+
+<h2><strong>Cancel & Reset UI</strong></h2>
+<ul>
+  <li>
+    <strong>Functionality:</strong> Stops downloads gracefully using a <code>cancellation_event</code>. Threads finish current tasks before shutting down.
+  </li>
+  <li>
+    <strong>The Soft Reset:</strong> After cancellation is confirmed by background threads, the UI resets via the <code>download_finished</code> function. Input fields (URL and Download Location) are preserved for convenience.
+  </li>
+  <li>
+    <strong>Restore State:</strong> Changes to "🗑️ Discard Session", which deletes <code>session.json</code> and resets the UI.
+  </li>
+  <li>
+    <strong>Update State:</strong> Changes to "🗑️ Clear Selection", unloading the selected creator profile and returning to normal UI state.
+  </li>
+</ul>
+
+<h2><strong>Error Button</strong></h2>
+<ul>
+  <li>
+    <strong>Error Counter:</strong> Shows how many files failed to download (e.g., <code>(3) Error</code>). Disabled if there are no errors.
+  </li>
+  <li>
+    <strong>Error Dialog:</strong> Clicking opens the "Files Skipped Due to Errors" dialog (defined in <code>ErrorFilesDialog.py</code>), listing all failed files.
+  </li>
+  <li>
+    <strong>Dialog Features:</strong>
+    <ul>
+      <li><strong>View Failed Files:</strong> Shows filenames and related post info.</li>
+      <li><strong>Select and Retry:</strong> Retry selected failed files in a focused download session.</li>
+      <li><strong>Export URLs:</strong> Save a <code>.txt</code> file of direct download links. Optionally include post metadata with each URL.</li>
+    </ul>
+  </li>
+</ul>
+<h2><strong>"Known Area" and its Controls</strong></h2>
+<p>This section, located on the right side of the main window, manages your personal name database (<code>Known.txt</code>), which the app uses to organize downloads into subfolders.</p>
+
+<ul>
+  <li>
+    <strong>Open Known.txt:</strong> Opens the <code>Known.txt</code> file in your system's default text editor for manual editing, such as bulk changes or cleanup.
+  </li>
+  <li>
+    <strong>Search character input:</strong> A live search filter that hides any list items not matching your input text. Useful for quickly locating specific names in large lists.
+  </li>
+  <li>
+    <strong>Known Series/Characters Area:</strong> Displays all names currently stored in your <code>Known.txt</code>. These names are used when "Separate folders by Known.txt" is enabled.
+  </li>
+  <li>
+    <strong>Input at bottom & Add button:</strong> Type a new character or series name into the input field, then click "➕ Add". The app checks for duplicates, updates the list, and saves to <code>Known.txt</code>.
+  </li>
+  <li>
+    <strong>Add to Filter:</strong> Opens a dialog showing all entries from <code>Known.txt</code> with checkboxes. You can select one or more to auto-fill the "Filter by Character(s)" field at the top of the app.
+  </li>
+  <li>
+    <strong>Delete Selected:</strong> Select one or more entries from the list and click "🗑️ Delete Selected" to remove them from the app and update <code>Known.txt</code> accordingly.
+  </li>
+</ul>
+
+<h2><strong>Other Buttons</strong></h2>
+<ul>
+  <li>
+    <strong>(?_?) mark button (Help Guide):</strong> Opens a multi-page help dialog with step-by-step instructions and explanations for all app features. Useful for new users.
+  </li>
+  <li>
+    <strong>History Button:</strong> Opens the Download History dialog (from <code>DownloadHistoryDialog.py</code>), showing:
+    <ul>
+      <li>Recently downloaded files</li>
+      <li>The first few posts processed in the last session</li>
+    </ul>
+    This allows for a quick review of recent activity.
+  </li>
+  <li>
+    <strong>Settings Button:</strong> Opens the Settings dialog (from <code>FutureSettingsDialog.py</code>), where you can change app-wide settings such as theme (light/dark) and language.
+  </li>
+  <li>
+    <strong>Support Button:</strong> Opens the Support dialog (from <code>SupportDialog.py</code>), which includes developer info, source links, and donation platforms like Ko-fi or Patreon.
+  </li>
+</ul>
+<h2><strong>Log Area Controls</strong></h2>
+<p>These controls are located around the main log panel and offer tools for managing downloads, configuring advanced options, and resetting the application.</p>
+
+<ul>
+  <li>
+    <strong>Multi-part: OFF</strong><br>
+    This button acts as both a status indicator and a configuration panel for multi-part downloading (parallel downloading of large files).
+    <ul>
+      <li><strong>Function:</strong> Opens the <code>Multipart Download Options</code> dialog (defined in <code>MultipartScopeDialog.py</code>).</li>
+      <li><strong>Scope Options:</strong> Choose between "Videos Only", "Archives Only", or "Both".</li>
+      <li><strong>Number of parts:</strong> Set how many simultaneous connections to use (2–16).</li>
+      <li><strong>Minimum file size:</strong> Set a threshold (MB) below which files are downloaded normally.</li>
+      <li><strong>Status:</strong> After applying settings, the button's text updates (e.g., <code>Multi-part: Both</code>); otherwise, it resets to <code>Multi-part: OFF</code>.</li>
+    </ul>
+  </li>
+
+  <li>
+    <strong>👁️ Eye Emoji Button (Log View Toggle)</strong><br>
+    Switches between two views in the log panel:
+    <ul>
+      <li><strong>👁️ Progress Log View:</strong> Shows real-time download progress, status messages, and errors.</li>
+      <li><strong>🚫 Missed Character View:</strong> Displays names detected in posts that didn’t match the current filter — useful for updating <code>Known.txt</code>.</li>
+    </ul>
+  </li>
+
+  <li>
+    <strong>Reset Button</strong><br>
+    Performs a full "soft reset" of the UI when the application is idle.
+    <ul>
+      <li>Clears all inputs (except saved Download Location)</li>
+      <li>Resets checkboxes, buttons, and logs</li>
+      <li>Clears counters, queues, and restores the UI to its default state</li>
+      <li><strong>Note:</strong> This is different from <em>Cancel & Reset UI</em>, which halts active downloads</li>
+    </ul>
+  </li>
+</ul>
+
+<h3><strong>The Progress Log and "Only Links" Mode Controls</strong></h3>
+
+<ul>
+  <li>
+    <strong>Standard Mode (Progress Log)</strong><br>
+    This is the default behavior. The <code>main_log_output</code> field displays:
+    <ul>
+      <li>Post processing steps</li>
+      <li>Download/skipped file notifications</li>
+      <li>Error messages</li>
+      <li>Session summaries</li>
+    </ul>
+  </li>
+
+  <li>
+    <strong>"Only Links" Mode</strong><br>
+    When enabled, the log panel switches modes and reveals new controls.
+    <ul>
+      <li><strong>📜 Extracted Links Log:</strong> Replaces progress info with a list of found external links (e.g., Mega, Dropbox).</li>
+      <li><strong>Export Links Button:</strong> Saves the extracted links to a <code>.txt</code> file.</li>
+      <li><strong>Download Button:</strong> Opens the <code>Download Selected External Links</code> dialog (from <code>DownloadExtractedLinksDialog.py</code>), where you can:
+        <ul>
+          <li>View all supported external links</li>
+          <li>Select which ones to download</li>
+          <li>Begin download directly from cloud services</li>
+        </ul>
+      </li>
+      <li><strong>Links View Button:</strong> Toggles log display between:
+        <ul>
+          <li><strong>🔗 Links View:</strong> Shows all extracted links</li>
+          <li><strong>⬇️ Progress View:</strong> Shows download progress from external services (e.g., Mega)</li>
+        </ul>
+      </li>
+    </ul>
+  </li>
+</ul>

readme.md

@@ -1,4 +1,4 @@
-<h1 align="center">Kemono Downloader v6.0.0</h1>
+<h1 align="center">Kemono Downloader </h1>
 
 <div align="center">
 
@@ -41,108 +41,53 @@ Built with PyQt5, this tool is designed for users who want deep filtering capabi
 
 </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:**
-  - Download content from Kemono.su (and mirrors) and Coomer.party (and mirrors).
-  - Supports creator pages (with page range selection) and individual post URLs.
-  - Standard download controls: Start, Pause, Resume, and Cancel.
-
-- **Powerful Filtering:**
-  - **Character Filtering:** Filter content by character names. Supports simple comma-separated names and grouped names for shared folders.
-  - **Keyword Skipping:** Skip posts or files based on specified keywords.
-  - **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.
-
----
+<h3><strong>Utility & Advanced Features</strong></h3>
+<ul>
+  <li><strong>Cookie Support:</strong> Enables access to subscriber-only content via browser session cookies.</li>
+  <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>
+  <li><strong>Creator Management:</strong> Built-in creator browser and update checker for downloading only new posts from saved profiles.</li>
+  <li><strong>Error Handling:</strong> Tracks failed downloads and provides a retry dialog with options to export or redownload missing files.</li>
+</ul>
 
 ## 💻 Installation
 
@@ -154,7 +99,7 @@ Ideal for users managing large collections or syncing favorites regularly.
 ### Install Dependencies
 
 ```bash
-pip install PyQt5 requests Pillow mega.py
+pip install PyQt5 requests Pillow mega.py fpdf2 python-docx
 ```
 
 ### Running the Application
@@ -197,7 +142,7 @@ Feel free to fork this repo and submit pull requests for bug fixes, new features
 
 ## License
 
-This project is under the Custom Licence
+This project is under the MIT Licence
 
 ## Star History
 

src/core/workers.py

@@ -222,7 +222,37 @@ class PostProcessorWorker:
         if self .dynamic_filter_holder :
             return self .dynamic_filter_holder .get_filters ()
         return self .filter_character_list_objects_initial 
-    
+
+    def _find_valid_subdomain(self, url: str, max_subdomains: int = 4) -> str:
+        """
+        Attempts to find a working subdomain for a Kemono/Coomer URL that returned a 403 error.
+        Returns the original URL if no other valid subdomain is found.
+        """
+        self.logger(f"    probing for a valid subdomain...")
+        parsed_url = urlparse(url)
+        original_domain = parsed_url.netloc
+
+        for i in range(1, max_subdomains + 1):
+            domain_parts = original_domain.split('.')
+            if len(domain_parts) > 1:
+                base_domain = ".".join(domain_parts[-2:])
+                new_domain = f"n{i}.{base_domain}"
+            else:
+                continue 
+
+            new_url = parsed_url._replace(netloc=new_domain).geturl()
+            
+            try:
+                with requests.head(new_url, headers={'User-Agent': 'Mozilla/5.0'}, timeout=5, allow_redirects=True) as resp:
+                    if resp.status_code == 200:
+                        self.logger(f"   ✅ Valid subdomain found: {new_domain}")
+                        return new_url
+            except requests.RequestException:
+                continue
+        
+        self.logger(f"   ⚠️ No other valid subdomain found. Sticking with the original.")
+        return url
+
     def _download_single_file(self, file_info, target_folder_path, post_page_url, original_post_id_for_log, skip_event,
                                 post_title="", file_index_in_post=0, num_files_in_this_post=1,
                                 manga_date_file_counter_ref=None,
@@ -237,6 +267,11 @@ class PostProcessorWorker:
         if self.check_cancel() or (skip_event and skip_event.is_set()):
             return 0, 1, "", False, FILE_DOWNLOAD_STATUS_SKIPPED, None
 
+        file_download_headers = {
+            'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/115.0.0.0 Safari/537.36',
+            'Referer': post_page_url
+        }
+
         file_url = file_info.get('url')
         cookies_to_use_for_file = None
         if self.use_cookie:
@@ -255,29 +290,23 @@ class PostProcessorWorker:
                         self.logger(f"   -> Skip File (Keyword in Original Name '{skip_word}'): '{api_original_filename}'. Scope: {self.skip_words_scope}")
                         return 0, 1, api_original_filename, False, FILE_DOWNLOAD_STATUS_SKIPPED, None
 
-            cleaned_original_api_filename = clean_filename(api_original_filename)
+            cleaned_original_api_filename = robust_clean_name(api_original_filename)
             original_filename_cleaned_base, original_ext = os.path.splitext(cleaned_original_api_filename)
             if not original_ext.startswith('.'): original_ext = '.' + original_ext if original_ext else ''
 
             if self.manga_mode_active:
                 if self.manga_filename_style == STYLE_ORIGINAL_NAME:
-                    # Get the post's publication or added date
                     published_date_str = self.post.get('published')
                     added_date_str = self.post.get('added')
-                    formatted_date_str = "nodate"  # Fallback if no date is found
-
+                    formatted_date_str = "nodate"
                     date_to_use_str = published_date_str or added_date_str
-
                     if date_to_use_str:
                         try:
-                            # Extract just the YYYY-MM-DD part from the timestamp
                             formatted_date_str = date_to_use_str.split('T')[0]
                         except Exception:
                             self.logger(f"     ⚠️ Could not parse date '{date_to_use_str}'. Using 'nodate' prefix.")
                     else:
                         self.logger(f"     ⚠️ Post ID {original_post_id_for_log} has no date. Using 'nodate' prefix.")
-
-                    # Combine the date with the cleaned original filename
                     filename_to_save_in_main_path = f"{formatted_date_str}_{cleaned_original_api_filename}"
                     was_original_name_kept_flag = True
                 elif self.manga_filename_style == STYLE_POST_TITLE:
@@ -303,7 +332,7 @@ class PostProcessorWorker:
                             manga_date_file_counter_ref[0] += 1
                         base_numbered_name = f"{counter_val_for_filename:03d}"
                         if self.manga_date_prefix and self.manga_date_prefix.strip():
-                            cleaned_prefix = clean_filename(self.manga_date_prefix.strip())
+                            cleaned_prefix = robust_clean_name(self.manga_date_prefix.strip())
                             if cleaned_prefix:
                                 filename_to_save_in_main_path = f"{cleaned_prefix} {base_numbered_name}{original_ext}"
                             else:
@@ -320,7 +349,7 @@ class PostProcessorWorker:
                         with counter_lock:
                             counter_val_for_filename = manga_global_file_counter_ref[0]
                             manga_global_file_counter_ref[0] += 1
-                        cleaned_post_title_base_for_global = clean_filename(post_title.strip() if post_title and post_title.strip() else "post")
+                        cleaned_post_title_base_for_global = robust_clean_name(post_title.strip() if post_title and post_title.strip() else "post")
                         filename_to_save_in_main_path = f"{cleaned_post_title_base_for_global}_{counter_val_for_filename:03d}{original_ext}"
                     else:
                         self.logger(f"⚠️ Manga Title+GlobalNum Mode: Counter ref not provided or malformed for '{api_original_filename}'. Using original. Ref: {manga_global_file_counter_ref}")
@@ -353,7 +382,7 @@ class PostProcessorWorker:
 
                     if post_title and post_title.strip():
                         temp_cleaned_title = robust_clean_name(post_title.strip())
-                        if not temp_cleaned_title or temp_cleaned_title.startswith("untitled_file"):
+                        if not temp_cleaned_title or temp_cleaned_title.startswith("untitled_folder"):
                             self.logger(f"⚠️ Manga mode (Date+PostTitle Style): Post title for post {original_post_id_for_log} ('{post_title}') was empty or generic after cleaning. Using 'post' as title part.")
                             cleaned_post_title_for_filename = "post"
                         else:
@@ -436,7 +465,6 @@ class PostProcessorWorker:
             final_save_path_check = os.path.join(target_folder_path, filename_to_save_in_main_path)
             if os.path.exists(final_save_path_check):
                 try:
-                    # Use a HEAD request to get the expected size without downloading the body
                     with requests.head(file_url, headers=file_download_headers, timeout=15, cookies=cookies_to_use_for_file, allow_redirects=True) as head_response:
                         head_response.raise_for_status()
                         expected_size = int(head_response.headers.get('Content-Length', -1))
@@ -445,31 +473,21 @@ class PostProcessorWorker:
 
                     if expected_size != -1 and actual_size == expected_size:
                         self.logger(f"   -> Skip (File Exists & Complete): '{filename_to_save_in_main_path}' is already on disk with the correct size.")
-                        
-                        # We still need to add its hash to the session to prevent duplicates in other modes
-                        # This is a quick hash calculation for the already existing file
                         try:
                             md5_hasher = hashlib.md5()
                             with open(final_save_path_check, 'rb') as f_verify:
                                 for chunk in iter(lambda: f_verify.read(8192), b""):
                                     md5_hasher.update(chunk)
-                            
                             with self.downloaded_hash_counts_lock:
                                 self.downloaded_hash_counts[md5_hasher.hexdigest()] += 1
                         except Exception as hash_exc:
                              self.logger(f"   ⚠️ Could not hash existing file '{filename_to_save_in_main_path}' for session: {hash_exc}")
-
                         return 0, 1, filename_to_save_in_main_path, was_original_name_kept_flag, FILE_DOWNLOAD_STATUS_SKIPPED, None
                     else:
                         self.logger(f"   ⚠️ File '{filename_to_save_in_main_path}' exists but is incomplete (Expected: {expected_size}, Actual: {actual_size}). Re-downloading.")
-
                 except requests.RequestException as e:
                     self.logger(f"   ⚠️ Could not verify size of existing file '{filename_to_save_in_main_path}': {e}. Proceeding with download.")
-            file_download_headers = {
-                'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/115.0.0.0 Safari/537.36',
-                'Referer': post_page_url
-            }
-     
+        
         retry_delay = 5
         downloaded_size_bytes = 0
         calculated_file_hash = None
@@ -489,12 +507,24 @@ class PostProcessorWorker:
                 if attempt_num_single_stream > 0:
                     self.logger(f"   Retrying download for '{api_original_filename}' (Overall Attempt {attempt_num_single_stream + 1}/{max_retries + 1})...")
                     time.sleep(retry_delay * (2 ** (attempt_num_single_stream - 1)))
+                
                 self._emit_signal('file_download_status', True)
-                response = requests.get(file_url, headers=file_download_headers, timeout=(15, 300), stream=True, cookies=cookies_to_use_for_file)
-              
+                
+                current_url_to_try = file_url
+                
+                response = requests.get(current_url_to_try, headers=file_download_headers, timeout=(30, 300), stream=True, cookies=cookies_to_use_for_file)
+                
+                if response.status_code == 403 and ('kemono.cr' in current_url_to_try or 'coomer.st' in current_url_to_try):
+                    self.logger(f"   ⚠️ Got 403 Forbidden for '{api_original_filename}'. Attempting subdomain rotation...")
+                    new_url = self._find_valid_subdomain(current_url_to_try)
+                    if new_url != current_url_to_try:
+                        self.logger(f"   Retrying with new URL: {new_url}")
+                        file_url = new_url # Update the main file_url for subsequent retries
+                        response = requests.get(new_url, headers=file_download_headers, timeout=(30, 300), stream=True, cookies=cookies_to_use_for_file)
+
+
                 response.raise_for_status()
                 total_size_bytes = int(response.headers.get('Content-Length', 0))
-                # Use the dedicated parts count from the dialog, not the main thread count
                 num_parts_for_file = min(self.multipart_parts_count, MAX_PARTS_FOR_MULTIPART_DOWNLOAD)
            
                 file_is_eligible_by_scope = False
@@ -532,7 +562,7 @@ class PostProcessorWorker:
                         download_successful_flag = True
                         downloaded_size_bytes = mp_bytes
                         calculated_file_hash = mp_hash
-                        downloaded_part_file_path = mp_save_path_for_unique_part_stem_arg + ".part"
+                        downloaded_part_file_path = mp_save_path_for_unique_part_stem_arg
                         if mp_file_handle: mp_file_handle.close()
                         break
                     else:
@@ -683,26 +713,22 @@ class PostProcessorWorker:
                 self.logger(f"   🔄 Compressing '{api_original_filename}' to WebP...")
                 try:
                     with Image.open(downloaded_part_file_path) as img:
-                        # Convert to RGB to avoid issues with paletted images or alpha channels in WebP
                         if img.mode not in ('RGB', 'RGBA'):
                             img = img.convert('RGBA')
                         
-                        # Use an in-memory buffer to save the compressed image
                         output_buffer = BytesIO()
                         img.save(output_buffer, format='WebP', quality=85)
                         
-                        # This buffer now holds the compressed data
                         data_to_write_io = output_buffer
                         
-                        # Update the filename to use the .webp extension
                         base, _ = os.path.splitext(filename_to_save_in_main_path)
                         filename_to_save_in_main_path = f"{base}.webp"
                         self.logger(f"   ✅ Compression successful. New size: {len(data_to_write_io.getvalue()) / (1024*1024):.2f} MB")
 
                 except Exception as e_compress:
                     self.logger(f"   ⚠️ Failed to compress '{api_original_filename}': {e_compress}. Saving original file instead.")
-                    data_to_write_io = None # Ensure we fall back to saving the original
-
+                    data_to_write_io = None
+            
             effective_save_folder = target_folder_path
             base_name, extension = os.path.splitext(filename_to_save_in_main_path)
             counter = 1
@@ -719,17 +745,14 @@ class PostProcessorWorker:
 
             try:
                 if data_to_write_io:
-                    # Write the compressed data from the in-memory buffer
                     with open(final_save_path, 'wb') as f_out:
                         f_out.write(data_to_write_io.getvalue())
-                    # Clean up the original downloaded part file
                     if downloaded_part_file_path and os.path.exists(downloaded_part_file_path):
                         try:
                             os.remove(downloaded_part_file_path)
                         except OSError as e_rem:
                             self.logger(f"  -> Failed to remove .part after compression: {e_rem}")
                 else:
-                    # No compression was done, just rename the original file
                     if downloaded_part_file_path and os.path.exists(downloaded_part_file_path):
                         time.sleep(0.1)
                         os.rename(downloaded_part_file_path, final_save_path)
@@ -1093,6 +1116,9 @@ class PostProcessorWorker:
 
             if not self.extract_links_only and self.use_post_subfolders:
                 cleaned_post_title_for_sub = robust_clean_name(post_title)
+                max_folder_len = 100 
+                if len(cleaned_post_title_for_sub) > max_folder_len:
+                    cleaned_post_title_for_sub = cleaned_post_title_for_sub[:max_folder_len].strip()
                 post_id_for_fallback = self.post.get('id', 'unknown_id')
 
                 if not cleaned_post_title_for_sub or cleaned_post_title_for_sub == "untitled_folder":

src/services/drive_downloader.py

@@ -7,8 +7,6 @@ import base64
 import time
 from urllib.parse import urlparse, urlunparse, parse_qs, urlencode
 
-# --- Third-Party Library Imports ---
-# Make sure to install these: pip install requests pycryptodome gdown
 import requests
 
 try:
@@ -23,11 +21,8 @@ try:
 except ImportError:
     GDRIVE_AVAILABLE = False
 
-# --- Constants ---
 MEGA_API_URL = "https://g.api.mega.co.nz"
 
-# --- Helper Functions (Original and New) ---
-
 def _get_filename_from_headers(headers):
     """
     Extracts a filename from the Content-Disposition header.

src/ui/main_window.py

@@ -1023,23 +1023,42 @@ class DownloaderApp (QWidget ):
     def save_known_names(self):
         """
         Saves the current list of known names (KNOWN_NAMES) to the config file.
-        This version includes a fix to ensure the destination directory exists
-        before attempting to write the file, preventing crashes in new installations.
+        FIX: This version re-reads the file from disk before saving to preserve
+        any external edits made by the user.
         """
         global KNOWN_NAMES
         try:
             config_dir = os.path.dirname(self.config_file)
             os.makedirs(config_dir, exist_ok=True)
 
-            with open(self.config_file, 'w', encoding='utf-8') as f:
+            if os.path.exists(self.config_file):
+                self.log_signal.emit("ℹ️ Re-reading Known.txt before saving to check for external edits...")
+                disk_names = set()
+                with open(self.config_file, 'r', encoding='utf-8') as f:
+                    for line in f:
+                        disk_names.add(line.strip())
+                
                 for entry in KNOWN_NAMES:
                     if entry["is_group"]:
-                        f.write(f"({', '.join(sorted(entry['aliases'], key=str.lower))})\n")
+                        disk_names.add(f"({', '.join(sorted(entry['aliases'], key=str.lower))})")
                     else:
-                        f.write(entry["name"] + '\n')
+                        disk_names.add(entry["name"])
+                
+                with open(self.config_file, 'w', encoding='utf-8') as f:
+                    for name in sorted(list(disk_names), key=str.lower):
+                        if name: 
+                            f.write(name + '\n')
+
+            else:
+                with open(self.config_file, 'w', encoding='utf-8') as f:
+                    for entry in KNOWN_NAMES:
+                        if entry["is_group"]:
+                            f.write(f"({', '.join(sorted(entry['aliases'], key=str.lower))})\n")
+                        else:
+                            f.write(entry["name"] + '\n')
 
             if hasattr(self, 'log_signal'):
-                self.log_signal.emit(f"💾 Saved {len(KNOWN_NAMES)} known entries to {self.config_file}")
+                self.log_signal.emit(f"💾 Saved known entries to {self.config_file}")
 
         except Exception as e:
             log_msg = f"❌ Error saving config '{self.config_file}': {e}"
@@ -2994,20 +3013,22 @@ class DownloaderApp (QWidget ):
                 if api_url not in creator_profile_data['creator_url']:
                     creator_profile_data['creator_url'].append(api_url)
 
+                if self.active_update_profile:
+                    self.log_signal.emit("   Update session active: Loading existing processed post IDs to find new content.")
+                    profile_processed_ids = set(creator_profile_data.get('processed_post_ids', []))
+                
+                elif not is_restore:
+                    self.log_signal.emit("   Fresh download session: Clearing previous post history for this creator to re-download all.")
+                    if 'processed_post_ids' in creator_profile_data:
+                        creator_profile_data['processed_post_ids'] = []
+
                 creator_profile_data.setdefault('processed_post_ids', [])
                 self._save_creator_profile(creator_name_for_profile, creator_profile_data, self.session_file_path)
                 self.log_signal.emit(f"✅ Profile for '{creator_name_for_profile}' loaded/created. Settings saved.")
         
         profile_processed_ids = set()
 
-        if self.active_update_profile:
-            self.log_signal.emit("   Update session active: Loading existing processed post IDs to find new content.")
-            profile_processed_ids = set(creator_profile_data.get('processed_post_ids', []))
         
-        elif not is_restore:
-            self.log_signal.emit("   Fresh download session: Clearing previous post history for this creator to re-download all.")
-            if 'processed_post_ids' in creator_profile_data:
-                creator_profile_data['processed_post_ids'] = []
 
         session_processed_ids = set(processed_post_ids_for_restore)
         combined_processed_ids = session_processed_ids.union(profile_processed_ids)
@@ -4553,44 +4574,51 @@ class DownloaderApp (QWidget ):
             self .active_retry_futures_map [future ]=job_details 
             self .active_retry_futures .append (future )
 
-    def _execute_single_file_retry (self ,job_details ,common_args ):
-        """Executes a single file download retry attempt."""
-        dummy_post_data ={'id':job_details ['original_post_id_for_log'],'title':job_details ['post_title']}
+    def _execute_single_file_retry(self, job_details, common_args):
+        """
+        Executes a single file download retry attempt. This function is called by the retry thread pool.
+        """
+        # This worker is temporary and only for this retry task.
+        # It needs dummy post data to initialize.
+        dummy_post_data = {'id': job_details['original_post_id_for_log'], 'title': job_details['post_title']}
 
-        ppw_init_args ={
-        **common_args ,
-        'post_data':dummy_post_data ,
-        'service':job_details .get ('service','unknown_service'),
-        'user_id':job_details .get ('user_id','unknown_user'),
-        'api_url_input':job_details .get ('api_url_input',''),
-        'manga_mode_active':job_details .get ('manga_mode_active_for_file',False ),
-        'manga_filename_style':job_details .get ('manga_filename_style_for_file',STYLE_POST_TITLE ),
-        'scan_content_for_images':common_args .get ('scan_content_for_images',False ),
-        'use_cookie':common_args .get ('use_cookie',False ),
-        'cookie_text':common_args .get ('cookie_text',""),
-        'selected_cookie_file':common_args .get ('selected_cookie_file',None ),
-        'app_base_dir':common_args .get ('app_base_dir',None ),
+        # Reconstruct the post_page_url, which is needed by the download function
+        service = job_details.get('service', 'unknown_service')
+        user_id = job_details.get('user_id', 'unknown_user')
+        post_id = job_details.get('original_post_id_for_log', 'unknown_id')
+        api_url_input = job_details.get('api_url_input', '')
+        parsed_api_url = urlparse(api_url_input)
+        api_domain = parsed_api_url.netloc if parsed_api_url.netloc else self._get_domain_for_service(service)
+        post_page_url = f"https://{api_domain}/{service}/user/{user_id}/post/{post_id}"
+
+        # Prepare all arguments for the PostProcessorWorker
+        ppw_init_args = {
+            **common_args,
+            'post_data': dummy_post_data,
+            'service': service,
+            'user_id': user_id,
+            'api_url_input': api_url_input
         }
-        worker =PostProcessorWorker (**ppw_init_args )
 
-        dl_count ,skip_count ,filename_saved ,original_kept ,status ,_ =worker ._download_single_file (
-        file_info =job_details ['file_info'],
-        target_folder_path =job_details ['target_folder_path'],
-        headers =job_details ['headers'],
-        original_post_id_for_log =job_details ['original_post_id_for_log'],
-        skip_event =None ,
-        post_title =job_details ['post_title'],
-        file_index_in_post =job_details ['file_index_in_post'],
-        num_files_in_this_post =job_details ['num_files_in_this_post'],
-        forced_filename_override =job_details .get ('forced_filename_override')
+        worker = PostProcessorWorker(**ppw_init_args)
+
+        # Call the download method with the corrected arguments
+        dl_count, skip_count, filename_saved, original_kept, status, _ = worker._download_single_file(
+            file_info=job_details['file_info'],
+            target_folder_path=job_details['target_folder_path'],
+            post_page_url=post_page_url, # Using the correct argument
+            original_post_id_for_log=job_details['original_post_id_for_log'],
+            skip_event=None,
+            post_title=job_details['post_title'],
+            file_index_in_post=job_details['file_index_in_post'],
+            num_files_in_this_post=job_details['num_files_in_this_post'],
+            forced_filename_override=job_details.get('forced_filename_override')
         )
 
+        is_successful_download = (status == FILE_DOWNLOAD_STATUS_SUCCESS)
+        is_resolved_as_skipped = (status == FILE_DOWNLOAD_STATUS_SKIPPED)
 
-
-        is_successful_download =(status ==FILE_DOWNLOAD_STATUS_SUCCESS )
-        is_resolved_as_skipped =(status ==FILE_DOWNLOAD_STATUS_SKIPPED )
-
-        return is_successful_download or is_resolved_as_skipped 
+        return is_successful_download or is_resolved_as_skipped
 
     def _handle_retry_future_result (self ,future ):
         self .processed_retry_count +=1 
@@ -4687,12 +4715,10 @@ class DownloaderApp (QWidget ):
     def reset_application_state(self):
         self.log_signal.emit("🔄 Resetting application state to defaults...")
 
-        # --- MODIFIED PART: Signal all threads to stop first, but do not wait ---
         if self._is_download_active():
             self.log_signal.emit("   Cancelling all active background tasks for reset...")
-            self.cancellation_event.set() # Signal all threads to stop
+            self.cancellation_event.set() 
 
-            # Initiate non-blocking shutdowns
             if self.download_thread and self.download_thread.isRunning():
                 self.download_thread.requestInterruption()
             if self.thread_pool:
@@ -4703,9 +4729,8 @@ class DownloaderApp (QWidget ):
             if hasattr(self, 'retry_thread_pool') and self.retry_thread_pool:
                 self.retry_thread_pool.shutdown(wait=False, cancel_futures=True)
                 self.retry_thread_pool = None
-
-        self.cancellation_event.clear() # Reset the event for the next run
-        # --- END OF MODIFIED PART ---
+        
+        self.cancellation_event.clear()
 
         if self.pause_event:
             self.pause_event.clear()
@@ -4777,123 +4802,6 @@ class DownloaderApp (QWidget ):
         self.interrupted_session_data = None
         self.is_restore_pending = False
         self.last_link_input_text_for_queue_sync = ""
-
-    def _reset_ui_to_defaults(self):
-        """Resets all UI elements and relevant state to their default values."""
-        self.link_input.clear()
-        self.custom_folder_input.clear()
-        self.character_input.clear()
-        self.skip_words_input.clear()
-        self.start_page_input.clear()
-        self.end_page_input.clear()
-        self.new_char_input.clear()
-        if hasattr(self, 'remove_from_filename_input'):
-            self.remove_from_filename_input.clear()
-        self.character_search_input.clear()
-        self.thread_count_input.setText("4")
-        if hasattr(self, 'manga_date_prefix_input'):
-            self.manga_date_prefix_input.clear()
-        self.radio_all.setChecked(True)
-        self.skip_zip_checkbox.setChecked(True)
-        self.download_thumbnails_checkbox.setChecked(False)
-        self.compress_images_checkbox.setChecked(False)
-        self.use_subfolders_checkbox.setChecked(False)
-        self.use_subfolder_per_post_checkbox.setChecked(True)
-        self.use_multithreading_checkbox.setChecked(True)
-        if self.favorite_mode_checkbox:
-            self.favorite_mode_checkbox.setChecked(False)
-
-        if hasattr(self, 'keep_duplicates_checkbox'):
-            self.keep_duplicates_checkbox.setChecked(False)
-
-        self.external_links_checkbox.setChecked(False)
-        if self.manga_mode_checkbox:
-            self.manga_mode_checkbox.setChecked(False)
-        if hasattr(self, 'use_cookie_checkbox'):
-            self.use_cookie_checkbox.setChecked(False)
-        self.selected_cookie_filepath = None
-        if hasattr(self, 'cookie_text_input'):
-            self.cookie_text_input.clear()
-        if self.main_log_output:
-            self.main_log_output.clear()
-        if self.external_log_output:
-            self.external_log_output.clear()
-        if self.missed_character_log_output:
-            self.missed_character_log_output.clear()
-        self.progress_label.setText(self._tr("progress_idle_text", "Progress: Idle"))
-        self.file_progress_label.setText("")
-        self.missed_title_key_terms_count.clear()
-        self.missed_title_key_terms_examples.clear()
-        self.logged_summary_for_key_term.clear()
-        self.already_logged_bold_key_terms.clear()
-        self.missed_key_terms_buffer.clear()
-        self.permanently_failed_files_for_dialog.clear()
-        self.only_links_log_display_mode = LOG_DISPLAY_LINKS
-        self.cancellation_message_logged_this_session = False
-        self.mega_download_log_preserved_once = False
-        self.allow_multipart_download_setting = False
-        self.skip_words_scope = SKIP_SCOPE_POSTS
-        self.char_filter_scope = CHAR_SCOPE_TITLE
-        self.manga_filename_style = STYLE_POST_TITLE
-        self.favorite_download_scope = FAVORITE_SCOPE_SELECTED_LOCATION
-        self._update_skip_scope_button_text()
-        self._update_char_filter_scope_button_text()
-        self._update_manga_filename_style_button_text()
-        self._update_multipart_toggle_button_text()
-        self._update_favorite_scope_button_text()
-        self.current_log_view = 'progress'
-        self.is_paused = False
-        if self.pause_event:
-            self.pause_event.clear()
-    
-        self.external_link_queue.clear()
-        self.extracted_links_cache = []
-        self._is_processing_external_link_queue = False
-        self._current_link_post_title = None
-        if self.download_extracted_links_button:
-            self.download_extracted_links_button.setEnabled(False)
-        self.favorite_download_queue.clear()
-        self.is_processing_favorites_queue = False
-        self.current_processing_favorite_item_info = None
-        self.interrupted_session_data = None
-        self.is_restore_pending = False
-        self.last_link_input_text_for_queue_sync = ""
-        self._update_button_states_and_connections()
-        self.total_posts_to_process = 0
-        self.processed_posts_count = 0
-        self.download_counter = 0
-        self.skip_counter = 0
-        self.all_kept_original_filenames = []
-        if self.log_view_stack:
-            self.log_view_stack.setCurrentIndex(0)
-        if self.progress_log_label:
-            self.progress_log_label.setText(self._tr("progress_log_label_text", "📜 Progress Log:"))
-        if self.log_verbosity_toggle_button:
-            self.log_verbosity_toggle_button.setText(self.EYE_ICON)
-            self.log_verbosity_toggle_button.setToolTip("Current View: Progress Log. Click to switch to Missed Character Log.")
-        self.filter_character_list("")
-        self._handle_multithreading_toggle(self.use_multithreading_checkbox.isChecked())
-        self.update_ui_for_manga_mode(False)
-        self.update_custom_folder_visibility(self.link_input.text())
-        self.update_page_range_enabled_state()
-        self._update_cookie_input_visibility(False)
-        self._update_cookie_input_placeholders_and_tooltips()
-        self.download_btn.setEnabled(True)
-        self.cancel_btn.setEnabled(False)
-        if self.reset_button:
-            self.reset_button.setEnabled(True)
-            self.reset_button.setText(self._tr("reset_button_text", "🔄 Reset"))
-            self.reset_button.setToolTip(self._tr("reset_button_tooltip", "Reset all inputs and logs to default state (only when idle)."))
-        if hasattr(self, 'favorite_mode_checkbox'):
-            self._handle_favorite_mode_toggle(False)
-        if hasattr(self, 'scan_content_images_checkbox'):
-            self.scan_content_images_checkbox.setChecked(False)
-        if hasattr(self, 'download_thumbnails_checkbox'):
-            self._handle_thumbnail_mode_change(self.download_thumbnails_checkbox.isChecked())
-    
-        self.set_ui_enabled(True)
-        self.log_signal.emit("✅ UI reset to defaults. Ready for new operation.")
-        self._update_button_states_and_connections()
         
     def _show_feature_guide (self ):
         steps_content_keys =[