Update LICENSE

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.
-2. Proper credit must be given to the original author in any public use, distribution, or derivative works.
-3. Commercial use, resale, or sublicensing of the Software or any derivative works is strictly prohibited without explicit written permission.
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
 
-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.

downloader_utils.py

@@ -8,9 +8,11 @@ import hashlib
 import http .client 
 import traceback 
 from concurrent .futures import ThreadPoolExecutor ,Future ,CancelledError ,as_completed 
+from collections import deque 
 import html 
 from PyQt5 .QtCore import QObject ,pyqtSignal ,QThread ,QMutex ,QMutexLocker 
 from urllib .parse import urlparse 
+import uuid 
 try :
     from mega import Mega 
 
@@ -40,6 +42,7 @@ from io import BytesIO
 STYLE_POST_TITLE ="post_title"
 STYLE_ORIGINAL_NAME ="original_name"
 STYLE_DATE_BASED ="date_based"
+STYLE_DATE_POST_TITLE ="date_post_title"
 MANGA_DATE_PREFIX_DEFAULT =""
 STYLE_POST_TITLE_GLOBAL_NUMBERING ="post_title_global_numbering"
 SKIP_SCOPE_FILES ="files"
@@ -508,13 +511,31 @@ def fetch_post_comments (api_domain ,service ,user_id ,post_id ,headers ,logger
         raise RuntimeError (f"Error decoding JSON from comments API for post {post_id } ({comments_api_url }): {e }. Response text: {response .text [:200 ]}")
     except Exception as e :
         raise RuntimeError (f"Unexpected error fetching comments for post {post_id } ({comments_api_url }): {e }")
-def download_from_api (api_url_input ,logger =print ,start_page =None ,end_page =None ,manga_mode =False ,
-cancellation_event =None ,pause_event =None ,use_cookie =False ,cookie_text ="",selected_cookie_file =None ,app_base_dir =None ):
-    headers ={'User-Agent':'Mozilla/5.0','Accept':'application/json'}
+def download_from_api (
+api_url_input ,
+logger =print ,
+start_page =None ,
+end_page =None ,
+manga_mode =False ,
+cancellation_event =None ,
+pause_event =None ,
+use_cookie =False ,
+cookie_text ="",
+selected_cookie_file =None ,
+app_base_dir =None ,
+manga_filename_style_for_sort_check =None 
+):
+    headers ={
+    'User-Agent':'Mozilla/5.0',
+    'Accept':'application/json'
+    }
+
     service ,user_id ,target_post_id =extract_post_info (api_url_input )
+
     if cancellation_event and cancellation_event .is_set ():
         logger ("   Download_from_api cancelled at start.")
         return 
+
     parsed_input_url_for_domain =urlparse (api_url_input )
     api_domain =parsed_input_url_for_domain .netloc 
     if not any (d in api_domain .lower ()for d in ['kemono.su','kemono.party','coomer.su','coomer.party']):
@@ -551,11 +572,12 @@ cancellation_event =None ,pause_event =None ,use_cookie =False ,cookie_text ="",
         return 
     if target_post_id and (start_page or end_page ):
         logger ("⚠️ Page range (start/end page) is ignored when a specific post URL is provided (searching all pages for the post).")
-    is_creator_feed_for_manga =manga_mode and not target_post_id 
+
+    is_manga_mode_fetch_all_and_sort_oldest_first =manga_mode and (manga_filename_style_for_sort_check !=STYLE_DATE_POST_TITLE )and not target_post_id 
     api_base_url =f"https://{api_domain }/api/v1/{service }/user/{user_id }"
     page_size =50 
-    if is_creator_feed_for_manga :
-        logger ("   Manga Mode: Fetching posts to sort by date (oldest processed first)...")
+    if is_manga_mode_fetch_all_and_sort_oldest_first :
+        logger (f"   Manga Mode (Style: {manga_filename_style_for_sort_check if manga_filename_style_for_sort_check else 'Default'} - Oldest First Sort Active): Fetching all posts to sort by date...")
         all_posts_for_manga_mode =[]
         current_offset_manga =0 
         if start_page and start_page >1 :
@@ -634,6 +656,12 @@ cancellation_event =None ,pause_event =None ,use_cookie =False ,cookie_text ="",
                     break 
                 yield all_posts_for_manga_mode [i :i +page_size ]
         return 
+
+
+
+    if manga_mode and not target_post_id and (manga_filename_style_for_sort_check ==STYLE_DATE_POST_TITLE ):
+        logger (f"   Manga Mode (Style: {STYLE_DATE_POST_TITLE }): Processing posts in default API order (newest first).")
+
     current_page_num =1 
     current_offset =0 
     processed_target_post_flag =False 
@@ -726,8 +754,10 @@ class PostProcessorSignals (QObject ):
     file_download_status_signal =pyqtSignal (bool )
     external_link_signal =pyqtSignal (str ,str ,str ,str ,str )
     file_progress_signal =pyqtSignal (str ,object )
+    file_successfully_downloaded_signal =pyqtSignal (dict )
     missed_character_post_signal =pyqtSignal (str ,str )
 class PostProcessorWorker :
+
     def __init__ (self ,post_data ,download_root ,known_names ,
     filter_character_list ,emitter ,
     unwanted_keywords ,filter_mode ,skip_zip ,skip_rar ,
@@ -835,7 +865,7 @@ class PostProcessorWorker :
     post_title ="",file_index_in_post =0 ,num_files_in_this_post =1 ,
     manga_date_file_counter_ref =None ):
         was_original_name_kept_flag =False 
-        manga_global_file_counter_ref =None 
+
         final_filename_saved_for_return =""
     def _get_current_character_filters (self ):
         if self .dynamic_filter_holder :
@@ -845,7 +875,7 @@ class PostProcessorWorker :
     post_title ="",file_index_in_post =0 ,num_files_in_this_post =1 ,
     manga_date_file_counter_ref =None ,
     forced_filename_override =None ,
-    manga_global_file_counter_ref =None ):
+    manga_global_file_counter_ref =None ,folder_context_name_for_history =None ):
         was_original_name_kept_flag =False 
         final_filename_saved_for_return =""
         retry_later_details =None 
@@ -947,6 +977,48 @@ class PostProcessorWorker :
                         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 }")
                         filename_to_save_in_main_path =cleaned_original_api_filename 
                         self .logger (f"⚠️ Manga mode (Title+GlobalNum Style Fallback): Using cleaned original filename '{filename_to_save_in_main_path }' for post {original_post_id_for_log }.")
+                elif self .manga_filename_style ==STYLE_DATE_POST_TITLE :
+                    published_date_str =self .post .get ('published')
+                    added_date_str =self .post .get ('added')
+                    formatted_date_str ="nodate"
+
+                    if published_date_str :
+                        try :
+                            formatted_date_str =published_date_str .split ('T')[0 ]
+                        except Exception :
+                            self .logger (f"    ⚠️ Could not parse 'published' date '{published_date_str }' for STYLE_DATE_POST_TITLE. Using 'nodate'.")
+                    elif added_date_str :
+                        try :
+                            formatted_date_str =added_date_str .split ('T')[0 ]
+                            self .logger (f"    ⚠️ Post ID {original_post_id_for_log } missing 'published' date, using 'added' date '{added_date_str }' for STYLE_DATE_POST_TITLE naming.")
+                        except Exception :
+                            self .logger (f"    ⚠️ Could not parse 'added' date '{added_date_str }' for STYLE_DATE_POST_TITLE. Using 'nodate'.")
+                    else :
+                        self .logger (f"    ⚠️ Post ID {original_post_id_for_log } missing both 'published' and 'added' dates for STYLE_DATE_POST_TITLE. Using 'nodate'.")
+
+                    if post_title and post_title .strip ():
+                        temp_cleaned_title =clean_filename (post_title .strip ())
+                        if not temp_cleaned_title or temp_cleaned_title .startswith ("untitled_file"):
+                            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 :
+                            cleaned_post_title_for_filename =temp_cleaned_title 
+
+                        base_name_for_style =f"{formatted_date_str }_{cleaned_post_title_for_filename }"
+
+                        if num_files_in_this_post >1 :
+                            filename_to_save_in_main_path =f"{base_name_for_style }_{file_index_in_post }{original_ext }"if file_index_in_post >0 else f"{base_name_for_style }{original_ext }"
+                        else :
+                            filename_to_save_in_main_path =f"{base_name_for_style }{original_ext }"
+                    else :
+                        self .logger (f"⚠️ Manga mode (Date+PostTitle Style): Post title missing for post {original_post_id_for_log }. Using 'post' as title part with date prefix.")
+                        cleaned_post_title_for_filename ="post"
+                        base_name_for_style =f"{formatted_date_str }_{cleaned_post_title_for_filename }"
+                        if num_files_in_this_post >1 :
+                            filename_to_save_in_main_path =f"{base_name_for_style }_{file_index_in_post }{original_ext }"if file_index_in_post >0 else f"{base_name_for_style }{original_ext }"
+                        else :
+                            filename_to_save_in_main_path =f"{base_name_for_style }{original_ext }"
+                        self .logger (f"⚠️ Manga mode (Title+GlobalNum Style Fallback): Using cleaned original filename '{filename_to_save_in_main_path }' for post {original_post_id_for_log }.")
                 else :
                     self .logger (f"⚠️ Manga mode: Unknown filename style '{self .manga_filename_style }'. Defaulting to original filename for '{api_original_filename }'.")
                     filename_to_save_in_main_path =cleaned_original_api_filename 
@@ -1016,6 +1088,14 @@ class PostProcessorWorker :
         except OSError as e :
             self .logger (f"   ❌ Critical error creating directory '{target_folder_path }': {e }. Skipping file '{api_original_filename }'.")
             return 0 ,1 ,api_original_filename ,False ,FILE_DOWNLOAD_STATUS_SKIPPED ,None 
+
+
+
+
+
+        temp_file_base_for_unique_part ,temp_file_ext_for_unique_part =os .path .splitext (filename_to_save_in_main_path if filename_to_save_in_main_path else api_original_filename )
+        unique_id_for_part_file =uuid .uuid4 ().hex [:8 ]
+        unique_part_file_stem_on_disk =f"{temp_file_base_for_unique_part }_{unique_id_for_part_file }"
         max_retries =3 
         retry_delay =5 
         downloaded_size_bytes =0 
@@ -1026,8 +1106,9 @@ class PostProcessorWorker :
         download_successful_flag =False 
         last_exception_for_retry_later =None 
 
-
+        response_for_this_attempt =None 
         for attempt_num_single_stream in range (max_retries +1 ):
+            response_for_this_attempt =None 
             if self ._check_pause (f"File download attempt for '{api_original_filename }'"):break 
             if self .check_cancel ()or (skip_event and skip_event .is_set ()):break 
             try :
@@ -1045,11 +1126,17 @@ class PostProcessorWorker :
                 if self ._check_pause (f"Multipart decision for '{api_original_filename }'"):break 
 
                 if attempt_multipart :
-                    response .close ()
-                    self ._emit_signal ('file_download_status',False )
-                    mp_save_path_base_for_part =os .path .join (target_folder_path ,filename_to_save_in_main_path )
+                    if response_for_this_attempt :
+                        response_for_this_attempt .close ()
+                        response_for_this_attempt =None 
+
+
+
+
+
+                    mp_save_path_for_unique_part_stem_arg =os .path .join (target_folder_path ,f"{unique_part_file_stem_on_disk }{temp_file_ext_for_unique_part }")
                     mp_success ,mp_bytes ,mp_hash ,mp_file_handle =download_file_in_parts (
-                    file_url ,mp_save_path_base_for_part ,total_size_bytes ,num_parts_for_file ,headers ,api_original_filename ,
+                    file_url ,mp_save_path_for_unique_part_stem_arg ,total_size_bytes ,num_parts_for_file ,headers ,api_original_filename ,
                     emitter_for_multipart =self .emitter ,cookies_for_chunk_session =cookies_to_use_for_file ,
                     cancellation_event =self .cancellation_event ,skip_event =skip_event ,logger_func =self .logger ,
                     pause_event =self .pause_event 
@@ -1060,7 +1147,8 @@ class PostProcessorWorker :
                         calculated_file_hash =mp_hash 
 
 
-                        downloaded_part_file_path =mp_save_path_base_for_part +".part"
+
+                        downloaded_part_file_path =mp_save_path_for_unique_part_stem_arg +".part"
                         was_multipart_download =True 
                         if mp_file_handle :mp_file_handle .close ()
                         break 
@@ -1071,11 +1159,13 @@ class PostProcessorWorker :
                             download_successful_flag =False ;break 
                 else :
                     self .logger (f"⬇️ Downloading (Single Stream): '{api_original_filename }' (Size: {total_size_bytes /(1024 *1024 ):.2f} MB if known) [Base Name: '{filename_to_save_in_main_path }']")
-                    current_single_stream_part_path =os .path .join (target_folder_path ,filename_to_save_in_main_path +".part")
+
+                    current_single_stream_part_path =os .path .join (target_folder_path ,f"{unique_part_file_stem_on_disk }{temp_file_ext_for_unique_part }.part")
                     current_attempt_downloaded_bytes =0 
                     md5_hasher =hashlib .md5 ()
                     last_progress_time =time .time ()
 
+                    single_stream_exception =None 
                     try :
                         with open (current_single_stream_part_path ,'wb')as f_part :
                             for chunk in response .iter_content (chunk_size =1 *1024 *1024 ):
@@ -1093,40 +1183,45 @@ class PostProcessorWorker :
                             if os .path .exists (current_single_stream_part_path ):os .remove (current_single_stream_part_path )
                             break 
 
-                        # Determine if this single-stream download attempt was complete
-                        attempt_is_complete = False
-                        if response.status_code == 200: # Ensure basic success
-                            if total_size_bytes > 0: # Content-Length was provided
-                                if current_attempt_downloaded_bytes == total_size_bytes:
-                                    attempt_is_complete = True
-                                else:
-                                    self.logger(f"   ⚠️ Single-stream attempt for '{api_original_filename}' incomplete: received {current_attempt_downloaded_bytes} of {total_size_bytes} bytes.")
-                            elif total_size_bytes == 0: # Server reported 0-byte file (Content-Length: 0)
-                                if current_attempt_downloaded_bytes == 0: # And we got 0 bytes
-                                    attempt_is_complete = True
-                                else: # Server said 0 bytes, but we got some.
-                                    self.logger(f"   ⚠️ Mismatch for '{api_original_filename}': Server reported 0 bytes, but received {current_attempt_downloaded_bytes} bytes this attempt.")
-                            # Case: No Content-Length header, so total_size_bytes became 0 from int(headers.get('Content-Length',0)).
-                            # And we actually received some bytes.
-                            elif current_attempt_downloaded_bytes > 0 : # Implicitly total_size_bytes == 0 here due to previous conditions
-                                attempt_is_complete = True
-                                self.logger(f"   ⚠️ Single-stream for '{api_original_filename}' received {current_attempt_downloaded_bytes} bytes (no Content-Length from server). Assuming complete for this attempt as stream ended.")
 
-                        if attempt_is_complete:
-                            calculated_file_hash = md5_hasher.hexdigest()
-                            downloaded_size_bytes = current_attempt_downloaded_bytes
-                            downloaded_part_file_path = current_single_stream_part_path
-                            was_multipart_download = False # Ensure this is set for single stream success
-                            download_successful_flag = True # Mark THE ENTIRE DOWNLOAD as successful
-                            break # Break from the RETRY loop (attempt_num_single_stream)
-                        else: # This attempt was not successful (e.g., incomplete or 0 bytes when not expected)
-                            if os .path .exists (current_single_stream_part_path ):os .remove (current_single_stream_part_path )
-                            # Let the retry loop continue if more attempts are left; download_successful_flag remains False for this attempt.
+                        attempt_is_complete =False 
+                        if response .status_code ==200 :
+                            if total_size_bytes >0 :
+                                if current_attempt_downloaded_bytes ==total_size_bytes :
+                                    attempt_is_complete =True 
+                                else :
+                                    self .logger (f"   ⚠️ Single-stream attempt for '{api_original_filename }' incomplete: received {current_attempt_downloaded_bytes } of {total_size_bytes } bytes.")
+                            elif total_size_bytes ==0 :
+                                if current_attempt_downloaded_bytes ==0 :
+                                    attempt_is_complete =True 
+                                else :
+                                    self .logger (f"   ⚠️ Mismatch for '{api_original_filename }': Server reported 0 bytes, but received {current_attempt_downloaded_bytes } bytes this attempt.")
+
+
+                            elif current_attempt_downloaded_bytes >0 :
+                                attempt_is_complete =True 
+                                self .logger (f"   ⚠️ Single-stream for '{api_original_filename }' received {current_attempt_downloaded_bytes } bytes (no Content-Length from server). Assuming complete for this attempt as stream ended.")
+
+                        if attempt_is_complete :
+                            calculated_file_hash =md5_hasher .hexdigest ()
+                            downloaded_size_bytes =current_attempt_downloaded_bytes 
+                            downloaded_part_file_path =current_single_stream_part_path 
+                            was_multipart_download =False 
+                            download_successful_flag =True 
+                            break 
+                        else :
+                            if os .path .exists (current_single_stream_part_path ):
+                                try :os .remove (current_single_stream_part_path )
+                                except OSError as e_rem_part :self .logger (f"  -> Failed to remove .part file after failed single stream attempt: {e_rem_part }")
+
                     except Exception as e_write :
                         self .logger (f"   ❌ Error writing single-stream to disk for '{api_original_filename }': {e_write }")
                         if os .path .exists (current_single_stream_part_path ):os .remove (current_single_stream_part_path )
 
                         raise 
+                        single_stream_exception =e_write 
+                    if single_stream_exception :
+                        raise single_stream_exception 
 
             except (requests .exceptions .ConnectionError ,requests .exceptions .Timeout ,http .client .IncompleteRead )as e :
                 self .logger (f"   ❌ Download Error (Retryable): {api_original_filename }. Error: {e }")
@@ -1145,6 +1240,8 @@ class PostProcessorWorker :
                 last_exception_for_retry_later =e 
                 break 
             finally :
+                if response_for_this_attempt :
+                    response_for_this_attempt .close ()
                 self ._emit_signal ('file_download_status',False )
 
         final_total_for_progress =total_size_bytes if download_successful_flag and total_size_bytes >0 else downloaded_size_bytes 
@@ -1263,19 +1360,20 @@ class PostProcessorWorker :
 
         final_filename_on_disk =filename_after_compression 
 
-        if not (self .manga_mode_active and self .manga_filename_style ==STYLE_DATE_BASED ):
-            temp_base ,temp_ext =os .path .splitext (final_filename_on_disk )
-            suffix_counter =1 
-            while os .path .exists (os .path .join (effective_save_folder ,final_filename_on_disk )):
-                final_filename_on_disk =f"{temp_base }_{suffix_counter }{temp_ext }"
-                suffix_counter +=1 
-            if final_filename_on_disk !=filename_after_compression :
-                self .logger (f"     Applied numeric suffix in '{os .path .basename (effective_save_folder )}': '{final_filename_on_disk }' (was '{filename_after_compression }')")
+
+        temp_base ,temp_ext =os .path .splitext (final_filename_on_disk )
+        suffix_counter =1 
+        while os .path .exists (os .path .join (effective_save_folder ,final_filename_on_disk )):
+            final_filename_on_disk =f"{temp_base }_{suffix_counter }{temp_ext }"
+            suffix_counter +=1 
+        if final_filename_on_disk !=filename_after_compression :
+            self .logger (f"     Applied numeric suffix in '{os .path .basename (effective_save_folder )}': '{final_filename_on_disk }' (was '{filename_after_compression }')")
         if self ._check_pause (f"File saving for '{final_filename_on_disk }'"):return 0 ,1 ,final_filename_on_disk ,was_original_name_kept_flag ,FILE_DOWNLOAD_STATUS_SKIPPED ,None 
         final_save_path =os .path .join (effective_save_folder ,final_filename_on_disk )
         try :
             if data_to_write_io :
                 with open (final_save_path ,'wb')as f_out :
+                    time .sleep (0.05 )
                     f_out .write (data_to_write_io .getvalue ())
 
                 if downloaded_part_file_path and os .path .exists (downloaded_part_file_path ):
@@ -1285,6 +1383,7 @@ class PostProcessorWorker :
                         self .logger (f"  -> Failed to remove .part after compression: {e_rem }")
             else :
                 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 )
                 else :
                     raise FileNotFoundError (f"Original .part file not found for saving: {downloaded_part_file_path }")
@@ -1292,10 +1391,26 @@ class PostProcessorWorker :
             with self .downloaded_files_lock :self .downloaded_files .add (filename_to_save_in_main_path )
             final_filename_saved_for_return =final_filename_on_disk 
             self .logger (f"✅ Saved: '{final_filename_saved_for_return }' (from '{api_original_filename }', {downloaded_size_bytes /(1024 *1024 ):.2f} MB) in '{os .path .basename (effective_save_folder )}'")
+
+
+            downloaded_file_details ={
+            'disk_filename':final_filename_saved_for_return ,
+            'post_title':post_title ,
+            'post_id':original_post_id_for_log ,
+            'upload_date_str':self .post .get ('published')or self .post .get ('added')or "N/A",
+            'download_timestamp':time .time (),
+            'download_path':effective_save_folder ,
+            'service':self .service ,
+            'user_id':self .user_id ,
+            'api_original_filename':api_original_filename ,
+            'folder_context_name':folder_context_name_for_history or os .path .basename (effective_save_folder )
+            }
+            self ._emit_signal ('file_successfully_downloaded',downloaded_file_details )
             time .sleep (0.05 )
+
             return 1 ,0 ,final_filename_saved_for_return ,was_original_name_kept_flag ,FILE_DOWNLOAD_STATUS_SUCCESS ,None 
         except Exception as save_err :
-             self .logger (f"❌ Save Fail for '{final_filename_on_disk }': {save_err }")
+             self .logger (f"->>Save Fail for '{final_filename_on_disk }': {save_err }")
              if os .path .exists (final_save_path ):
                   try :os .remove (final_save_path );
                   except OSError :self .logger (f"  -> Failed to remove partially saved file: {final_save_path }")
@@ -1308,14 +1423,16 @@ class PostProcessorWorker :
 
 
     def process (self ):
-        if self ._check_pause (f"Post processing for ID {self .post .get ('id','N/A')}"):return 0 ,0 ,[],[],[]
-        if self .check_cancel ():return 0 ,0 ,[],[],[]
+        if self ._check_pause (f"Post processing for ID {self .post .get ('id','N/A')}"):return 0 ,0 ,[],[],[],None 
+        if self .check_cancel ():return 0 ,0 ,[],[],[],None 
         current_character_filters =self ._get_current_character_filters ()
         kept_original_filenames_for_log =[]
         retryable_failures_this_post =[]
         permanent_failures_this_post =[]
         total_downloaded_this_post =0 
         total_skipped_this_post =0 
+        history_data_for_this_post =None 
+
         parsed_api_url =urlparse (self .api_url_input )
         referer_url =f"https://{parsed_api_url .netloc }/"
         headers ={'User-Agent':'Mozilla/5.0','Referer':referer_url ,'Accept':'*/*'}
@@ -1343,7 +1460,7 @@ class PostProcessorWorker :
         char_filter_that_matched_file_in_comment_scope =None 
         char_filter_that_matched_comment =None 
         if current_character_filters and (self .char_filter_scope ==CHAR_SCOPE_TITLE or self .char_filter_scope ==CHAR_SCOPE_BOTH ):
-            if self ._check_pause (f"Character title filter for post {post_id }"):return 0 ,num_potential_files_in_post ,[],[]
+            if self ._check_pause (f"Character title filter for post {post_id }"):return 0 ,num_potential_files_in_post ,[],[],[],None 
             for idx ,filter_item_obj in enumerate (current_character_filters ):
                 if self .check_cancel ():break 
                 terms_to_check_for_title =list (filter_item_obj ["aliases"])
@@ -1374,7 +1491,7 @@ class PostProcessorWorker :
                     all_files_from_post_api_for_char_check .append ({'_original_name_for_log':original_api_att_name })
         if current_character_filters and self .char_filter_scope ==CHAR_SCOPE_COMMENTS :
             self .logger (f"   [Char Scope: Comments] Phase 1: Checking post files for matches before comments for post ID '{post_id }'.")
-            if self ._check_pause (f"File check (comments scope) for post {post_id }"):return 0 ,num_potential_files_in_post ,[],[]
+            if self ._check_pause (f"File check (comments scope) for post {post_id }"):return 0 ,num_potential_files_in_post ,[],[],[],None 
             for file_info_item in all_files_from_post_api_for_char_check :
                 if self .check_cancel ():break 
                 current_api_original_filename_for_check =file_info_item .get ('_original_name_for_log')
@@ -1394,7 +1511,7 @@ class PostProcessorWorker :
             self .logger (f"   [Char Scope: Comments] Phase 1 Result: post_is_candidate_by_file_char_match_in_comment_scope = {post_is_candidate_by_file_char_match_in_comment_scope }")
         if current_character_filters and self .char_filter_scope ==CHAR_SCOPE_COMMENTS :
             if not post_is_candidate_by_file_char_match_in_comment_scope :
-                if self ._check_pause (f"Comment check for post {post_id }"):return 0 ,num_potential_files_in_post ,[],[]
+                if self ._check_pause (f"Comment check for post {post_id }"):return 0 ,num_potential_files_in_post ,[],[],[],None 
                 self .logger (f"   [Char Scope: Comments] Phase 2: No file match found. Checking post comments for post ID '{post_id }'.")
                 try :
                     parsed_input_url_for_comments =urlparse (self .api_url_input )
@@ -1443,29 +1560,30 @@ class PostProcessorWorker :
             if self .char_filter_scope ==CHAR_SCOPE_TITLE and not post_is_candidate_by_title_char_match :
                 self .logger (f"   -> Skip Post (Scope: Title - No Char Match): Title '{post_title [:50 ]}' does not match character filters.")
                 self ._emit_signal ('missed_character_post',post_title ,"No title match for character filter")
-                return 0 ,num_potential_files_in_post ,[],[],[]
+                return 0 ,num_potential_files_in_post ,[],[],[],None 
             if self .char_filter_scope ==CHAR_SCOPE_COMMENTS and not post_is_candidate_by_file_char_match_in_comment_scope and not post_is_candidate_by_comment_char_match :
                 self .logger (f"   -> Skip Post (Scope: Comments - No Char Match in Comments): Post ID '{post_id }', Title '{post_title [:50 ]}...'")
                 if self .emitter and hasattr (self .emitter ,'missed_character_post_signal'):
                     self ._emit_signal ('missed_character_post',post_title ,"No character match in files or comments (Comments scope)")
-                return 0 ,num_potential_files_in_post ,[],[],[]
+                return 0 ,num_potential_files_in_post ,[],[],[],None 
         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 }"):return 0 ,num_potential_files_in_post ,[],[]
+            if self ._check_pause (f"Skip words (post title) for post {post_id }"):return 0 ,num_potential_files_in_post ,[],[],[],None 
             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 }")
-                    return 0 ,num_potential_files_in_post ,[],[],[]
+                    return 0 ,num_potential_files_in_post ,[],[],[],None 
         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)")
-            return 0 ,num_potential_files_in_post ,[],[],[]
+            return 0 ,num_potential_files_in_post ,[],[],[],None 
         if not isinstance (post_attachments ,list ):
             self .logger (f"⚠️ Corrupt attachment data for post {post_id } (expected list, got {type (post_attachments )}). Skipping attachments.")
             post_attachments =[]
         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 :
-            if self ._check_pause (f"Subfolder determination for post {post_id }"):return 0 ,num_potential_files_in_post ,[]
+            if self ._check_pause (f"Subfolder determination for post {post_id }"):return 0 ,num_potential_files_in_post ,[],[],[],None 
             primary_char_filter_for_folder =None 
             log_reason_for_folder =""
             if self .char_filter_scope ==CHAR_SCOPE_COMMENTS and char_filter_that_matched_comment :
@@ -1565,16 +1683,24 @@ class PostProcessorWorker :
                     final_fallback_name =clean_folder_name (post_title if post_title and post_title .strip ()else "Generic Post Content")
                     base_folder_names_for_post_content =[final_fallback_name ]
                     self .logger (f"   Ultimate fallback folder name: {final_fallback_name }")
+
+            if base_folder_names_for_post_content :
+                determined_post_save_path_for_history =os .path .join (determined_post_save_path_for_history ,base_folder_names_for_post_content [0 ])
+
+        if not self .extract_links_only and self .use_post_subfolders :
+            cleaned_post_title_for_sub =clean_folder_name (post_title )
+            determined_post_save_path_for_history =os .path .join (determined_post_save_path_for_history ,cleaned_post_title_for_sub )
+
         if not self .extract_links_only and self .use_subfolders and self .skip_words_list :
-            if self ._check_pause (f"Folder keyword skip check for post {post_id }"):return 0 ,num_potential_files_in_post ,[]
+            if self ._check_pause (f"Folder keyword skip check for post {post_id }"):return 0 ,num_potential_files_in_post ,[],[],[],None 
             for folder_name_to_check in base_folder_names_for_post_content :
                 if not folder_name_to_check :continue 
                 if any (skip_word .lower ()in folder_name_to_check .lower ()for skip_word in self .skip_words_list ):
                     matched_skip =next ((sw for sw in self .skip_words_list if sw .lower ()in folder_name_to_check .lower ()),"unknown_skip_word")
                     self .logger (f"   -> Skip Post (Folder Keyword): Potential folder '{folder_name_to_check }' contains '{matched_skip }'.")
-                    return 0 ,num_potential_files_in_post ,[],[],[]
+                    return 0 ,num_potential_files_in_post ,[],[],[],None 
         if (self .show_external_links or self .extract_links_only )and post_content_html :
-            if self ._check_pause (f"External link extraction for post {post_id }"):return 0 ,num_potential_files_in_post ,[],[]
+            if self ._check_pause (f"External link extraction for post {post_id }"):return 0 ,num_potential_files_in_post ,[],[],[],None 
             try :
                 mega_key_pattern =re .compile (r'\b([a-zA-Z0-9_-]{43}|[a-zA-Z0-9_-]{22})\b')
                 unique_links_data ={}
@@ -1614,7 +1740,7 @@ class PostProcessorWorker :
             except Exception as e :self .logger (f"⚠️ Error parsing post content for links: {e }\n{traceback .format_exc (limit =2 )}")
         if self .extract_links_only :
             self .logger (f"   Extract Links Only mode: Finished processing post {post_id } for links.")
-            return 0 ,0 ,[],[],[]
+            return 0 ,0 ,[],[],[],None 
         all_files_from_post_api =[]
         api_file_domain =urlparse (self .api_url_input ).netloc 
         if not api_file_domain or not any (d in api_file_domain .lower ()for d in ['kemono.su','kemono.party','coomer.su','coomer.party']):
@@ -1701,13 +1827,13 @@ class PostProcessorWorker :
                 all_files_from_post_api =[finfo for finfo in all_files_from_post_api if finfo .get ('_from_content_scan')]
                 if not all_files_from_post_api :
                     self .logger (f"   -> No images found via content scan for post {post_id } in this combined mode.")
-                    return 0 ,0 ,[],[],[]
+                    return 0 ,0 ,[],[],[],None 
             else :
                 self .logger (f"   Mode: 'Download Thumbnails Only' active. Filtering for API thumbnails for post {post_id }.")
                 all_files_from_post_api =[finfo for finfo in all_files_from_post_api if finfo .get ('_is_thumbnail')]
                 if not all_files_from_post_api :
                     self .logger (f"   -> No API image thumbnails found for post {post_id } in thumbnail-only mode.")
-                    return 0 ,0 ,[],[],[]
+                    return 0 ,0 ,[],[],[],None 
         if self .manga_mode_active and self .manga_filename_style ==STYLE_DATE_BASED :
             def natural_sort_key_for_files (file_api_info ):
                 name =file_api_info .get ('_original_name_for_log','').lower ()
@@ -1716,7 +1842,7 @@ class PostProcessorWorker :
             self .logger (f"   Manga Date Mode: Sorted {len (all_files_from_post_api )} files within post {post_id } by original name for sequential numbering.")
         if not all_files_from_post_api :
             self .logger (f"   No files found to download for post {post_id }.")
-            return 0 ,0 ,[],[],[]
+            return 0 ,0 ,[],[],[],None 
         files_to_download_info_list =[]
         processed_original_filenames_in_this_post =set ()
         for file_info in all_files_from_post_api :
@@ -1730,7 +1856,7 @@ class PostProcessorWorker :
                     processed_original_filenames_in_this_post .add (current_api_original_filename )
         if not files_to_download_info_list :
             self .logger (f"   All files for post {post_id } were duplicate original names or skipped earlier.")
-            return 0 ,total_skipped_this_post ,[],[],[]
+            return 0 ,total_skipped_this_post ,[],[],[],None 
 
         self .logger (f"   Identified {len (files_to_download_info_list )} unique original file(s) for potential download from post {post_id }.")
         with ThreadPoolExecutor (max_workers =self .num_file_threads ,thread_name_prefix =f'P{post_id }File_')as file_pool :
@@ -1832,13 +1958,16 @@ class PostProcessorWorker :
                     manga_date_counter_to_pass =self .manga_date_file_counter_ref if self .manga_mode_active and self .manga_filename_style ==STYLE_DATE_BASED else None 
                     manga_global_counter_to_pass =self .manga_global_file_counter_ref if self .manga_mode_active and self .manga_filename_style ==STYLE_POST_TITLE_GLOBAL_NUMBERING else None 
 
+
+                    folder_context_for_file =target_base_folder_name_for_instance if self .use_subfolders and target_base_folder_name_for_instance else clean_folder_name (post_title )
+
                     futures_list .append (file_pool .submit (
                     self ._download_single_file ,
                     file_info =file_info_to_dl ,
                     target_folder_path =current_path_for_file_instance ,
                     headers =headers ,original_post_id_for_log =post_id ,skip_event =self .skip_current_file_flag ,
                     post_title =post_title ,manga_date_file_counter_ref =manga_date_counter_to_pass ,
-                    manga_global_file_counter_ref =manga_global_counter_to_pass ,
+                    manga_global_file_counter_ref =manga_global_counter_to_pass ,folder_context_name_for_history =folder_context_for_file ,
                     file_index_in_post =file_idx ,num_files_in_this_post =len (files_to_download_info_list )
                     ))
 
@@ -1865,18 +1994,46 @@ class PostProcessorWorker :
                     self .logger (f"❌ File download task for post {post_id } resulted in error: {exc_f }")
                     total_skipped_this_post +=1 
         self ._emit_signal ('file_progress',"",None )
+
+
+
+
+        if not self .extract_links_only and (total_downloaded_this_post >0 or not (
+        (current_character_filters and (
+        (self .char_filter_scope ==CHAR_SCOPE_TITLE and not post_is_candidate_by_title_char_match )or 
+        (self .char_filter_scope ==CHAR_SCOPE_COMMENTS and not post_is_candidate_by_file_char_match_in_comment_scope and not post_is_candidate_by_comment_char_match )
+        ))or 
+        (self .skip_words_list and (self .skip_words_scope ==SKIP_SCOPE_POSTS or self .skip_words_scope ==SKIP_SCOPE_BOTH )and any (sw .lower ()in post_title .lower ()for sw in self .skip_words_list ))
+        )):
+            top_file_name_for_history ="N/A"
+            if post_main_file_info and post_main_file_info .get ('name'):
+                top_file_name_for_history =post_main_file_info ['name']
+            elif post_attachments and post_attachments [0 ].get ('name'):
+                top_file_name_for_history =post_attachments [0 ]['name']
+
+            history_data_for_this_post ={
+            'post_title':post_title ,'post_id':post_id ,
+            'top_file_name':top_file_name_for_history ,
+            '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 ,
+            'service':self .service ,'user_id':self .user_id ,
+            }
         if self .check_cancel ():self .logger (f"   Post {post_id } processing interrupted/cancelled.");
         else :self .logger (f"   Post {post_id } Summary: Downloaded={total_downloaded_this_post }, Skipped Files={total_skipped_this_post }")
-        return total_downloaded_this_post ,total_skipped_this_post ,kept_original_filenames_for_log ,retryable_failures_this_post ,permanent_failures_this_post 
+        return total_downloaded_this_post ,total_skipped_this_post ,kept_original_filenames_for_log ,retryable_failures_this_post ,permanent_failures_this_post ,history_data_for_this_post 
 class DownloadThread (QThread ):
     progress_signal =pyqtSignal (str )
     add_character_prompt_signal =pyqtSignal (str )
     file_download_status_signal =pyqtSignal (bool )
     finished_signal =pyqtSignal (int ,int ,bool ,list )
     external_link_signal =pyqtSignal (str ,str ,str ,str ,str )
+    file_successfully_downloaded_signal =pyqtSignal (dict )
     file_progress_signal =pyqtSignal (str ,object )
     retryable_file_failed_signal =pyqtSignal (list )
     missed_character_post_signal =pyqtSignal (str ,str )
+    post_processed_for_history_signal =pyqtSignal (dict )
+    final_history_entries_signal =pyqtSignal (list )
     permanent_file_failed_signal =pyqtSignal (list )
     def __init__ (self ,api_url_input ,output_dir ,known_names_copy ,
     cancellation_event ,
@@ -1959,6 +2116,7 @@ class DownloadThread (QThread ):
         self .scan_content_for_images =scan_content_for_images 
         self .creator_download_folder_ignore_words =creator_download_folder_ignore_words 
         self .manga_global_file_counter_ref =manga_global_file_counter_ref 
+        self .history_candidates_buffer =deque (maxlen =8 )
         if self .compress_images and Image is None :
             self .logger ("⚠️ Image compression disabled: Pillow library not found (DownloadThread).")
             self .compress_images =False 
@@ -2024,6 +2182,7 @@ class DownloadThread (QThread ):
             worker_signals_obj .file_progress_signal .connect (self .file_progress_signal )
             worker_signals_obj .external_link_signal .connect (self .external_link_signal )
             worker_signals_obj .missed_character_post_signal .connect (self .missed_character_post_signal )
+            worker_signals_obj .file_successfully_downloaded_signal .connect (self .file_successfully_downloaded_signal )
             self .logger ("   Starting post fetch (single-threaded download process)...")
             post_generator =download_from_api (
             self .api_url_input ,
@@ -2036,7 +2195,8 @@ class DownloadThread (QThread ):
             use_cookie =self .use_cookie ,
             cookie_text =self .cookie_text ,
             selected_cookie_file =self .selected_cookie_file ,
-            app_base_dir =self .app_base_dir 
+            app_base_dir =self .app_base_dir ,
+            manga_filename_style_for_sort_check =self .manga_filename_style if self .manga_mode_active else None 
             )
             for posts_batch_data in post_generator :
                 if self ._check_pause_self ("Post batch processing"):was_process_cancelled =True ;break 
@@ -2088,13 +2248,16 @@ class DownloadThread (QThread ):
                     creator_download_folder_ignore_words =self .creator_download_folder_ignore_words ,
                     )
                     try :
-                        dl_count ,skip_count ,kept_originals_this_post ,retryable_failures ,permanent_failures =post_processing_worker .process ()
+                        dl_count ,skip_count ,kept_originals_this_post ,retryable_failures ,permanent_failures ,history_data =post_processing_worker .process ()
                         grand_total_downloaded_files +=dl_count 
                         grand_total_skipped_files +=skip_count 
                         if kept_originals_this_post :
                             grand_list_of_kept_original_filenames .extend (kept_originals_this_post )
                         if retryable_failures :
                             self .retryable_file_failed_signal .emit (retryable_failures )
+                        if history_data :
+                            if len (self .history_candidates_buffer )<8 :
+                                self .post_processed_for_history_signal .emit (history_data )
                         if permanent_failures :
                             self .permanent_file_failed_signal .emit (permanent_failures )
                     except Exception as proc_err :
@@ -2110,6 +2273,10 @@ class DownloadThread (QThread ):
                 if was_process_cancelled :break 
             if not was_process_cancelled and not self .isInterruptionRequested ():
                  self .logger ("✅ All posts processed or end of content reached by DownloadThread.")
+
+
+
+
         except Exception as main_thread_err :
             self .logger (f"\n❌ Critical error within DownloadThread run loop: {main_thread_err }")
             traceback .print_exc ()
@@ -2122,6 +2289,7 @@ class DownloadThread (QThread ):
                     worker_signals_obj .external_link_signal .disconnect (self .external_link_signal )
                     worker_signals_obj .file_progress_signal .disconnect (self .file_progress_signal )
                     worker_signals_obj .missed_character_post_signal .disconnect (self .missed_character_post_signal )
+                    worker_signals_obj .file_successfully_downloaded_signal .disconnect (self .file_successfully_downloaded_signal )
 
             except (TypeError ,RuntimeError )as e :
                 self .logger (f"ℹ️ Note during DownloadThread signal disconnection: {e }")

features.md

@@ -17,7 +17,9 @@ These are the primary controls you'll interact with to initiate and manage downl
         -   Kemono.su (and mirrors) individual posts (e.g., `https://kemono.su/patreon/user/12345/post/98765`).
         -   Coomer.party (and mirrors like coomer.su) creator pages.
         -   Coomer.party (and mirrors) individual posts.
-    -   **Note:** When **⭐ Favorite Mode** is active, this field is disabled and shows a "Favorite Mode active" message.
+    -   **Note:**
+        -   When **⭐ Favorite Mode** is active, this field is disabled and shows a "Favorite Mode active" message.
+        -   This field can also be populated with a placeholder message (e.g., "{count} items in queue from popup") if posts are added to the download queue directly from the 'Creator Selection' dialog's 'Fetched Posts' view.
 
 -   **🎨 Creator Selection Button:**
     -   **Icon:** 🎨 (Artist Palette)
@@ -29,9 +31,17 @@ These are the primary controls you'll interact with to initiate and manage downl
         -   **Creator List:** Displays creators with their service (e.g., Patreon, Fanbox) and ID.
         -   **Selection:** Checkboxes to select one or more creators.
         -   **"Add Selected to URL" Button:** Adds the names of selected creators to the URL input field, comma-separated.
+        -   **"Fetch Posts" Button:** After selecting creators, click this to retrieve their latest posts. This will display a new pane within the dialog showing the fetched posts.
         -   **"Download Scope" Radio Buttons (`Characters` / `Creators`):** Determines the folder structure for items added via this popup.
             -   `Characters`: Assumes creator names are character names for folder organization.
             -   `Creators`: Uses the actual creator names for folder organization.
+    -   **Fetched Posts View (Right Pane - Appears after clicking 'Fetch Posts'):**
+        -   **Posts Area Title Label:** Indicates loading status or number of fetched posts.
+        -   **Posts Search Input:** Allows filtering the list of fetched posts by title.
+        -   **Posts List Widget:** Displays posts fetched from the selected creators, often grouped by creator. Each post is checkable.
+        -   **Select All / Deselect All Buttons (for Posts):** Convenience buttons for selecting/deselecting all displayed fetched posts.
+        -   **"Add Selected Posts to Queue" Button:** Adds all checked posts from this view directly to the application's main download queue. The main URL input field will then show a message like "{count} items in queue from popup".
+        -   **"Close" Button (for Posts View):** Hides the fetched posts view and returns to the creator selection list, allowing you to use the 'Add Selected to URL' button if preferred.
         
 -   **Page Range (Start to End) Input Fields:**
     -   **Purpose:** For creator URLs, specify a range of pages to fetch and process.
@@ -323,6 +333,46 @@ Download directly from your favorited artists and posts on Kemono.su.
     -   **Note:** Files successfully retried or skipped due to hash match during a retry attempt are removed from this error list.
 ---
 
+## ⚙️ Application Settings
+
+These settings allow you to customize the application's appearance and language.
+
+-   **⚙️ Settings Button (Icon may vary, e.g., a gear ⚙️):**
+    -   **Location:** Typically located in a persistent area of the UI, possibly near other global controls or in a menu.
+    -   **Purpose:** Opens the "Settings" dialog.
+    -   **Tooltip Example:** "Open application settings (Theme, Language, etc.)"
+
+-   **"Settings" Dialog:**
+    -   **Title:** "Settings"
+    -   **Purpose:** Provides options to configure application-wide preferences.
+    -   **Sections:**
+        -   **Appearance Group (`Appearance`):**
+            -   **Theme Toggle Buttons/Options:**
+                -   `Switch to Light Mode`
+                -   `Switch to Dark Mode`
+                -   **Purpose:** Allows users to switch between a light and dark visual theme for the application.
+                -   **Tooltips:** Provide guidance on switching themes.
+        -   **Language Settings Group (`Language Settings`):**
+            -   **Language Selection Dropdown/List:**
+                -   **Label:** "Language:"
+                -   **Options:** Includes, but not limited to:
+                    -   English (`English`)
+                    -   日本語 (`日本語 (Japanese)`)
+                    -   Français (French)
+                    -   Español (Spanish)
+                    -   Deutsch (German)
+                    -   Русский (Russian)
+                    -   한국어 (Korean)
+                    -   简体中文 (Chinese Simplified)
+                -   **Purpose:** Allows users to change the display language of the application interface.
+            -   **Restart Prompt:** After changing the language, a dialog may appear:
+                -   **Title:** "Language Changed"
+                -   **Message:** "The language has been changed. A restart is required for all changes to take full effect."
+                -   **Informative Text:** "Would you like to restart the application now?"
+                -   **Buttons:** "Restart Now", "OK" (or similar to defer restart).
+    -   **"OK" Button:** Saves the changes made in the Settings dialog and closes it.
+---
+
 ## Other UI Elements
 
 -   **Retry Failed Downloads Prompt:**

readme.md

@@ -1,4 +1,4 @@
-<h1 align="center">Kemono Downloader v5.1.0</h1>
+<h1 align="center">Kemono Downloader v5.3.0</h1>
 
 <table align="center">
   <tr>
@@ -34,7 +34,7 @@ A powerful, feature-rich GUI application for downloading content from **[Kemono.
 Built with PyQt5, this tool is designed for users who want deep filtering capabilities, customizable folder structures, efficient downloads, and intelligent automation, all within a modern and user-friendly graphical interface.
 
 *This v5.0.0 release marks a significant feature milestone. Future updates are expected to be less frequent, focusing on maintenance and minor refinements.*
-*Update v5.1.0 enhances error handling and UI responsiveness.*
+*Update v5.2.0 introduces multi-language support, theme selection, and further UI refinements.*
 <p align="center">
   <a href="features.md"><strong>📚 Full Feature List</strong></a> • 
   <a href="LICENSE"><strong>📝 License</strong></a>
@@ -75,6 +75,22 @@ Kemono Downloader offers a range of features to streamline your content download
     -   **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 v5.3.0
+-   **Multi-Creator Post Fetching & Queuing:**
+    -   The **Creator Selection popup** (🎨 icon) has been significantly enhanced.
+    -   After selecting multiple creators, you can now click a new "**Fetch Posts**" button.
+    -   This will retrieve and display posts from all selected creators in a new view within the popup.
+    -   You can then browse these fetched posts (with search functionality) and select individual posts.
+    -   A new "**Add Selected Posts to Queue**" button allows you to add your chosen posts directly to the main download queue, streamlining the process of gathering content from multiple artists.
+    -   The traditional "**Add Selected to URL**" button is still available if you prefer to populate the main URL field with creator names.
+-   **Improved Favorite Download Queue Handling:**
+    -   When items are added to the download queue from the Creator Selection popup, the main URL input field will now display a placeholder message (e.g., "{count} items in queue from popup").
+    -   The queue is now more robustly managed, especially when interacting with the main URL input field after items have been queued from the popup.
 
 ---
 
@@ -84,6 +100,13 @@ Kemono Downloader offers a range of features to streamline your content download
     -   A new **"Export URLs to .txt"** button, allowing users to save links of failed downloads either as "URL only" or "URL with details" (including post title, ID, and original filename).
     -   Fixed a bug where files skipped during retry (due to existing hash match) were not correctly removed from the error list.
 -   **Improved UI Stability**: Addressed issues with UI state management to more accurately reflect ongoing download activities (including retries and external link downloads). This prevents the "Cancel" button from becoming inactive prematurely while operations are still running.
+
+## ✨ What's New in v5.2.0
+-   **Multi-language Support:** The interface now supports multiple languages: English, Japanese, French, Spanish, German, Russian, Korean, and Chinese (Simplified). Select your preferred language in the new Settings dialog.
+-   **Theme Selection:** Choose between Light and Dark application themes via the Settings dialog for a personalized viewing experience.
+-   **Centralized Settings:** A new Settings dialog (accessible via a settings button, often with a gear icon) provides a dedicated space for language and appearance customizations.
+-   **Internal Localization:** Introduced `languages.py` for managing UI translations, streamlining the addition of new languages by contributors.
+
 ---
 
 ## Installation