Commit

LICENSE

@@ -1,11 +1,21 @@
-Custom License - No Commercial Use
+MIT License
 
-Copyright [Yuvi9587] [2025]
+Copyright (c) [2025] [Yuvi9587]
 
-Permission is hereby granted to any person obtaining a copy of this software and associated documentation files (the "Software"), to use, copy, modify, and distribute the Software for **non-commercial purposes only**, subject to the following conditions:
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
 
-1. The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+The above copyright notice and this permission notice shall be included in all
-2. Proper credit must be given to the original author in any public use, distribution, or derivative works.
+copies or substantial portions of the Software.
-3. Commercial use, resale, or sublicensing of the Software or any derivative works is strictly prohibited without explicit written permission.
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND...
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

features.md

@@ -1,192 +1,147 @@
-# Kemono Downloader - Feature Guide
+<div>
-This guide provides a comprehensive overview of all user interface elements, input fields, buttons, popups, and functionalities available in the Kemono Downloader.
+    <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>
-## 1. Main Interface & Workflow
+    <hr>
-These are the primary controls you'll interact with to initiate and manage downloads.
+    <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>
-### 1.1. Core Inputs
+    <h3><strong>Primary Inputs (Top-Left)</strong></h3>
-**🔗 Creator/Post URL Input Field**  
+    <ul>
-- **Purpose**: Paste the URL of the content you want to download.  
+        <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>
-- **Supported Sites**: Kemono.su, Coomer.party, Simpcity.su.  
+        <li><strong>🎨 Creator Selection Popup</strong>: This button opens a powerful dialog listing all known creators. From here, you can:
-- **Supported URL Types**:  
+            <ul>
-  - Creator pages (e.g., `https://kemono.su/patreon/user/12345`).  
+                <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>
-  - Individual posts (e.g., `https://kemono.su/patreon/user/12345/post/98765`).  
+                <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>
-- **Note**: When ⭐ Favorite Mode is active, this field is disabled. For Simpcity.su URLs, the "Use Cookie" option is mandatory and auto-enabled.
+            </ul>
-
+        </li>
-**🎨 Creator Selection Button**  
+        <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>
-- **Icon**: 🎨 (Artist Palette)  
+        <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>
-- **Purpose**: Opens the "Creator Selection" dialog to browse and queue downloads from known creators.  
+    </ul>
-- **Dialog Features**:  
+    <hr>
-  - Loads creators from `creators.json`.  
+    <h2><strong>Filtering & Naming (Left Panel)</strong></h2>
-  - **Search Bar**: Filter creators by name.  
+    <p>These features give you precise control over what gets downloaded and how it's named and organized.</p>
-  - **Creator List**: Displays creators with their service (e.g., Patreon, Fanbox).  
+    <ul>
-  - **Selection**: Checkboxes to select one or more creators.  
+        <li><strong>Filter by Character(s)</strong>: A powerful tool to download content featuring specific characters. You can enter multiple names separated by commas.
-  - **Download Scope**: Organize downloads by Characters or Creators.  
+            <ul>
-  - **Add to Queue**: Adds selected creators or their posts to the download queue.
+                <li><strong>Filter: [Scope] Button</strong>: This button changes how the character filter works:
-
+                    <ul>
-**Page Range (Start to End) Input Fields**  
+                        <li><strong>Title</strong>: Downloads posts only if a character's name is in the post title.</li>
-- **Purpose**: Specify a range of pages to fetch for creator URLs.  
+                        <li><strong>Files</strong>: Downloads posts if a character's name is in any of the filenames within the post.</li>
-- **Usage**: Enter the starting and ending page numbers.  
+                        <li><strong>Both</strong>: Combines the "Title" and "Files" logic.</li>
-- **Behavior**:  
+                        <li><strong>Comments (Beta)</strong>: Downloads a post if a character's name is mentioned in the comments section.</li>
-  - If blank, all pages are processed.  
+                    </ul>
-  - Disabled for single post URLs.
+                </li>
-
+            </ul>
-**📁 Download Location Input Field & Browse Button**  
+        </li>
-- **Purpose**: Specify the main directory for downloaded files.  
+        <li><strong>Skip with Words</strong>: A keyword-based filter to avoid unwanted content (e.g., <code>WIP</code>, <code>sketch</code>).
-- **Usage**: Type the path or click "Browse..." to select a folder.  
+            <ul>
-- **Requirement**: Mandatory for all download operations.
+                <li><strong>Scope: [Type] Button</strong>: This button changes how the skip filter works:
-
+                    <ul>
-### 1.2. Action Buttons
+                        <li><strong>Posts</strong>: Skips the entire post if a keyword is found in the title.</li>
-**⬇️ Start Download / 🔗 Extract Links Button**  
+                        <li><strong>Files</strong>: Skips only individual files if a keyword is found in the filename.</li>
-- **Purpose**: Initiates downloading or link extraction.  
+                        <li><strong>Both</strong>: Applies both levels of skipping.</li>
-- **Behavior**:  
+                    </ul>
-  - Shows "🔗 Extract Links" if "Only Links" is selected.  
+                </li>
-  - Otherwise, shows "⬇️ Start Download".  
+            </ul>
-  - Supports single-threaded or multi-threaded downloads based on settings.
+        </li>
-
+        <li><strong>Remove Words from name</strong>: Automatically cleans downloaded filenames by removing any specified words (e.g., "patreon," "HD").</li>
-**🔄 Restore Download Button**  
+    </ul>
-- **Visibility**: Appears if an incomplete session is detected on startup.  
+    <h3><strong>File Type Filter (Radio Buttons)</strong></h3>
-- **Purpose**: Resumes a previously interrupted download session.
+    <p>This section lets you choose the kind of content you want:</p>
-
+    <ul>
-**⏸️ Pause / ▶️ Resume Download Button**  
+        <li><strong>All, Images/GIFs, Videos, 🎧 Only Audio, 📦 Only Archives</strong>: These options filter the downloads to only include the selected file types.</li>
-- **Purpose**: Pause or resume the ongoing download.  
+        <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>
-- **Behavior**: Toggles between "Pause" and "Resume". Some UI settings can be changed while paused.
+        <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>
-**❌ Cancel & Reset UI Button**  
+    <hr>
-- **Purpose**: Stops the current operation and performs a "soft" reset.  
+    <h2><strong>Download Options & Advanced Settings (Checkboxes)</strong></h2>
-- **Behavior**: Halts background threads, preserves URL and Download Location inputs, resets other settings.
+    <ul>
-
+        <li><strong>Skip .zip</strong>: A simple toggle to ignore archive files during downloads.</li>
-**🔄 Reset Button (in the log area)**  
+        <li><strong>Download Thumbnails Only</strong>: Downloads only the small preview images instead of the full-resolution files.</li>
-- **Purpose**: Performs a "hard" reset when no operation is active.  
+        <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>
-- **Behavior**: Clears all inputs, resets options to default, and clears logs.
+        <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>
-## 2. Filtering & Content Selection
+        <li><strong>Subfolder per Post</strong>: Organizes downloads by creating a unique folder for each post, named after the post's title.</li>
-These options allow precise control over downloaded content.
+        <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>
-### 2.1. Content Filtering
+        <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>
-**🎯 Filter by Character(s) Input Field**  
+        <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>
-- **Purpose**: Download content related to specific characters or series.  
+        <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>
-- **Usage**: Enter comma-separated character names.  
+    </ul>
-- **Advanced Syntax**:  
+    <hr>
-  - `Nami`: Simple filter.  
+    <h2><strong>Known Names Management (Bottom-Left)</strong></h2>
-  - `(Vivi, Ulti)`: Grouped filter. Matches posts with "Vivi" OR "Ulti". Creates a shared folder like `Vivi Ulti` if subfolders are enabled.  
+    <p>This powerful feature automates the creation of organized, named folders.</p>
-  - `(Boa, Hancock)~`: Aliased filter. Treats "Boa" and "Hancock" as the same entity.
+    <ul>
-
+        <li><strong>Known Shows/Characters List</strong>: Displays all the names and groups you've saved.</li>
-**Filter: [Type] Button (Character Filter Scope)**  
+        <li><strong>Search...</strong>: Filters the list to quickly find a name.</li>
-- **Purpose**: Defines where the character filter is applied. Cycles on click.  
+        <li><strong>Open Known.txt</strong>: Opens the source file in a text editor for advanced manual editing.</li>
-- **Options**:  
+        <li><strong>Add New Name</strong>:
-  - **Filter: Title** (Default): Matches post titles.  
+            <ul>
-  - **Filter: Files**: Matches filenames.  
+                <li><strong>Single Name</strong>: Typing <code>Tifa Lockhart</code> and clicking <strong>➕ Add</strong> creates an entry that will match "Tifa Lockhart".</li>
-  - **Filter: Both**: Checks title first, then filenames.  
+                <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>
-  - **Filter: Comments (Beta)**: Checks filenames, then post comments.
+            </ul>
-
+        </li>
-**🚫 Skip with Words Input Field**  
+        <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>
-- **Purpose**: Exclude posts/files with specified keywords (e.g., `WIP`, `sketch`).
+        <li><strong>🗑️ Delete Selected</strong>: Removes highlighted names from your list.</li>
-
+    </ul>
-**Scope: [Type] Button (Skip Words Scope)**  
+    <hr>
-- **Purpose**: Defines where skip words are applied. Cycles on click.  
+    <h2><strong>Action Buttons & Status Controls</strong></h2>
-- **Options**:  
+    <ul>
-  - **Scope: Posts** (Default): Skips posts if the title contains a skip word.  
+        <li><strong>⬇️ Start Download / 🔗 Extract Links</strong>: The main action button. Its function is dynamic:
-  - **Scope: Files**: Skips files if the filename contains a skip word.  
+            <ul>
-  - **Scope: Both**: Applies both rules.
+                <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>
-**✂️ Remove Words from Name Input Field**  
+                <li><strong>Update Confirmation</strong>: After new posts are found, it changes to <strong>⬇️ Start Download (X new)</strong>.</li>
-- **Purpose**: Remove unwanted text from filenames (e.g., `patreon`, `[HD]`).
+                <li><strong>Link Extraction Mode</strong>: The text changes to <strong>🔗 Extract Links</strong>.</li>
-
+            </ul>
-### 2.2. File Type Filtering
+        </li>
-**Filter Files (Radio Buttons)**  
+        <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>
-- **Purpose**: Select file types to download.  
+        <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>
-- **Options**:  
+        <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:
-  - **All**: All file types.  
+            <ul>
-  - **Images/GIFs**: Common image formats.  
+                <li>Select specific files to <strong>Retry</strong> downloading.</li>
-  - **Videos**: Common video formats.  
+                <li><strong>Export</strong> the list of failed URLs to a <code>.txt</code> file.</li>
-  - **🎧 Only Audio**: Common audio formats.  
+            </ul>
-  - **📦 Only Archives**: Only `.zip` and `.rar` files.  
+        </li>
-  - **🔗 Only Links**: Extracts external links without downloading files.
+        <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>
-**Skip .zip / Skip .rar Checkboxes**  
+        <li><strong>📜 (History)</strong>: Opens the Download History dialog.</li>
-- **Purpose**: Skip downloading `.zip` or `.rar` files.  
+        <li><strong>? (Help)</strong>: Opens a helpful guide explaining the application's features.</li>
-- **Behavior**: Disabled when "📦 Only Archives" is active.
+        <li><strong>❤️ Support</strong>: Opens a dialog with information on how to support the developer.</li>
-
+    </ul>
-## 3. Download Customization
+    <hr>
-Options to refine the download process and output.
+    <h2><strong>Specialized Modes & Features</strong></h2>
-
+    <h3><strong>⭐ Favorite Mode</strong></h3>
-- **Download Thumbnails Only**: Downloads small preview images instead of full-resolution files.  
+    <p>Activating this mode transforms the UI for managing saved collections:</p>
-- **Scan Content for Images**: Scans post HTML for `<img>` tags, crucial for images in descriptions.  
+    <ul>
-- **Compress to WebP**: Converts images to WebP format (requires Pillow library).
+        <li>The URL input is disabled.</li>
-- **Keep Duplicates**: Normally, if a post contains multiple files with the same name, only the first is downloaded. Checking this option will download all of them, renaming subsequent unique files with a numeric suffix (e.g., `image_1.jpg`).
+        <li>The main action buttons are replaced with:
-- **🗄️ Custom Folder Name (Single Post Only)**: Specify a custom folder name for a single post's content (appears if subfolders are enabled).
+            <ul>
-
+                <li><strong>🖼️ Favorite Artists</strong>: Opens a dialog to browse and queue downloads from your saved favorite creators.</li>
-## 4. 📖 Manga/Comic Mode
+                <li><strong>📄 Favorite Posts</strong>: Opens a dialog to browse and queue downloads for specific saved favorite posts.</li>
-A mode for downloading creator feeds in chronological order, ideal for sequential content.
+            </ul>
-
+        </li>
-- **Activation**: Active when downloading a creator's entire feed (not a single post).  
+        <li><strong>Scope: [Location] Button</strong>: Toggles where the favorited content is saved:
-- **Core Behavior**: Fetches all posts, processing from oldest to newest.  
+            <ul>
-- **Filename Style Toggle Button (in the log area)**:  
+                <li><strong>Selected Location</strong>: Saves all content directly into the main "Download Location".</li>
-  - **Purpose**: Controls file naming in Manga Mode. Cycles on click.  
+                <li><strong>Artist Folders</strong>: Creates a subfolder for each artist inside the main "Download Location".</li>
-  - **Options**:  
+            </ul>
-    - **Name: Post Title**: First file named after post title; others keep original names.  
+        </li>
-    - **Name: Original File**: Files keep server-provided names, with optional prefix.  
+    </ul>
-    - **Name: Title+G.Num**: Global numbering with post title prefix (e.g., `Chapter 1_001.jpg`).  
+    <h3><strong>📖 Manga/Comic Mode</strong></h3>
-    - **Name: Date Based**: Sequential naming by post date (e.g., `001.jpg`), with optional prefix.  
+    <p>This mode is designed for sequential content and has several effects:</p>
-    - **Name: Post ID**: Files named after post ID to avoid clashes.  
+    <ul>
-    - **Name: Date + Title**: Combines post date and title for filenames.
+        <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>
-## 5. Folder Organization & Known.txt
+        <li><strong>Disables Multithreading (for certain styles)</strong>: To guarantee perfect sequential numbering, multithreading for posts is automatically disabled for certain naming styles.</li>
-Controls for structuring downloaded content.
+    </ul>
-
+    <h3><strong>Session & Error Management</strong></h3>
-- **Separate Folders by Name/Title Checkbox**: Enables automatic subfolder creation.  
+    <ul>
-- **Subfolder per Post Checkbox**: Creates subfolders for each post, named after the post title.  
+        <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>
-- **Date Prefix for Post Subfolders Checkbox**: When used with "Subfolder per Post," this option prefixes the folder name with the post's upload date (e.g., `2025-07-11 Post Title`), allowing for chronological sorting.
+        <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>
-- **Known.txt Management UI (Bottom Left)**:  
+    </ul>
-  - **Purpose**: Manages a local `Known.txt` file for series, characters, or terms used in folder creation.  
+    <h3><strong>Logging & Monitoring</strong></h3>
-  - **List Display**: Shows primary names from `Known.txt`.  
+    <ul>
-  - **➕ Add Button**: Adds names or groups (e.g., `(Character A, Alias B)~`).  
+        <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>
-  - **⤵️ Add to Filter Button**: Select names from `Known.txt` for the character filter.  
+        <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>
-  - **🗑️ Delete Selected Button**: Removes selected names from `Known.txt`.  
+    </ul>
-  - **Open Known.txt Button**: Opens the file in the default text editor.  
+</div>
-  - **❓ Help Button**: Opens this feature guide.  
-  - **📜 History Button**: Views recent download history.
-
-## 6. ⭐ Favorite Mode (Kemono.su Only)
-Download from favorited artists/posts on Kemono.su.
-
-- **Enable Checkbox ("⭐ Favorite Mode")**:  
-  - Switches to Favorite Mode.  
-  - Disables the main URL input.  
-  - Changes action buttons to "Favorite Artists" and "Favorite Posts".  
-  - Requires cookies.  
-- **🖼️ Favorite Artists Button**: Select and download from favorited artists.  
-- **📄 Favorite Posts Button**: Select and download specific favorited posts.  
-- **Favorite Download Scope Button**:  
-  - **Scope: Selected Location**: Downloads favorites to the main directory.  
-  - **Scope: Artist Folders**: Creates subfolders per artist.
-
-## 7. Advanced Settings & Performance
-- **🍪 Cookie Management**:  
-  - **Use Cookie Checkbox**: Enables cookies for restricted content.  
-  - **Cookie Text Field**: Paste cookie string.  
-  - **Browse... Button**: Select a `cookies.txt` file (Netscape format).  
-- **Use Multithreading Checkbox & Threads Input**:  
-  - **Purpose**: Configures simultaneous operations.  
-  - **Behavior**: Sets concurrent post processing (creator feeds) or file downloads (single posts).  
-- **Multi-part Download Toggle Button**:  
-  - **Purpose**: Enables/disables multi-segment downloading for large files.  
-  - **Note**: Best for large files; less efficient for small files.
-
-## 8. Logging, Monitoring & Error Handling
-- **📜 Progress Log Area**: Displays messages, progress, and errors.  
-- **👁️ / 🙈 Log View Toggle Button**: Switches between Progress Log and Missed Character Log (skipped posts).  
-- **Show External Links in Log**: Displays external links (e.g., Mega, Google Drive) in a secondary panel.  
-- **Export Links Button**: Saves extracted links to a `.txt` file in "Only Links" mode.  
-- **Download Extracted Links Button**: Downloads files from supported external links in "Only Links" mode.  
-- **🆘 Error Button & Dialog**:  
-  - **Purpose**: Active if files fail to download. The button will display a live count of failed files (e.g., **(3) Error**).  
-  - **Dialog Features**:  
-    - Lists failed files.  
-    - Retry failed downloads.  
-    - Export failed URLs to a text file.
-
-## 9. Application Settings (⚙️)
-- **Appearance**: Switch between Light and Dark themes.  
-- **Language**: Change UI language (restart required).

src/config/constants.py

@@ -59,6 +59,7 @@ LANGUAGE_KEY = "currentLanguageV1"
 DOWNLOAD_LOCATION_KEY = "downloadLocationV1"
 RESOLUTION_KEY = "window_resolution"
 UI_SCALE_KEY = "ui_scale_factor"
+SAVE_CREATOR_JSON_KEY = "saveCreatorJsonProfile"
 
 # --- UI Constants and Identifiers ---
 HTML_PREFIX = "<!HTML!>"

src/core/manager.py

@@ -41,6 +41,9 @@ class DownloadManager:
         self.total_downloads = 0
         self.total_skips = 0
         self.all_kept_original_filenames = []
+        self.creator_profiles_dir = None
+        self.current_creator_name_for_profile = None
+        self.current_creator_profile_path = None
 
     def _log(self, message):
         """Puts a progress message into the queue for the UI."""
@@ -58,6 +61,13 @@ class DownloadManager:
         if self.is_running:
             self._log("❌ Cannot start a new session: A session is already in progress.")
             return
+        
+        creator_profile_data = self._setup_creator_profile(config)
+        creator_profile_data['settings'] = config
+        creator_profile_data.setdefault('processed_post_ids', [])
+        self._save_creator_profile(creator_profile_data)
+        self._log(f"✅ Loaded/created profile for '{self.current_creator_name_for_profile}'. Settings saved.")
+
         self.is_running = True
         self.cancellation_event.clear()
         self.pause_event.clear()
@@ -72,11 +82,11 @@ class DownloadManager:
         is_manga_sequential = config.get('manga_mode_active') and config.get('manga_filename_style') in [STYLE_DATE_BASED, STYLE_POST_TITLE_GLOBAL_NUMBERING]
 
         should_use_multithreading_for_posts = use_multithreading and not is_single_post and not is_manga_sequential
-
+        
         if should_use_multithreading_for_posts:
             fetcher_thread = threading.Thread(
                 target=self._fetch_and_queue_posts_for_pool,
-                args=(config, restore_data),
+                args=(config, restore_data, creator_profile_data), # Add argument here
                 daemon=True
             )
             fetcher_thread.start()
@@ -112,6 +122,11 @@ class DownloadManager:
         try:
             num_workers = min(config.get('num_threads', 4), MAX_THREADS)
             self.thread_pool = ThreadPoolExecutor(max_workers=num_workers, thread_name_prefix='PostWorker_')
+
+            session_processed_ids = set(restore_data['processed_post_ids']) if restore_data else set()
+            profile_processed_ids = set(creator_profile_data.get('processed_post_ids', []))
+            processed_ids = session_processed_ids.union(profile_processed_ids)
+
             if restore_data:
                 all_posts = restore_data['all_posts_data']
                 processed_ids = set(restore_data['processed_post_ids'])
@@ -144,7 +159,7 @@ class DownloadManager:
             if self.thread_pool:
                 self.thread_pool.shutdown(wait=True)
             self.is_running = False
-            self._log("🏁 All processing tasks have completed.")
+            self._log("🏁 All processing tasks have completed or been cancelled.") 
             self.progress_queue.put({
                 'type': 'finished',
                 'payload': (self.total_downloads, self.total_skips, self.cancellation_event.is_set(), self.all_kept_original_filenames)
@@ -196,12 +211,52 @@ class DownloadManager:
                         self.progress_queue.put({'type': 'permanent_failure', 'payload': (permanent,)})
                     if history:
                         self.progress_queue.put({'type': 'post_processed_history', 'payload': (history,)})
+                        post_id = history.get('post_id')
+                        if post_id and self.current_creator_profile_path:
+                            profile_data = self._setup_creator_profile({'creator_name_for_profile': self.current_creator_name_for_profile, 'session_file_path': self.session_file_path})
+                            if post_id not in profile_data.get('processed_post_ids', []):
+                                profile_data.setdefault('processed_post_ids', []).append(post_id)
+                                self._save_creator_profile(profile_data)
 
             except Exception as e:
                 self._log(f"❌ Worker task resulted in an exception: {e}")
                 self.total_skips += 1 # Count errored posts as skipped
             self.progress_queue.put({'type': 'overall_progress', 'payload': (self.total_posts, self.processed_posts)})
 
+    def _setup_creator_profile(self, config):
+        """Prepares the path and loads data for the current creator's profile."""
+        self.current_creator_name_for_profile = config.get('creator_name_for_profile')
+        if not self.current_creator_name_for_profile:
+            self._log("⚠️ Cannot create creator profile: Name not provided in config.")
+            return {}
+
+        appdata_dir = os.path.dirname(config.get('session_file_path', '.'))
+        self.creator_profiles_dir = os.path.join(appdata_dir, "creator_profiles")
+        os.makedirs(self.creator_profiles_dir, exist_ok=True)
+
+        safe_filename = clean_folder_name(self.current_creator_name_for_profile) + ".json"
+        self.current_creator_profile_path = os.path.join(self.creator_profiles_dir, safe_filename)
+
+        if os.path.exists(self.current_creator_profile_path):
+            try:
+                with open(self.current_creator_profile_path, 'r', encoding='utf-8') as f:
+                    return json.load(f)
+            except (json.JSONDecodeError, OSError) as e:
+                self._log(f"❌ Error loading creator profile '{safe_filename}': {e}. Starting fresh.")
+        return {}
+
+    def _save_creator_profile(self, data):
+        """Saves the provided data to the current creator's profile file."""
+        if not self.current_creator_profile_path:
+            return
+        try:
+            temp_path = self.current_creator_profile_path + ".tmp"
+            with open(temp_path, 'w', encoding='utf-8') as f:
+                json.dump(data, f, indent=2)
+            os.replace(temp_path, self.current_creator_profile_path)
+        except OSError as e:
+            self._log(f"❌ Error saving creator profile to '{self.current_creator_profile_path}': {e}")
+
     def cancel_session(self):
         """Cancels the current running session."""
         if not self.is_running:

src/core/workers.py

@@ -238,13 +238,24 @@ class PostProcessorWorker:
 
             if self.manga_mode_active:
                 if self.manga_filename_style == STYLE_ORIGINAL_NAME:
-                    filename_to_save_in_main_path = cleaned_original_api_filename
+                    # Get the post's publication or added date
-                    if self.manga_date_prefix and self.manga_date_prefix.strip():
+                    published_date_str = self.post.get('published')
-                        cleaned_prefix = clean_filename(self.manga_date_prefix.strip())
+                    added_date_str = self.post.get('added')
-                        if cleaned_prefix:
+                    formatted_date_str = "nodate"  # Fallback if no date is found
-                            filename_to_save_in_main_path = f"{cleaned_prefix} {filename_to_save_in_main_path}"
+
-                        else:
+                    date_to_use_str = published_date_str or added_date_str
-                            self.logger(f"⚠️ Manga Original Name Mode: Provided prefix '{self.manga_date_prefix}' was empty after cleaning. Using original name only.")
+
+                    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:
                     if post_title and post_title.strip():
@@ -582,6 +593,33 @@ class PostProcessorWorker:
                         os.remove(downloaded_part_file_path)
                     except OSError: pass
                 return 0, 1, filename_to_save_in_main_path, was_original_name_kept_flag, FILE_DOWNLOAD_STATUS_SKIPPED, None
+            
+            if (self.compress_images and downloaded_part_file_path and
+                    is_image(api_original_filename) and
+                    os.path.getsize(downloaded_part_file_path) > 1.5 * 1024 * 1024):
+                
+                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
 
             effective_save_folder = target_folder_path
             base_name, extension = os.path.splitext(filename_to_save_in_main_path)
@@ -599,15 +637,17 @@ 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:
-                        time.sleep(0.05)
                         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)
@@ -680,7 +720,6 @@ class PostProcessorWorker:
             else:
                 return 0, 1, filename_to_save_in_main_path, was_original_name_kept_flag, FILE_DOWNLOAD_STATUS_FAILED_RETRYABLE_LATER, details_for_failure
 
-
     def process(self):
 
         result_tuple = (0, 0, [], [], [], None, None)
@@ -848,17 +887,6 @@ class PostProcessorWorker:
                     result_tuple = (0, num_potential_files_in_post, [], [], [], None, None)
                     return result_tuple
 
-            if self.skip_words_list and (self.skip_words_scope == SKIP_SCOPE_POSTS or self.skip_words_scope == SKIP_SCOPE_BOTH):
-                if self._check_pause(f"Skip words (post title) for post {post_id}"):
-                    result_tuple = (0, num_potential_files_in_post, [], [], [], None, None)
-                    return result_tuple
-                post_title_lower = post_title.lower()
-                for skip_word in self.skip_words_list:
-                    if skip_word.lower() in post_title_lower:
-                        self.logger(f"   -> Skip Post (Keyword in Title '{skip_word}'): '{post_title[:50]}...'. Scope: {self.skip_words_scope}")
-                        result_tuple = (0, num_potential_files_in_post, [], [], [], None, None)
-                        return result_tuple
-
             if not self.extract_links_only and self.manga_mode_active and current_character_filters and (self.char_filter_scope == CHAR_SCOPE_TITLE or self.char_filter_scope == CHAR_SCOPE_BOTH) and not post_is_candidate_by_title_char_match:
                 self.logger(f"   -> Skip Post (Manga Mode with Title/Both Scope - No Title Char Match): Title '{post_title[:50]}' doesn't match filters.")
                 self._emit_signal('missed_character_post', post_title, "Manga Mode: No title match for character filter (Title/Both scope)")
@@ -869,6 +897,7 @@ class PostProcessorWorker:
                 self.logger(f"⚠️ Corrupt attachment data for post {post_id} (expected list, got {type(post_attachments)}). Skipping attachments.")
                 post_attachments = []
 
+            # CORRECTED LOGIC: Determine folder path BEFORE skip checks
             base_folder_names_for_post_content = []
             determined_post_save_path_for_history = self.override_output_dir if self.override_output_dir else self.download_root
             if not self.extract_links_only and self.use_subfolders:
@@ -1017,6 +1046,28 @@ class PostProcessorWorker:
                         break
                 determined_post_save_path_for_history = os.path.join(base_path_for_post_subfolder, final_post_subfolder_name)
 
+            if self.skip_words_list and (self.skip_words_scope == SKIP_SCOPE_POSTS or self.skip_words_scope == SKIP_SCOPE_BOTH):
+                if self._check_pause(f"Skip words (post title) for post {post_id}"):
+                    result_tuple = (0, num_potential_files_in_post, [], [], [], None, None)
+                    return result_tuple
+                post_title_lower = post_title.lower()
+                for skip_word in self.skip_words_list:
+                    if skip_word.lower() in post_title_lower:
+                        self.logger(f"   -> Skip Post (Keyword in Title '{skip_word}'): '{post_title[:50]}...'. Scope: {self.skip_words_scope}")
+                        # Create a history object for the skipped post to record its ID
+                        history_data_for_skipped_post = {
+                            'post_id': post_id,
+                            'service': self.service,
+                            'user_id': self.user_id,
+                            'post_title': post_title,
+                            'top_file_name': "N/A (Post Skipped)",
+                            'num_files': num_potential_files_in_post,
+                            'upload_date_str': post_data.get('published') or post_data.get('added') or "Unknown",
+                            'download_location': determined_post_save_path_for_history
+                        }
+                        result_tuple = (0, num_potential_files_in_post, [], [], [], history_data_for_skipped_post, None)
+                        return result_tuple
+
             if self.filter_mode == 'text_only' and not self.extract_links_only:
                 self.logger(f"   Mode: Text Only (Scope: {self.text_only_scope})")
                 post_title_lower = post_title.lower()
@@ -1385,7 +1436,17 @@ class PostProcessorWorker:
 
             if not all_files_from_post_api:
                 self.logger(f"   No files found to download for post {post_id}.")
-                result_tuple = (0, 0, [], [], [], None, None)
+                history_data_for_no_files_post = {
+                    'post_title': post_title,
+                    'post_id': post_id,
+                    'service': self.service,
+                    'user_id': self.user_id,
+                    'top_file_name': "N/A (No Files)",
+                    'num_files': 0,
+                    'upload_date_str': post_data.get('published') or post_data.get('added') or "Unknown",
+                    'download_location': determined_post_save_path_for_history
+                }
+                result_tuple = (0, 0, [], [], [], history_data_for_no_files_post, None)
                 return result_tuple
 
             files_to_download_info_list = []

src/services/drive_downloader.py

@@ -15,9 +15,9 @@ except ImportError:
 
 try:
     import gdown
-    GDOWN_AVAILABLE = True
+    GDRIVE_AVAILABLE = True
 except ImportError:
-    GDOWN_AVAILABLE = False
+    GDRIVE_AVAILABLE = False
 
 # --- Helper Functions ---
 
@@ -46,75 +46,76 @@ def _get_filename_from_headers(headers):
 
 # --- Main Service Downloader Functions ---
 
-def download_mega_file(mega_link, download_path=".", logger_func=print):
+def download_mega_file(mega_url, download_path, logger_func=print):
     """
-    Downloads a file from a public Mega.nz link.
+    Downloads a file from a Mega.nz URL.
-
+    Handles both public links and links that include a decryption key.
-    Args:
-        mega_link (str): The public Mega.nz link to the file.
-        download_path (str): The directory to save the downloaded file.
-        logger_func (callable): Function to use for logging.
     """
     if not MEGA_AVAILABLE:
-        logger_func("❌ Error: mega.py library is not installed. Cannot download from Mega.")
+        logger_func("❌ Mega download failed: 'mega.py' library is not installed.")
-        logger_func("   Please install it: pip install mega.py")
+        return
-        raise ImportError("mega.py library not found.")
 
     logger_func(f"   [Mega] Initializing Mega client...")
     try:
-        mega_client = Mega()
+        mega = Mega()
-        m = mega_client.login()
+        # Anonymous login is sufficient for public links
-        logger_func(f"   [Mega] Attempting to download from: {mega_link}")
+        m = mega.login()
-        
-        if not os.path.exists(download_path):
-            os.makedirs(download_path, exist_ok=True)
-            logger_func(f"   [Mega] Created download directory: {download_path}")
-            
-        # The download_url method handles file info fetching and saving internally.
-        downloaded_file_path = m.download_url(mega_link, dest_path=download_path)
 
-        if downloaded_file_path and os.path.exists(downloaded_file_path):
+        # --- MODIFIED PART: Added error handling for invalid links ---
-            logger_func(f"   [Mega] ✅ File downloaded successfully! Saved as: {downloaded_file_path}")
+        try:
-        else:
+            file_details = m.find(mega_url)
-            raise Exception(f"Mega download failed or file not found. Returned: {downloaded_file_path}")
+            if file_details is None:
+                logger_func(f"   [Mega] ❌ Download failed. The link appears to be invalid or has been taken down: {mega_url}")
+                return
+        except (ValueError, json.JSONDecodeError) as e:
+            # This block catches the "Expecting value" error
+            logger_func(f"   [Mega] ❌ Download failed. The link is likely invalid or expired. Error: {e}")
+            return
+        except Exception as e:
+            # Catch other potential errors from the mega.py library
+            logger_func(f"   [Mega] ❌ An unexpected error occurred trying to access the link: {e}")
+            return
+        # --- END OF MODIFIED PART ---
+
+        filename = file_details[1]['a']['n']
+        logger_func(f"   [Mega] File found: '{filename}'. Starting download...")
+
+        # Sanitize filename before saving
+        safe_filename = "".join([c for c in filename if c.isalpha() or c.isdigit() or c in (' ', '.', '_', '-')]).rstrip()
+        final_path = os.path.join(download_path, safe_filename)
+
+        # Check if file already exists
+        if os.path.exists(final_path):
+            logger_func(f"   [Mega] ℹ️ File '{safe_filename}' already exists. Skipping download.")
+            return
+
+        # Start the download
+        m.download_url(mega_url, dest_path=download_path, dest_filename=safe_filename)
+        logger_func(f"   [Mega] ✅ Successfully downloaded '{safe_filename}' to '{download_path}'")
 
     except Exception as e:
-        logger_func(f"   [Mega] ❌ An unexpected error occurred during Mega download: {e}")
+        logger_func(f"   [Mega] ❌ An unexpected error occurred during the Mega download process: {e}")
-        traceback.print_exc(limit=2)
-        raise  # Re-raise the exception to be handled by the calling worker
 
-def download_gdrive_file(gdrive_link, download_path=".", logger_func=print):
+def download_gdrive_file(url, download_path, logger_func=print):
-    """
+    """Downloads a file from a Google Drive link."""
-    Downloads a file from a public Google Drive link using the gdown library.
+    if not GDRIVE_AVAILABLE:
-
+        logger_func("❌ Google Drive download failed: 'gdown' library is not installed.")
-    Args:
+        return
-        gdrive_link (str): The public Google Drive link to the file.
-        download_path (str): The directory to save the downloaded file.
-        logger_func (callable): Function to use for logging.
-    """
-    if not GDOWN_AVAILABLE:
-        logger_func("❌ Error: gdown library is not installed. Cannot download from Google Drive.")
-        logger_func("   Please install it: pip install gdown")
-        raise ImportError("gdown library not found.")
-
-    logger_func(f"   [GDrive] Attempting to download: {gdrive_link}")
     try:
-        if not os.path.exists(download_path):
+        logger_func(f"   [G-Drive] Starting download for: {url}")
-            os.makedirs(download_path, exist_ok=True)
+        # --- MODIFIED PART: Added a message and set quiet=True ---
-            logger_func(f"   [GDrive] Created download directory: {download_path}")
+        logger_func("   [G-Drive] Download in progress... This may take some time. Please wait.")
-
+        
-        # gdown handles finding the file ID and downloading. 'fuzzy=True' helps with various URL formats.
+        # By setting quiet=True, the progress bar will no longer be printed to the terminal.
-        output_file_path = gdown.download(gdrive_link, output=download_path, quiet=False, fuzzy=True)
+        output_path = gdown.download(url, output=download_path, quiet=True, fuzzy=True)
-
+        # --- END OF MODIFIED PART ---
-        if output_file_path and os.path.exists(output_file_path):
+        
-            logger_func(f"   [GDrive] ✅ Google Drive file downloaded successfully: {output_file_path}")
+        if output_path and os.path.exists(output_path):
+            logger_func(f"   [G-Drive] ✅ Successfully downloaded to '{output_path}'")
         else:
-            raise Exception(f"gdown download failed or file not found. Returned: {output_file_path}")
+            logger_func(f"   [G-Drive] ❌ Download failed. The file may have been moved, deleted, or is otherwise inaccessible.")
-
     except Exception as e:
-        logger_func(f"   [GDrive] ❌ An error occurred during Google Drive download: {e}")
+        logger_func(f"   [G-Drive] ❌ An unexpected error occurred: {e}")
-        traceback.print_exc(limit=2)
-        raise
 
 def download_dropbox_file(dropbox_link, download_path=".", logger_func=print):
     """

src/ui/dialogs/EmptyPopupDialog.py

@@ -13,7 +13,7 @@ from PyQt5.QtCore import pyqtSignal, QCoreApplication, QSize, QThread, QTimer, Q
 from PyQt5.QtWidgets import (
     QApplication, QDialog, QHBoxLayout, QLabel, QLineEdit, QListWidget,
     QListWidgetItem, QMessageBox, QPushButton, QVBoxLayout, QAbstractItemView,
-    QSplitter, QProgressBar, QWidget
+    QSplitter, QProgressBar, QWidget, QFileDialog  
 )
 
 # --- Local Application Imports ---
@@ -151,6 +151,8 @@ class EmptyPopupDialog (QDialog ):
         app_icon =get_app_icon_object ()
         if app_icon and not app_icon .isNull ():
             self .setWindowIcon (app_icon )
+        self.update_profile_data = None
+        self.update_creator_name = None
         self .selected_creators_for_queue =[]
         self .globally_selected_creators ={}
         self .fetched_posts_data ={}
@@ -205,6 +207,9 @@ class EmptyPopupDialog (QDialog ):
         self .scope_button .clicked .connect (self ._toggle_scope_mode )
         left_bottom_buttons_layout .addWidget (self .scope_button )
         left_pane_layout .addLayout (left_bottom_buttons_layout )
+        self.update_button = QPushButton()
+        self.update_button.clicked.connect(self._handle_update_check) 
+        left_bottom_buttons_layout.addWidget(self.update_button)
 
 
         self .right_pane_widget =QWidget ()
@@ -315,6 +320,31 @@ class EmptyPopupDialog (QDialog ):
             except AttributeError :
                 pass 
 
+    def _handle_update_check(self):
+        """Opens a dialog to select a creator profile and loads it for an update session."""
+        appdata_dir = os.path.join(self.app_base_dir, "appdata")
+        profiles_dir = os.path.join(appdata_dir, "creator_profiles")
+        
+        if not os.path.isdir(profiles_dir):
+            QMessageBox.warning(self, "Directory Not Found", f"The creator profiles directory does not exist yet.\n\nPath: {profiles_dir}")
+            return
+
+        filepath, _ = QFileDialog.getOpenFileName(self, "Select Creator Profile for Update", profiles_dir, "JSON Files (*.json)")
+
+        if filepath:
+            try:
+                with open(filepath, 'r', encoding='utf-8') as f:
+                    data = json.load(f)
+                
+                if 'creator_url' not in data or 'processed_post_ids' not in data:
+                    raise ValueError("Invalid profile format.")
+
+                self.update_profile_data = data
+                self.update_creator_name = os.path.basename(filepath).replace('.json', '')
+                self.accept() # Close the dialog and signal success
+            except Exception as e:
+                QMessageBox.critical(self, "Error Loading Profile", f"Could not load or parse the selected profile file:\n\n{e}")
+
     def _handle_fetch_posts_click (self ):
         selected_creators =list (self .globally_selected_creators .values ())
         print(f"[DEBUG] Selected creators for fetch: {selected_creators}")
@@ -370,6 +400,7 @@ class EmptyPopupDialog (QDialog ):
         self .add_selected_button .setText (self ._tr ("creator_popup_add_selected_button","Add Selected"))
         self .fetch_posts_button .setText (self ._tr ("fetch_posts_button_text","Fetch Posts"))
         self ._update_scope_button_text_and_tooltip ()
+        self.update_button.setText(self._tr("check_for_updates_button", "Check for Updates"))
 
         self .posts_search_input .setPlaceholderText (self ._tr ("creator_popup_posts_search_placeholder","Search fetched posts by title..."))
 
@@ -938,6 +969,9 @@ class EmptyPopupDialog (QDialog ):
                     self .parent_app .link_input .setPlaceholderText (
                     self .parent_app ._tr ("items_in_queue_placeholder","{count} items in queue from popup.").format (count =total_in_queue )
                     )
+            
+            self.selected_creators_for_queue.clear()
+            
             self .accept ()
         else :
             QMessageBox .information (self ,self ._tr ("no_selection_title","No Selection"),
@@ -1003,4 +1037,4 @@ class EmptyPopupDialog (QDialog ):
         else :
             if unique_key in self .globally_selected_creators :
                 del self .globally_selected_creators [unique_key ]
-        self .fetch_posts_button .setEnabled (bool (self .globally_selected_creators ))
+        self .fetch_posts_button .setEnabled (bool (self .globally_selected_creators ))

src/ui/dialogs/FutureSettingsDialog.py

@@ -6,7 +6,7 @@ import json
 from PyQt5.QtCore import Qt, QStandardPaths
 from PyQt5.QtWidgets import (
     QApplication, QDialog, QHBoxLayout, QLabel, QPushButton, QVBoxLayout,
-    QGroupBox, QComboBox, QMessageBox, QGridLayout
+    QGroupBox, QComboBox, QMessageBox, QGridLayout, QCheckBox
 )
 
 # --- Local Application Imports ---
@@ -15,7 +15,7 @@ from ...utils.resolution import get_dark_theme
 from ..main_window import get_app_icon_object
 from ...config.constants import (
     THEME_KEY, LANGUAGE_KEY, DOWNLOAD_LOCATION_KEY,
-    RESOLUTION_KEY, UI_SCALE_KEY
+    RESOLUTION_KEY, UI_SCALE_KEY, SAVE_CREATOR_JSON_KEY 
 )
 
 
@@ -35,7 +35,7 @@ class FutureSettingsDialog(QDialog):
 
         screen_height = QApplication.primaryScreen().availableGeometry().height() if QApplication.primaryScreen() else 800
         scale_factor = screen_height / 800.0
-        base_min_w, base_min_h = 420, 320 # Adjusted height for new layout
+        base_min_w, base_min_h = 420, 360 # Adjusted height for new layout
         scaled_min_w = int(base_min_w * scale_factor)
         scaled_min_h = int(base_min_h * scale_factor)
         self.setMinimumSize(scaled_min_w, scaled_min_h)
@@ -93,6 +93,11 @@ class FutureSettingsDialog(QDialog):
         download_window_layout.addWidget(self.default_path_label, 1, 0)
         download_window_layout.addWidget(self.save_path_button, 1, 1)
 
+        # Save Creator.json Checkbox
+        self.save_creator_json_checkbox = QCheckBox()
+        self.save_creator_json_checkbox.stateChanged.connect(self._creator_json_setting_changed) 
+        download_window_layout.addWidget(self.save_creator_json_checkbox, 2, 0, 1, 2)
+
         main_layout.addWidget(self.download_window_group_box)
 
         main_layout.addStretch(1)
@@ -102,6 +107,20 @@ class FutureSettingsDialog(QDialog):
         self.ok_button.clicked.connect(self.accept)
         main_layout.addWidget(self.ok_button, 0, Qt.AlignRight | Qt.AlignBottom)
 
+    def _load_checkbox_states(self):
+        """Loads the initial state for all checkboxes from settings."""
+        self.save_creator_json_checkbox.blockSignals(True)
+        # Default to True so the feature is on by default for users
+        should_save = self.parent_app.settings.value(SAVE_CREATOR_JSON_KEY, True, type=bool)
+        self.save_creator_json_checkbox.setChecked(should_save)
+        self.save_creator_json_checkbox.blockSignals(False)
+
+    def _creator_json_setting_changed(self, state):
+        """Saves the state of the 'Save Creator.json' checkbox."""
+        is_checked = state == Qt.Checked
+        self.parent_app.settings.setValue(SAVE_CREATOR_JSON_KEY, is_checked)
+        self.parent_app.settings.sync()
+
     def _tr(self, key, default_text=""):
         if callable(get_translation) and self.parent_app:
             return get_translation(self.parent_app.current_selected_language, key, default_text)
@@ -122,6 +141,7 @@ class FutureSettingsDialog(QDialog):
         # Download & Window Group Labels
         self.window_size_label.setText(self._tr("window_size_label", "Window Size:"))
         self.default_path_label.setText(self._tr("default_path_label", "Default Path:"))
+        self.save_creator_json_checkbox.setText(self._tr("save_creator_json_label", "Save Creator.json file"))
         
         # Buttons and Controls
         self._update_theme_toggle_button_text()
@@ -132,6 +152,7 @@ class FutureSettingsDialog(QDialog):
         # Populate dropdowns
         self._populate_display_combo_boxes()
         self._populate_language_combo_box()
+        self._load_checkbox_states()
 
     def _apply_theme(self):
         if self.parent_app and self.parent_app.current_theme == "dark":

src/utils/resolution.py

@@ -239,16 +239,23 @@ def setup_ui(main_app):
     checkboxes_group_layout.addWidget(advanced_settings_label)
     advanced_row1_layout = QHBoxLayout()
     advanced_row1_layout.setSpacing(10)
-    main_app.use_subfolders_checkbox = QCheckBox("Separate Folders by Known.txt")
+
-    main_app.use_subfolders_checkbox.setChecked(True)
+    # --- REORDERED CHECKBOXES ---
-    main_app.use_subfolders_checkbox.toggled.connect(main_app.update_ui_for_subfolders)
-    advanced_row1_layout.addWidget(main_app.use_subfolders_checkbox)
     main_app.use_subfolder_per_post_checkbox = QCheckBox("Subfolder per Post")
     main_app.use_subfolder_per_post_checkbox.toggled.connect(main_app.update_ui_for_subfolders)
+    main_app.use_subfolder_per_post_checkbox.setChecked(True)    
     advanced_row1_layout.addWidget(main_app.use_subfolder_per_post_checkbox)
+
     main_app.date_prefix_checkbox = QCheckBox("Date Prefix")
     main_app.date_prefix_checkbox.setToolTip("When 'Subfolder per Post' is active, prefix the folder name with the post's upload date.")
     advanced_row1_layout.addWidget(main_app.date_prefix_checkbox)
+    
+    main_app.use_subfolders_checkbox = QCheckBox("Separate Folders by Known.txt")
+    main_app.use_subfolders_checkbox.setChecked(False)
+    main_app.use_subfolders_checkbox.toggled.connect(main_app.update_ui_for_subfolders)
+    advanced_row1_layout.addWidget(main_app.use_subfolders_checkbox)
+    # --- END REORDER ---
+
     main_app.use_cookie_checkbox = QCheckBox("Use Cookie")
     main_app.use_cookie_checkbox.setChecked(main_app.use_cookie_setting)
     main_app.cookie_text_input = QLineEdit()
@@ -380,7 +387,7 @@ def setup_ui(main_app):
     main_app.link_search_input.setPlaceholderText("Search Links...")
     main_app.link_search_input.setVisible(False)
     log_title_layout.addWidget(main_app.link_search_input)
-    main_app.link_search_button = QPushButton("🔍")
+    main_app.link_search_button = QPushButton("<EFBFBD>")
     main_app.link_search_button.setVisible(False)
     main_app.link_search_button.setFixedWidth(int(30 * scale))
     log_title_layout.addWidget(main_app.link_search_button)