--- End of Mega Download Log ---
") - - - - self .set_ui_enabled (True ) - - - - if self .mega_download_log_preserved_once : - self .mega_download_log_preserved_once =False - self .log_signal .emit ("INTERNAL: mega_download_log_preserved_once RESET to False.") - - if self .external_link_download_thread : - self .external_link_download_thread .deleteLater () - self .external_link_download_thread =None - - def _on_single_external_file_complete (self ,url ,success ): - - - pass - def _show_future_settings_dialog (self ): - """Shows the placeholder dialog for future settings.""" - dialog =FutureSettingsDialog (self ) - dialog =FutureSettingsDialog (self ,self ) - dialog .exec_ () - - def _sync_queue_with_link_input (self ,current_text ): - """ - Synchronizes the favorite_download_queue with the link_input text. - Removes creators from the queue if their names are removed from the input field. - Only affects items added via 'creator_popup_selection'. - """ - if not self .favorite_download_queue : - self .last_link_input_text_for_queue_sync =current_text - return - - current_names_in_input ={name .strip ().lower ()for name in current_text .split (',')if name .strip ()} - - queue_copy =list (self .favorite_download_queue ) - removed_count =0 - - for item in queue_copy : - if item .get ('type')=='creator_popup_selection': - item_name_lower =item .get ('name','').lower () - if item_name_lower and item_name_lower not in current_names_in_input : - try : - self .favorite_download_queue .remove (item ) - self .log_signal .emit (f"ℹ️ Creator '{item .get ('name')}' removed from download queue due to removal from URL input.") - removed_count +=1 - except ValueError : - self .log_signal .emit (f"⚠️ Tried to remove '{item .get ('name')}' from queue, but it was not found (sync).") - - self .last_link_input_text_for_queue_sync =current_text - - def _browse_cookie_file (self ): - """Opens a file dialog to select a cookie file.""" - start_dir =QStandardPaths .writableLocation (QStandardPaths .DownloadLocation ) - if not start_dir : - start_dir =os .path .dirname (self .config_file ) - - filepath ,_ =QFileDialog .getOpenFileName (self ,"Select Cookie File",start_dir ,"Text files (*.txt);;All files (*)") - if filepath : - self .selected_cookie_filepath =filepath - self .log_signal .emit (f"ℹ️ Selected cookie file: {filepath }") - if hasattr (self ,'cookie_text_input'): - self .cookie_text_input .blockSignals (True ) - self .cookie_text_input .setText (filepath ) - self .cookie_text_input .setToolTip (self ._tr ("cookie_text_input_tooltip_file_selected","Using selected cookie file: {filepath}").format (filepath =filepath )) - self .cookie_text_input .setPlaceholderText (self ._tr ("cookie_text_input_placeholder_with_file_selected_text","Using selected cookie file (see Browse...)")) - self .cookie_text_input .setReadOnly (True ) - self .cookie_text_input .setPlaceholderText ("") - self .cookie_text_input .blockSignals (False ) - - def _update_cookie_input_placeholders_and_tooltips (self ): - if hasattr (self ,'cookie_text_input'): - if self .selected_cookie_filepath : - self .cookie_text_input .setPlaceholderText (self ._tr ("cookie_text_input_placeholder_with_file_selected_text","Using selected cookie file...")) - self .cookie_text_input .setToolTip (self ._tr ("cookie_text_input_tooltip_file_selected","Using selected cookie file: {filepath}").format (filepath =self .selected_cookie_filepath )) - else : - self .cookie_text_input .setPlaceholderText (self ._tr ("cookie_text_input_placeholder_no_file_selected_text","Cookie string (if no cookies.txt selected)")) - self .cookie_text_input .setToolTip (self ._tr ("cookie_text_input_tooltip","Enter your cookie string directly...")) - self .cookie_text_input .setReadOnly (True ) - self .cookie_text_input .setPlaceholderText ("") - self .cookie_text_input .blockSignals (False ) - - def _center_on_screen (self ): - """Centers the widget on the screen.""" - try : - primary_screen =QApplication .primaryScreen () - if not primary_screen : - screens =QApplication .screens () - if not screens :return - primary_screen =screens [0 ] - - available_geo =primary_screen .availableGeometry () - widget_geo =self .frameGeometry () - - x =available_geo .x ()+(available_geo .width ()-widget_geo .width ())//2 - y =available_geo .y ()+(available_geo .height ()-widget_geo .height ())//2 - self .move (x ,y ) - except Exception as e : - self .log_signal .emit (f"⚠️ Error centering window: {e }") - - def _handle_cookie_text_manual_change (self ,text ): - """Handles manual changes to the cookie text input, especially clearing a browsed path.""" - if not hasattr (self ,'cookie_text_input')or not hasattr (self ,'use_cookie_checkbox'): - return - if self .selected_cookie_filepath and not text .strip ()and self .use_cookie_checkbox .isChecked (): - self .selected_cookie_filepath =None - self .cookie_text_input .setReadOnly (False ) - self ._update_cookie_input_placeholders_and_tooltips () - self .log_signal .emit ("ℹ️ Browsed cookie file path cleared from input. Switched to manual cookie string mode.") - - - def get_dark_theme (self ): - return """ - QWidget { background-color: #2E2E2E; color: #E0E0E0; font-family: Segoe UI, Arial, sans-serif; font-size: 10pt; } - QLineEdit, QListWidget { background-color: #3C3F41; border: 1px solid #5A5A5A; padding: 5px; color: #F0F0F0; border-radius: 4px; } - QTextEdit { background-color: #3C3F41; border: 1px solid #5A5A5A; padding: 5px; - color: #F0F0F0; border-radius: 4px; - font-family: Consolas, Courier New, monospace; font-size: 9.5pt; } - QPushButton { background-color: #555; color: #F0F0F0; border: 1px solid #6A6A6A; padding: 6px 12px; border-radius: 4px; min-height: 22px; } - QPushButton:hover { background-color: #656565; border: 1px solid #7A7A7A; } - QPushButton:pressed { background-color: #4A4A4A; } - QPushButton:disabled { background-color: #404040; color: #888; border-color: #555; } - QLabel { font-weight: bold; padding-top: 4px; padding-bottom: 2px; color: #C0C0C0; } - QRadioButton, QCheckBox { spacing: 5px; color: #E0E0E0; padding-top: 4px; padding-bottom: 4px; } - QRadioButton::indicator, QCheckBox::indicator { width: 14px; height: 14px; } - QListWidget { alternate-background-color: #353535; border: 1px solid #5A5A5A; } - QListWidget::item:selected { background-color: #007ACC; color: #FFFFFF; } - QToolTip { background-color: #4A4A4A; color: #F0F0F0; border: 1px solid #6A6A6A; padding: 4px; border-radius: 3px; } - QSplitter::handle { background-color: #5A5A5A; } - QSplitter::handle:horizontal { width: 5px; } - QSplitter::handle:vertical { height: 5px; } - QFrame[frameShape="4"], QFrame[frameShape="5"] { - border: 1px solid #4A4A4A; - border-radius: 3px; - } - """ - - def browse_directory (self ): - initial_dir_text =self .dir_input .text () - start_path ="" - if initial_dir_text and os .path .isdir (initial_dir_text ): - start_path =initial_dir_text - else : - home_location =QStandardPaths .writableLocation (QStandardPaths .HomeLocation ) - documents_location =QStandardPaths .writableLocation (QStandardPaths .DocumentsLocation ) - if home_location and os .path .isdir (home_location ): - start_path =home_location - elif documents_location and os .path .isdir (documents_location ): - start_path =documents_location - - self .log_signal .emit (f"ℹ️ Opening folder dialog. Suggested start path: '{start_path }'") - - try : - folder =QFileDialog .getExistingDirectory ( - self , - "Select Download Folder", - start_path , - options =QFileDialog .DontUseNativeDialog |QFileDialog .ShowDirsOnly - ) - - if folder : - self .dir_input .setText (folder ) - self .log_signal .emit (f"ℹ️ Folder selected: {folder }") - else : - self .log_signal .emit (f"ℹ️ Folder selection cancelled by user.") - except RuntimeError as e : - self .log_signal .emit (f"❌ RuntimeError opening folder dialog: {e }. This might indicate a deeper Qt or system issue.") - QMessageBox .critical (self ,"Dialog Error",f"A runtime error occurred while trying to open the folder dialog: {e }") - except Exception as e : - self .log_signal .emit (f"❌ Unexpected error opening folder dialog: {e }\n{traceback .format_exc (limit =3 )}") - QMessageBox .critical (self ,"Dialog Error",f"An unexpected error occurred with the folder selection dialog: {e }") - - def handle_main_log (self ,message ): - is_html_message =message .startswith (HTML_PREFIX ) - display_message =message - use_html =False - - if is_html_message : - display_message =message [len (HTML_PREFIX ):] - use_html =True - - try : - safe_message =str (display_message ).replace ('\x00','[NULL]') - if use_html : - self .main_log_output .insertHtml (safe_message ) - else : - self .main_log_output .append (safe_message ) - - scrollbar =self .main_log_output .verticalScrollBar () - if scrollbar .value ()>=scrollbar .maximum ()-30 : - scrollbar .setValue (scrollbar .maximum ()) - except Exception as e : - print (f"GUI Main Log Error: {e }\nOriginal Message: {message }") - def _extract_key_term_from_title (self ,title ): - if not title : - return None - title_cleaned =re .sub (r'\[.*?\]','',title ) - title_cleaned =re .sub (r'\(.*?\)','',title_cleaned ) - title_cleaned =title_cleaned .strip () - word_matches =list (re .finditer (r'\b[a-zA-Z][a-zA-Z0-9_-]*\b',title_cleaned )) - - capitalized_candidates =[] - for match in word_matches : - word =match .group (0 ) - if word .istitle ()and word .lower ()not in self .STOP_WORDS and len (word )>2 : - if not (len (word )>3 and word .isupper ()): - capitalized_candidates .append ({'text':word ,'len':len (word ),'pos':match .start ()}) - - if capitalized_candidates : - capitalized_candidates .sort (key =lambda x :(x ['len'],x ['pos']),reverse =True ) - return capitalized_candidates [0 ]['text'] - non_capitalized_words_info =[] - for match in word_matches : - word =match .group (0 ) - if word .lower ()not in self .STOP_WORDS and len (word )>3 : - non_capitalized_words_info .append ({'text':word ,'len':len (word ),'pos':match .start ()}) - - if non_capitalized_words_info : - non_capitalized_words_info .sort (key =lambda x :(x ['len'],x ['pos']),reverse =True ) - return non_capitalized_words_info [0 ]['text'] - - return None - - def handle_missed_character_post (self ,post_title ,reason ): - if self .missed_character_log_output : - key_term =self ._extract_key_term_from_title (post_title ) - - if key_term : - normalized_key_term =key_term .lower () - if normalized_key_term not in self .already_logged_bold_key_terms : - self .already_logged_bold_key_terms .add (normalized_key_term ) - self .missed_key_terms_buffer .append (key_term ) - self ._refresh_missed_character_log () - else : - print (f"Debug (Missed Char Log): Title='{post_title }', Reason='{reason }'") - - def _refresh_missed_character_log (self ): - if self .missed_character_log_output : - self .missed_character_log_output .clear () - sorted_terms =sorted (self .missed_key_terms_buffer ,key =str .lower ) - separator_line ="-"*40 - - for term in sorted_terms : - display_term =term .capitalize () - - self .missed_character_log_output .append (separator_line ) - self .missed_character_log_output .append (f'
{display_term }
') - self .missed_character_log_output .append (separator_line ) - self .missed_character_log_output .append ("") - - scrollbar =self .missed_character_log_output .verticalScrollBar () - scrollbar .setValue (0 ) - - def _is_download_active (self ): - single_thread_active =self .download_thread and self .download_thread .isRunning () - fetcher_active =hasattr (self ,'is_fetcher_thread_running')and self .is_fetcher_thread_running - pool_has_active_tasks =self .thread_pool is not None and any (not f .done ()for f in self .active_futures if f is not None ) - retry_pool_active =hasattr (self ,'retry_thread_pool')and self .retry_thread_pool is not None and hasattr (self ,'active_retry_futures')and any (not f .done ()for f in self .active_retry_futures if f is not None ) - - - external_dl_thread_active =hasattr (self ,'external_link_download_thread')and self .external_link_download_thread is not None and self .external_link_download_thread .isRunning () - - return single_thread_active or fetcher_active or pool_has_active_tasks or retry_pool_active or external_dl_thread_active - - def handle_external_link_signal (self ,post_title ,link_text ,link_url ,platform ,decryption_key ): - link_data =(post_title ,link_text ,link_url ,platform ,decryption_key ) - self .external_link_queue .append (link_data ) - if self .radio_only_links and self .radio_only_links .isChecked (): - self .extracted_links_cache .append (link_data ) - self ._update_download_extracted_links_button_state () - - is_only_links_mode =self .radio_only_links and self .radio_only_links .isChecked () - should_display_in_external_log =self .show_external_links and not is_only_links_mode - - if not (is_only_links_mode or should_display_in_external_log ): - self ._is_processing_external_link_queue =False - if self .external_link_queue : - QTimer .singleShot (0 ,self ._try_process_next_external_link ) - return - - - if link_data not in self .extracted_links_cache : - self .extracted_links_cache .append (link_data ) - - def _try_process_next_external_link (self ): - if self ._is_processing_external_link_queue or not self .external_link_queue : - return - - is_only_links_mode =self .radio_only_links and self .radio_only_links .isChecked () - should_display_in_external_log =self .show_external_links and not is_only_links_mode - - if not (is_only_links_mode or should_display_in_external_log ): - self ._is_processing_external_link_queue =False - if self .external_link_queue : - QTimer .singleShot (0 ,self ._try_process_next_external_link ) - return - - self ._is_processing_external_link_queue =True - link_data =self .external_link_queue .popleft () - - if is_only_links_mode : - QTimer .singleShot (0 ,lambda data =link_data :self ._display_and_schedule_next (data )) - elif self ._is_download_active (): - delay_ms =random .randint (4000 ,8000 ) - QTimer .singleShot (delay_ms ,lambda data =link_data :self ._display_and_schedule_next (data )) - else : - QTimer .singleShot (0 ,lambda data =link_data :self ._display_and_schedule_next (data )) - - - def _display_and_schedule_next (self ,link_data ): - post_title ,link_text ,link_url ,platform ,decryption_key =link_data - is_only_links_mode =self .radio_only_links and self .radio_only_links .isChecked () - - max_link_text_len =50 - display_text =(link_text [:max_link_text_len ].strip ()+"..." - if len (link_text )>max_link_text_len else link_text .strip ()) - formatted_link_info =f"{display_text } - {link_url } - {platform }" - - if decryption_key : - formatted_link_info +=f" (Decryption Key: {decryption_key })" - - if is_only_links_mode : - if post_title !=self ._current_link_post_title : - separator_html =""+"-"*45 +"
" - if self ._current_link_post_title is not None : - self .log_signal .emit (HTML_PREFIX +separator_html ) - title_html =f'{html .escape (post_title )}
' - self .log_signal .emit (HTML_PREFIX +title_html ) - self ._current_link_post_title =post_title - - self .log_signal .emit (formatted_link_info ) - elif self .show_external_links : - separator ="-"*45 - self ._append_to_external_log (formatted_link_info ,separator ) - - self ._is_processing_external_link_queue =False - self ._try_process_next_external_link () - - - def _append_to_external_log (self ,formatted_link_text ,separator ): - if not (self .external_log_output and self .external_log_output .isVisible ()): - return - - try : - self .external_log_output .append (formatted_link_text ) - self .external_log_output .append ("") - - scrollbar =self .external_log_output .verticalScrollBar () - if scrollbar .value ()>=scrollbar .maximum ()-50 : - scrollbar .setValue (scrollbar .maximum ()) - except Exception as e : - self .log_signal .emit (f"GUI External Log Append Error: {e }\nOriginal Message: {formatted_link_text }") - print (f"GUI External Log Error (Append): {e }\nOriginal Message: {formatted_link_text }") - - - def update_file_progress_display (self ,filename ,progress_info ): - if not filename and progress_info is None : - self .file_progress_label .setText ("") - return - - if isinstance (progress_info ,list ): - if not progress_info : - self .file_progress_label .setText (self ._tr ("downloading_multipart_initializing_text","File: {filename} - Initializing parts...").format (filename =filename )) - return - - total_downloaded_overall =sum (cs .get ('downloaded',0 )for cs in progress_info ) - total_file_size_overall =sum (cs .get ('total',0 )for cs in progress_info ) - - active_chunks_count =0 - combined_speed_bps =0 - for cs in progress_info : - if cs .get ('active',False ): - active_chunks_count +=1 - combined_speed_bps +=cs .get ('speed_bps',0 ) - - dl_mb =total_downloaded_overall /(1024 *1024 ) - total_mb =total_file_size_overall /(1024 *1024 ) - speed_MBps =(combined_speed_bps /8 )/(1024 *1024 ) - - progress_text =self ._tr ("downloading_multipart_text","DL '{filename}...': {downloaded_mb:.1f}/{total_mb:.1f} MB ({parts} parts @ {speed:.2f} MB/s)").format (filename =filename [:20 ],downloaded_mb =dl_mb ,total_mb =total_mb ,parts =active_chunks_count ,speed =speed_MBps ) - self .file_progress_label .setText (progress_text ) - - elif isinstance (progress_info ,tuple )and len (progress_info )==2 : - downloaded_bytes ,total_bytes =progress_info - - if not filename and total_bytes ==0 and downloaded_bytes ==0 : - self .file_progress_label .setText ("") - return - - max_fn_len =25 - disp_fn =filename if len (filename )<=max_fn_len else filename [:max_fn_len -3 ].strip ()+"..." - - dl_mb =downloaded_bytes /(1024 *1024 ) - if total_bytes >0 : - tot_mb =total_bytes /(1024 *1024 ) - prog_text_base =self ._tr ("downloading_file_known_size_text","Downloading '{filename}' ({downloaded_mb:.1f}MB / {total_mb:.1f}MB)").format (filename =disp_fn ,downloaded_mb =dl_mb ,total_mb =tot_mb ) - else : - prog_text_base =self ._tr ("downloading_file_unknown_size_text","Downloading '{filename}' ({downloaded_mb:.1f}MB)").format (filename =disp_fn ,downloaded_mb =dl_mb ) - - self .file_progress_label .setText (prog_text_base ) - elif filename and progress_info is None : - self .file_progress_label .setText ("") - elif not filename and not progress_info : - self .file_progress_label .setText ("") - - - def update_external_links_setting (self ,checked ): - is_only_links_mode =self .radio_only_links and self .radio_only_links .isChecked () - is_only_archives_mode =self .radio_only_archives and self .radio_only_archives .isChecked () - - if is_only_links_mode or is_only_archives_mode : - if self .external_log_output :self .external_log_output .hide () - if self .log_splitter :self .log_splitter .setSizes ([self .height (),0 ]) - return - - self .show_external_links =checked - if checked : - if self .external_log_output :self .external_log_output .show () - if self .log_splitter :self .log_splitter .setSizes ([self .height ()//2 ,self .height ()//2 ]) - if self .main_log_output :self .main_log_output .setMinimumHeight (50 ) - if self .external_log_output :self .external_log_output .setMinimumHeight (50 ) - self .log_signal .emit ("\n"+"="*40 +"\n🔗 External Links Log Enabled\n"+"="*40 ) - if self .external_log_output : - self .external_log_output .clear () - self .external_log_output .append ("🔗 External Links Found:") - self ._try_process_next_external_link () - else : - if self .external_log_output :self .external_log_output .hide () - if self .log_splitter :self .log_splitter .setSizes ([self .height (),0 ]) - if self .main_log_output :self .main_log_output .setMinimumHeight (0 ) - if self .external_log_output :self .external_log_output .setMinimumHeight (0 ) - if self .external_log_output :self .external_log_output .clear () - self .log_signal .emit ("\n"+"="*40 +"\n🔗 External Links Log Disabled\n"+"="*40 ) - - - def _handle_filter_mode_change (self ,button ,checked ): - if not button or not checked : - return - - - is_only_links =(button ==self .radio_only_links ) - is_only_audio =(hasattr (self ,'radio_only_audio')and self .radio_only_audio is not None and button ==self .radio_only_audio ) - is_only_archives =(hasattr (self ,'radio_only_archives')and self .radio_only_archives is not None and button ==self .radio_only_archives ) - - if self .skip_scope_toggle_button : - self .skip_scope_toggle_button .setVisible (not (is_only_links or is_only_archives or is_only_audio )) - if hasattr (self ,'multipart_toggle_button')and self .multipart_toggle_button : - self .multipart_toggle_button .setVisible (not (is_only_links or is_only_archives or is_only_audio )) - - if self .link_search_input :self .link_search_input .setVisible (is_only_links ) - if self .link_search_button :self .link_search_button .setVisible (is_only_links ) - if self .export_links_button : - self .export_links_button .setVisible (is_only_links ) - self .export_links_button .setEnabled (is_only_links and bool (self .extracted_links_cache )) - - if hasattr (self ,'download_extracted_links_button')and self .download_extracted_links_button : - self .download_extracted_links_button .setVisible (is_only_links ) - self ._update_download_extracted_links_button_state () - - if self .download_btn : - if is_only_links : - self .download_btn .setText (self ._tr ("extract_links_button_text","🔗 Extract Links")) - else : - self .download_btn .setText (self ._tr ("start_download_button_text","⬇️ Start Download")) - if not is_only_links and self .link_search_input :self .link_search_input .clear () - - file_download_mode_active =not is_only_links - - - - if self .use_subfolders_checkbox :self .use_subfolders_checkbox .setEnabled (file_download_mode_active ) - if self .skip_words_input :self .skip_words_input .setEnabled (file_download_mode_active ) - if self .skip_scope_toggle_button :self .skip_scope_toggle_button .setEnabled (file_download_mode_active ) - if hasattr (self ,'remove_from_filename_input'):self .remove_from_filename_input .setEnabled (file_download_mode_active ) - - if self .skip_zip_checkbox : - can_skip_zip =file_download_mode_active and not is_only_archives - self .skip_zip_checkbox .setEnabled (can_skip_zip ) - if is_only_archives : - self .skip_zip_checkbox .setChecked (False ) - - if self .skip_rar_checkbox : - can_skip_rar =file_download_mode_active and not is_only_archives - self .skip_rar_checkbox .setEnabled (can_skip_rar ) - if is_only_archives : - self .skip_rar_checkbox .setChecked (False ) - - other_file_proc_enabled =file_download_mode_active and not is_only_archives - if self .download_thumbnails_checkbox :self .download_thumbnails_checkbox .setEnabled (other_file_proc_enabled ) - if self .compress_images_checkbox :self .compress_images_checkbox .setEnabled (other_file_proc_enabled ) - - if self .external_links_checkbox : - can_show_external_log_option =file_download_mode_active and not is_only_archives - self .external_links_checkbox .setEnabled (can_show_external_log_option ) - if not can_show_external_log_option : - self .external_links_checkbox .setChecked (False ) - - - if is_only_links : - self .progress_log_label .setText ("📜 Extracted Links Log:") - if self .external_log_output :self .external_log_output .hide () - if self .log_splitter :self .log_splitter .setSizes ([self .height (),0 ]) - - - do_clear_log_in_filter_change =True - if self .mega_download_log_preserved_once and self .only_links_log_display_mode ==LOG_DISPLAY_DOWNLOAD_PROGRESS : - do_clear_log_in_filter_change =False - - if self .main_log_output and do_clear_log_in_filter_change : - self .log_signal .emit ("INTERNAL: _handle_filter_mode_change - About to clear log.") - self .main_log_output .clear () - self .log_signal .emit ("INTERNAL: _handle_filter_mode_change - Log cleared by _handle_filter_mode_change.") - - if self .main_log_output :self .main_log_output .setMinimumHeight (0 ) - self .log_signal .emit ("="*20 +" Mode changed to: Only Links "+"="*20 ) - self ._try_process_next_external_link () - elif is_only_archives : - self .progress_log_label .setText ("📜 Progress Log (Archives Only):") - if self .external_log_output :self .external_log_output .hide () - if self .log_splitter :self .log_splitter .setSizes ([self .height (),0 ]) - if self .main_log_output :self .main_log_output .clear () - self .log_signal .emit ("="*20 +" Mode changed to: Only Archives "+"="*20 ) - elif is_only_audio : - self .progress_log_label .setText (self ._tr ("progress_log_label_text","📜 Progress Log:")+f" ({self ._tr ('filter_audio_radio','🎧 Only Audio')})") - if self .external_log_output :self .external_log_output .hide () - if self .log_splitter :self .log_splitter .setSizes ([self .height (),0 ]) - if self .main_log_output :self .main_log_output .clear () - self .log_signal .emit ("="*20 +f" Mode changed to: {self ._tr ('filter_audio_radio','🎧 Only Audio')} "+"="*20 ) - else : - self .progress_log_label .setText (self ._tr ("progress_log_label_text","📜 Progress Log:")) - self .update_external_links_setting (self .external_links_checkbox .isChecked ()if self .external_links_checkbox else False ) - self .log_signal .emit (f"="*20 +f" Mode changed to: {button .text ()} "+"="*20 ) - - - if is_only_links : - self ._filter_links_log () - - if hasattr (self ,'log_display_mode_toggle_button'): - self .log_display_mode_toggle_button .setVisible (is_only_links ) - self ._update_log_display_mode_button_text () - - subfolders_on =self .use_subfolders_checkbox .isChecked ()if self .use_subfolders_checkbox else False - manga_on =self .manga_mode_checkbox .isChecked ()if self .manga_mode_checkbox else False - - character_filter_should_be_active =file_download_mode_active and not is_only_archives - - if self .character_filter_widget : - self .character_filter_widget .setVisible (character_filter_should_be_active ) - - enable_character_filter_related_widgets =character_filter_should_be_active - - if self .character_input : - self .character_input .setEnabled (enable_character_filter_related_widgets ) - if not enable_character_filter_related_widgets : - self .character_input .clear () - - if self .char_filter_scope_toggle_button : - self .char_filter_scope_toggle_button .setEnabled (enable_character_filter_related_widgets ) - - self .update_ui_for_subfolders (subfolders_on ) - self .update_custom_folder_visibility () - self .update_ui_for_manga_mode (self .manga_mode_checkbox .isChecked ()if self .manga_mode_checkbox else False ) - - - def _filter_links_log (self ): - if not (self .radio_only_links and self .radio_only_links .isChecked ()):return - - search_term =self .link_search_input .text ().lower ().strip ()if self .link_search_input else "" - - if self .mega_download_log_preserved_once and self .only_links_log_display_mode ==LOG_DISPLAY_DOWNLOAD_PROGRESS : - - - self .log_signal .emit ("INTERNAL: _filter_links_log - Preserving Mega log (due to mega_download_log_preserved_once).") - elif self .only_links_log_display_mode ==LOG_DISPLAY_DOWNLOAD_PROGRESS : - - - - self .log_signal .emit ("INTERNAL: _filter_links_log - In Progress View. Clearing for placeholder.") - if self .main_log_output :self .main_log_output .clear () - self .log_signal .emit ("INTERNAL: _filter_links_log - Cleared for progress placeholder.") - self .log_signal .emit ("ℹ️ Switched to Mega download progress view. Extracted links are hidden.\n" - " Perform a Mega download to see its progress here, or switch back to 🔗 view.") - self .log_signal .emit ("INTERNAL: _filter_links_log - Placeholder message emitted.") - - else : - - self .log_signal .emit ("INTERNAL: _filter_links_log - In links view branch. About to clear.") - if self .main_log_output :self .main_log_output .clear () - self .log_signal .emit ("INTERNAL: _filter_links_log - Cleared for links view.") - - current_title_for_display =None - any_links_displayed_this_call =False - separator_html ="
"+"-"*45 +"
" - - for post_title ,link_text ,link_url ,platform ,decryption_key in self .extracted_links_cache : - matches_search =(not search_term or - search_term in link_text .lower ()or - search_term in link_url .lower ()or - search_term in platform .lower ()or - (decryption_key and search_term in decryption_key .lower ())) - if not matches_search : - continue - - any_links_displayed_this_call =True - if post_title !=current_title_for_display : - if current_title_for_display is not None : - if self .main_log_output :self .main_log_output .insertHtml (separator_html ) - - title_html =f'{html .escape (post_title )}
' - if self .main_log_output :self .main_log_output .insertHtml (title_html ) - current_title_for_display =post_title - - max_link_text_len =50 - display_text =(link_text [:max_link_text_len ].strip ()+"..."if len (link_text )>max_link_text_len else link_text .strip ()) - - plain_link_info_line =f"{display_text } - {link_url } - {platform }" - if decryption_key : - plain_link_info_line +=f" (Decryption Key: {decryption_key })" - if self .main_log_output : - self .main_log_output .append (plain_link_info_line ) - - if any_links_displayed_this_call : - if self .main_log_output :self .main_log_output .append ("") - elif not search_term and self .main_log_output : - self .log_signal .emit (" (No links extracted yet or all filtered out in links view)") - - - if self .main_log_output :self .main_log_output .verticalScrollBar ().setValue (self .main_log_output .verticalScrollBar ().maximum ()) - - - def _export_links_to_file (self ): - if not (self .radio_only_links and self .radio_only_links .isChecked ()): - QMessageBox .information (self ,"Export Links","Link export is only available in 'Only Links' mode.") - return - if not self .extracted_links_cache : - QMessageBox .information (self ,"Export Links","No links have been extracted yet.") - return - - default_filename ="extracted_links.txt" - filepath ,_ =QFileDialog .getSaveFileName (self ,"Save Links",default_filename ,"Text Files (*.txt);;All Files (*)") - - if filepath : - try : - with open (filepath ,'w',encoding ='utf-8')as f : - current_title_for_export =None - separator ="-"*60 +"\n" - for post_title ,link_text ,link_url ,platform ,decryption_key in self .extracted_links_cache : - if post_title !=current_title_for_export : - if current_title_for_export is not None : - f .write ("\n"+separator +"\n") - f .write (f"Post Title: {post_title }\n\n") - current_title_for_export =post_title - line_to_write =f" {link_text } - {link_url } - {platform }" - if decryption_key : - line_to_write +=f" (Decryption Key: {decryption_key })" - f .write (line_to_write +"\n") - self .log_signal .emit (f"✅ Links successfully exported to: {filepath }") - QMessageBox .information (self ,"Export Successful",f"Links exported to:\n{filepath }") - except Exception as e : - self .log_signal .emit (f"❌ Error exporting links: {e }") - QMessageBox .critical (self ,"Export Error",f"Could not export links: {e }") - - - def get_filter_mode (self ): - if self .radio_only_links and self .radio_only_links .isChecked (): - return 'all' - elif self .radio_images .isChecked (): - return 'image' - elif self .radio_videos .isChecked (): - return 'video' - elif self .radio_only_archives and self .radio_only_archives .isChecked (): - return 'archive' - elif hasattr (self ,'radio_only_audio')and self .radio_only_audio .isChecked (): - return 'audio' - elif self .radio_all .isChecked (): - return 'all' - return 'all' - - - def get_skip_words_scope (self ): - return self .skip_words_scope - - - def _update_skip_scope_button_text (self ): - if self .skip_scope_toggle_button : - if self .skip_words_scope ==SKIP_SCOPE_FILES : - self .skip_scope_toggle_button .setText (self ._tr ("skip_scope_files_text","Scope: Files")) - self .skip_scope_toggle_button .setToolTip (self ._tr ("skip_scope_files_tooltip","Tooltip for skip scope files")) - elif self .skip_words_scope ==SKIP_SCOPE_POSTS : - self .skip_scope_toggle_button .setText (self ._tr ("skip_scope_posts_text","Scope: Posts")) - self .skip_scope_toggle_button .setToolTip (self ._tr ("skip_scope_posts_tooltip","Tooltip for skip scope posts")) - elif self .skip_words_scope ==SKIP_SCOPE_BOTH : - self .skip_scope_toggle_button .setText (self ._tr ("skip_scope_both_text","Scope: Both")) - self .skip_scope_toggle_button .setToolTip (self ._tr ("skip_scope_both_tooltip","Tooltip for skip scope both")) - else : - self .skip_scope_toggle_button .setText (self ._tr ("skip_scope_unknown_text","Scope: Unknown")) - self .skip_scope_toggle_button .setToolTip (self ._tr ("skip_scope_unknown_tooltip","Tooltip for skip scope unknown")) - - - def _cycle_skip_scope (self ): - if self .skip_words_scope ==SKIP_SCOPE_POSTS : - self .skip_words_scope =SKIP_SCOPE_FILES - elif self .skip_words_scope ==SKIP_SCOPE_FILES : - self .skip_words_scope =SKIP_SCOPE_BOTH - elif self .skip_words_scope ==SKIP_SCOPE_BOTH : - self .skip_words_scope =SKIP_SCOPE_POSTS - else : - self .skip_words_scope =SKIP_SCOPE_POSTS - - self ._update_skip_scope_button_text () - self .settings .setValue (SKIP_WORDS_SCOPE_KEY ,self .skip_words_scope ) - self .log_signal .emit (f"ℹ️ Skip words scope changed to: '{self .skip_words_scope }'") - - def get_char_filter_scope (self ): - return self .char_filter_scope - - def _update_char_filter_scope_button_text (self ): - if self .char_filter_scope_toggle_button : - if self .char_filter_scope ==CHAR_SCOPE_FILES : - self .char_filter_scope_toggle_button .setText (self ._tr ("char_filter_scope_files_text","Filter: Files")) - self .char_filter_scope_toggle_button .setToolTip (self ._tr ("char_filter_scope_files_tooltip","Tooltip for char filter files")) - elif self .char_filter_scope ==CHAR_SCOPE_TITLE : - self .char_filter_scope_toggle_button .setText (self ._tr ("char_filter_scope_title_text","Filter: Title")) - self .char_filter_scope_toggle_button .setToolTip (self ._tr ("char_filter_scope_title_tooltip","Tooltip for char filter title")) - elif self .char_filter_scope ==CHAR_SCOPE_BOTH : - self .char_filter_scope_toggle_button .setText (self ._tr ("char_filter_scope_both_text","Filter: Both")) - self .char_filter_scope_toggle_button .setToolTip (self ._tr ("char_filter_scope_both_tooltip","Tooltip for char filter both")) - elif self .char_filter_scope ==CHAR_SCOPE_COMMENTS : - self .char_filter_scope_toggle_button .setText (self ._tr ("char_filter_scope_comments_text","Filter: Comments (Beta)")) - self .char_filter_scope_toggle_button .setToolTip (self ._tr ("char_filter_scope_comments_tooltip","Tooltip for char filter comments")) - else : - self .char_filter_scope_toggle_button .setText (self ._tr ("char_filter_scope_unknown_text","Filter: Unknown")) - self .char_filter_scope_toggle_button .setToolTip (self ._tr ("char_filter_scope_unknown_tooltip","Tooltip for char filter unknown")) - - def _cycle_char_filter_scope (self ): - if self .char_filter_scope ==CHAR_SCOPE_TITLE : - self .char_filter_scope =CHAR_SCOPE_FILES - elif self .char_filter_scope ==CHAR_SCOPE_FILES : - self .char_filter_scope =CHAR_SCOPE_BOTH - elif self .char_filter_scope ==CHAR_SCOPE_BOTH : - self .char_filter_scope =CHAR_SCOPE_COMMENTS - elif self .char_filter_scope ==CHAR_SCOPE_COMMENTS : - self .char_filter_scope =CHAR_SCOPE_TITLE - else : - self .char_filter_scope =CHAR_SCOPE_TITLE - - self ._update_char_filter_scope_button_text () - self .settings .setValue (CHAR_FILTER_SCOPE_KEY ,self .char_filter_scope ) - self .log_signal .emit (f"ℹ️ Character filter scope changed to: '{self .char_filter_scope }'") - - def _handle_ui_add_new_character (self ): - """Handles adding a new character from the UI input field.""" - name_from_ui_input =self .new_char_input .text ().strip () - successfully_added_any =False - - if not name_from_ui_input : - QMessageBox .warning (self ,"Input Error","Name cannot be empty.") - return - - if name_from_ui_input .startswith ("(")and name_from_ui_input .endswith (")~"): - content =name_from_ui_input [1 :-2 ].strip () - aliases =[alias .strip ()for alias in content .split (',')if alias .strip ()] - if aliases : - folder_name =" ".join (aliases ) - if self .add_new_character (name_to_add =folder_name , - is_group_to_add =True , - aliases_to_add =aliases , - suppress_similarity_prompt =False ): - successfully_added_any =True - else : - QMessageBox .warning (self ,"Input Error","Empty group content for `~` format.") - - elif name_from_ui_input .startswith ("(")and name_from_ui_input .endswith (")"): - content =name_from_ui_input [1 :-1 ].strip () - names_to_add_separately =[name .strip ()for name in content .split (',')if name .strip ()] - if names_to_add_separately : - for name_item in names_to_add_separately : - if self .add_new_character (name_to_add =name_item , - is_group_to_add =False , - aliases_to_add =[name_item ], - suppress_similarity_prompt =False ): - successfully_added_any =True - else : - QMessageBox .warning (self ,"Input Error","Empty group content for standard group format.") - else : - if self .add_new_character (name_to_add =name_from_ui_input , - is_group_to_add =False , - aliases_to_add =[name_from_ui_input ], - suppress_similarity_prompt =False ): - successfully_added_any =True - - if successfully_added_any : - self .new_char_input .clear () - self .save_known_names () - - - def add_new_character (self ,name_to_add ,is_group_to_add ,aliases_to_add ,suppress_similarity_prompt =False ): - global KNOWN_NAMES ,clean_folder_name - if not name_to_add : - QMessageBox .warning (self ,"Input Error","Name cannot be empty.");return False - - name_to_add_lower =name_to_add .lower () - for kn_entry in KNOWN_NAMES : - if kn_entry ["name"].lower ()==name_to_add_lower : - QMessageBox .warning (self ,"Duplicate Name",f"The primary folder name '{name_to_add }' already exists.");return False - if not is_group_to_add and name_to_add_lower in [a .lower ()for a in kn_entry ["aliases"]]: - QMessageBox .warning (self ,"Duplicate Alias",f"The name '{name_to_add }' already exists as an alias for '{kn_entry ['name']}'.");return False - - similar_names_details =[] - for kn_entry in KNOWN_NAMES : - for term_to_check_similarity_against in kn_entry ["aliases"]: - term_lower =term_to_check_similarity_against .lower () - if name_to_add_lower !=term_lower and (name_to_add_lower in term_lower or term_lower in name_to_add_lower ): - similar_names_details .append ((name_to_add ,kn_entry ["name"])) - break - for new_alias in aliases_to_add : - if new_alias .lower ()!=term_to_check_similarity_against .lower ()and (new_alias .lower ()in term_to_check_similarity_against .lower ()or term_to_check_similarity_against .lower ()in new_alias .lower ()): - similar_names_details .append ((new_alias ,kn_entry ["name"])) - break - - if similar_names_details and not suppress_similarity_prompt : - if similar_names_details : - first_similar_new ,first_similar_existing =similar_names_details [0 ] - shorter ,longer =sorted ([first_similar_new ,first_similar_existing ],key =len ) - - msg_box =QMessageBox (self ) - msg_box .setIcon (QMessageBox .Warning ) - msg_box .setWindowTitle ("Potential Name Conflict") - msg_box .setText ( - f"The name '{first_similar_new }' is very similar to an existing name: '{first_similar_existing }'.\n\n" - f"This could lead to unexpected folder grouping (e.g., under '{clean_folder_name (shorter )}' instead of a more specific '{clean_folder_name (longer )}' or vice-versa).\n\n" - "Do you want to change the name you are adding, or proceed anyway?" - ) - change_button =msg_box .addButton ("Change Name",QMessageBox .RejectRole ) - proceed_button =msg_box .addButton ("Proceed Anyway",QMessageBox .AcceptRole ) - msg_box .setDefaultButton (proceed_button ) - msg_box .setEscapeButton (change_button ) - msg_box .exec_ () - - if msg_box .clickedButton ()==change_button : - self .log_signal .emit (f"ℹ️ User chose to change '{first_similar_new }' due to similarity with an alias of '{first_similar_existing }'.") - return False - self .log_signal .emit (f"⚠️ User proceeded with adding '{first_similar_new }' despite similarity with an alias of '{first_similar_existing }'.") - new_entry ={ - "name":name_to_add , - "is_group":is_group_to_add , - "aliases":sorted (list (set (aliases_to_add )),key =str .lower ) - } - if is_group_to_add : - for new_alias in new_entry ["aliases"]: - if any (new_alias .lower ()==kn_entry ["name"].lower ()for kn_entry in KNOWN_NAMES if kn_entry ["name"].lower ()!=name_to_add_lower ): - QMessageBox .warning (self ,"Alias Conflict",f"Alias '{new_alias }' (for group '{name_to_add }') conflicts with an existing primary name.");return False - KNOWN_NAMES .append (new_entry ) - KNOWN_NAMES .sort (key =lambda x :x ["name"].lower ()) - - self .character_list .clear () - self .character_list .addItems ([entry ["name"]for entry in KNOWN_NAMES ]) - self .filter_character_list (self .character_search_input .text ()) - - log_msg_suffix =f" (as group with aliases: {', '.join (new_entry ['aliases'])})"if is_group_to_add and len (new_entry ['aliases'])>1 else "" - self .log_signal .emit (f"✅ Added '{name_to_add }' to known names list{log_msg_suffix }.") - self .new_char_input .clear () - return True - - - def delete_selected_character (self ): - global KNOWN_NAMES - selected_items =self .character_list .selectedItems () - if not selected_items : - QMessageBox .warning (self ,"Selection Error","Please select one or more names to delete.");return - - primary_names_to_remove ={item .text ()for item in selected_items } - confirm =QMessageBox .question (self ,"Confirm Deletion", - f"Are you sure you want to delete {len (primary_names_to_remove )} selected entry/entries (and their aliases)?", - QMessageBox .Yes |QMessageBox .No ,QMessageBox .No ) - if confirm ==QMessageBox .Yes : - original_count =len (KNOWN_NAMES ) - KNOWN_NAMES [:]=[entry for entry in KNOWN_NAMES if entry ["name"]not in primary_names_to_remove ] - removed_count =original_count -len (KNOWN_NAMES ) - - if removed_count >0 : - self .log_signal .emit (f"🗑️ Removed {removed_count } name(s).") - self .character_list .clear () - self .character_list .addItems ([entry ["name"]for entry in KNOWN_NAMES ]) - self .filter_character_list (self .character_search_input .text ()) - self .save_known_names () - else : - self .log_signal .emit ("ℹ️ No names were removed (they might not have been in the list).") - - - def update_custom_folder_visibility (self ,url_text =None ): - if url_text is None : - url_text =self .link_input .text () - - _ ,_ ,post_id =extract_post_info (url_text .strip ()) - - is_single_post_url =bool (post_id ) - subfolders_enabled =self .use_subfolders_checkbox .isChecked ()if self .use_subfolders_checkbox else False - - not_only_links_or_archives_mode =not ( - (self .radio_only_links and self .radio_only_links .isChecked ())or - (self .radio_only_archives and self .radio_only_archives .isChecked ())or - (hasattr (self ,'radio_only_audio')and self .radio_only_audio .isChecked ()) - ) - - should_show_custom_folder =is_single_post_url and subfolders_enabled and not_only_links_or_archives_mode - - if self .custom_folder_widget : - self .custom_folder_widget .setVisible (should_show_custom_folder ) - - if not (self .custom_folder_widget and self .custom_folder_widget .isVisible ()): - if self .custom_folder_input :self .custom_folder_input .clear () - - - def update_ui_for_subfolders (self ,separate_folders_by_name_title_checked :bool ): - is_only_links =self .radio_only_links and self .radio_only_links .isChecked () - is_only_archives =self .radio_only_archives and self .radio_only_archives .isChecked () - is_only_audio =hasattr (self ,'radio_only_audio')and self .radio_only_audio .isChecked () - - can_enable_subfolder_per_post_checkbox =not is_only_links - - if self .use_subfolder_per_post_checkbox : - self .use_subfolder_per_post_checkbox .setEnabled (can_enable_subfolder_per_post_checkbox ) - - if not can_enable_subfolder_per_post_checkbox : - self .use_subfolder_per_post_checkbox .setChecked (False ) - - self .update_custom_folder_visibility () - - - def _update_cookie_input_visibility (self ,checked ): - cookie_text_input_exists =hasattr (self ,'cookie_text_input') - cookie_browse_button_exists =hasattr (self ,'cookie_browse_button') - - if cookie_text_input_exists or cookie_browse_button_exists : - is_only_links =self .radio_only_links and self .radio_only_links .isChecked () - if cookie_text_input_exists :self .cookie_text_input .setVisible (checked ) - if cookie_browse_button_exists :self .cookie_browse_button .setVisible (checked ) - - can_enable_cookie_text =checked and not is_only_links - enable_state_for_fields =can_enable_cookie_text and (self .download_btn .isEnabled ()or self .is_paused ) - - if cookie_text_input_exists : - self .cookie_text_input .setEnabled (enable_state_for_fields ) - if self .selected_cookie_filepath and checked : - self .cookie_text_input .setText (self .selected_cookie_filepath ) - self .cookie_text_input .setReadOnly (True ) - self .cookie_text_input .setPlaceholderText ("") - elif checked : - self .cookie_text_input .setReadOnly (False ) - self .cookie_text_input .setPlaceholderText ("Cookie string (if no cookies.txt)") - - if cookie_browse_button_exists :self .cookie_browse_button .setEnabled (enable_state_for_fields ) - - if not checked : - self .selected_cookie_filepath =None - - - def update_page_range_enabled_state (self ): - url_text =self .link_input .text ().strip ()if self .link_input else "" - _ ,_ ,post_id =extract_post_info (url_text ) - - is_creator_feed =not post_id if url_text else False - enable_page_range =is_creator_feed - - for widget in [self .page_range_label ,self .start_page_input ,self .to_label ,self .end_page_input ]: - if widget :widget .setEnabled (enable_page_range ) - - if not enable_page_range : - if self .start_page_input :self .start_page_input .clear () - if self .end_page_input :self .end_page_input .clear () - - - def _update_manga_filename_style_button_text (self ): - if self .manga_rename_toggle_button : - if self .manga_filename_style ==STYLE_POST_TITLE : - self .manga_rename_toggle_button .setText (self ._tr ("manga_style_post_title_text","Name: Post Title")) - - elif self .manga_filename_style ==STYLE_ORIGINAL_NAME : - self .manga_rename_toggle_button .setText (self ._tr ("manga_style_original_file_text","Name: Original File")) - - elif self .manga_filename_style ==STYLE_POST_TITLE_GLOBAL_NUMBERING : - self .manga_rename_toggle_button .setText (self ._tr ("manga_style_title_global_num_text","Name: Title+G.Num")) - - elif self .manga_filename_style ==STYLE_DATE_BASED : - self .manga_rename_toggle_button .setText (self ._tr ("manga_style_date_based_text","Name: Date Based")) - - - elif self .manga_filename_style ==STYLE_DATE_POST_TITLE : - self .manga_rename_toggle_button .setText (self ._tr ("manga_style_date_post_title_text","Name: Date + Title")) - - else : - self .manga_rename_toggle_button .setText (self ._tr ("manga_style_unknown_text","Name: Unknown Style")) - - - self .manga_rename_toggle_button .setToolTip ("Click to cycle Manga Filename Style (when Manga Mode is active for a creator feed).") - - - def _toggle_manga_filename_style (self ): - current_style =self .manga_filename_style - new_style ="" - if current_style ==STYLE_POST_TITLE : - new_style =STYLE_ORIGINAL_NAME - elif current_style ==STYLE_ORIGINAL_NAME : - new_style =STYLE_DATE_POST_TITLE - elif current_style ==STYLE_DATE_POST_TITLE : - new_style =STYLE_POST_TITLE_GLOBAL_NUMBERING - elif current_style ==STYLE_POST_TITLE_GLOBAL_NUMBERING : - new_style =STYLE_DATE_BASED - elif current_style ==STYLE_DATE_BASED : - new_style =STYLE_POST_TITLE - else : - self .log_signal .emit (f"⚠️ Unknown current manga filename style: {current_style }. Resetting to default ('{STYLE_POST_TITLE }').") - new_style =STYLE_POST_TITLE - - self .manga_filename_style =new_style - self .settings .setValue (MANGA_FILENAME_STYLE_KEY ,self .manga_filename_style ) - self .settings .sync () - self ._update_manga_filename_style_button_text () - self .update_ui_for_manga_mode (self .manga_mode_checkbox .isChecked ()if self .manga_mode_checkbox else False ) - self .log_signal .emit (f"ℹ️ Manga filename style changed to: '{self .manga_filename_style }'") - - def _handle_favorite_mode_toggle (self ,checked ): - if not self .url_or_placeholder_stack or not self .bottom_action_buttons_stack : - return - - self .url_or_placeholder_stack .setCurrentIndex (1 if checked else 0 ) - self .bottom_action_buttons_stack .setCurrentIndex (1 if checked else 0 ) - - if checked : - if self .link_input : - self .link_input .clear () - self .link_input .setEnabled (False ) - for widget in [self .page_range_label ,self .start_page_input ,self .to_label ,self .end_page_input ]: - if widget :widget .setEnabled (False ) - if self .start_page_input :self .start_page_input .clear () - if self .end_page_input :self .end_page_input .clear () - - self .update_custom_folder_visibility () - self .update_page_range_enabled_state () - if self .manga_mode_checkbox : - self .manga_mode_checkbox .setChecked (False ) - self .manga_mode_checkbox .setEnabled (False ) - if hasattr (self ,'use_cookie_checkbox'): - self .use_cookie_checkbox .setChecked (True ) - self .use_cookie_checkbox .setEnabled (False ) - if hasattr (self ,'use_cookie_checkbox'): - self ._update_cookie_input_visibility (True ) - self .update_ui_for_manga_mode (False ) - - if hasattr (self ,'favorite_mode_artists_button'): - self .favorite_mode_artists_button .setEnabled (True ) - if hasattr (self ,'favorite_mode_posts_button'): - self .favorite_mode_posts_button .setEnabled (True ) - - else : - if self .link_input :self .link_input .setEnabled (True ) - self .update_page_range_enabled_state () - self .update_custom_folder_visibility () - self .update_ui_for_manga_mode (self .manga_mode_checkbox .isChecked ()if self .manga_mode_checkbox else False ) - - if hasattr (self ,'use_cookie_checkbox'): - self .use_cookie_checkbox .setEnabled (True ) - if hasattr (self ,'use_cookie_checkbox'): - self ._update_cookie_input_visibility (self .use_cookie_checkbox .isChecked ()) - - if hasattr (self ,'favorite_mode_artists_button'): - self .favorite_mode_artists_button .setEnabled (False ) - if hasattr (self ,'favorite_mode_posts_button'): - self .favorite_mode_posts_button .setEnabled (False ) - - def update_ui_for_manga_mode (self ,checked ): - is_only_links_mode =self .radio_only_links and self .radio_only_links .isChecked () - is_only_archives_mode =self .radio_only_archives and self .radio_only_archives .isChecked () - is_only_audio_mode =hasattr (self ,'radio_only_audio')and self .radio_only_audio .isChecked () - - url_text =self .link_input .text ().strip ()if self .link_input else "" - _ ,_ ,post_id =extract_post_info (url_text ) - - is_creator_feed =not post_id if url_text else False - is_favorite_mode_on =self .favorite_mode_checkbox .isChecked ()if self .favorite_mode_checkbox else False - - if self .manga_mode_checkbox : - self .manga_mode_checkbox .setEnabled (is_creator_feed and not is_favorite_mode_on ) - if not is_creator_feed and self .manga_mode_checkbox .isChecked (): - self .manga_mode_checkbox .setChecked (False ) - checked =self .manga_mode_checkbox .isChecked () - - manga_mode_effectively_on =is_creator_feed and checked - - if self .manga_rename_toggle_button : - self .manga_rename_toggle_button .setVisible (manga_mode_effectively_on and not (is_only_links_mode or is_only_archives_mode or is_only_audio_mode )) - - self .update_page_range_enabled_state () - - current_filename_style =self .manga_filename_style - - enable_char_filter_widgets =not is_only_links_mode and not is_only_archives_mode - - if self .character_input : - self .character_input .setEnabled (enable_char_filter_widgets ) - if not enable_char_filter_widgets :self .character_input .clear () - if self .char_filter_scope_toggle_button : - self .char_filter_scope_toggle_button .setEnabled (enable_char_filter_widgets ) - if self .character_filter_widget : - self .character_filter_widget .setVisible (enable_char_filter_widgets ) - - show_date_prefix_input =( - manga_mode_effectively_on and - (current_filename_style ==STYLE_DATE_BASED or - current_filename_style ==STYLE_ORIGINAL_NAME )and - not (is_only_links_mode or is_only_archives_mode or is_only_audio_mode ) - ) - if hasattr (self ,'manga_date_prefix_input'): - self .manga_date_prefix_input .setVisible (show_date_prefix_input ) - if show_date_prefix_input : - self .manga_date_prefix_input .setMaximumWidth (120 ) - self .manga_date_prefix_input .setMinimumWidth (60 ) - else : - self .manga_date_prefix_input .clear () - self .manga_date_prefix_input .setMaximumWidth (16777215 ) - self .manga_date_prefix_input .setMinimumWidth (0 ) - - if hasattr (self ,'multipart_toggle_button'): - - hide_multipart_button_due_mode =is_only_links_mode or is_only_archives_mode or is_only_audio_mode - hide_multipart_button_due_manga_mode =manga_mode_effectively_on - self .multipart_toggle_button .setVisible (not (hide_multipart_button_due_mode or hide_multipart_button_due_manga_mode )) - - self ._update_multithreading_for_date_mode () - - - def filter_character_list (self ,search_text ): - search_text_lower =search_text .lower () - for i in range (self .character_list .count ()): - item =self .character_list .item (i ) - item .setHidden (search_text_lower not in item .text ().lower ()) - - - def update_multithreading_label (self ,text ): - if self .use_multithreading_checkbox .isChecked (): - base_text =self ._tr ("use_multithreading_checkbox_base_label","Use Multithreading") - try : - num_threads_val =int (text ) - if num_threads_val >0 :self .use_multithreading_checkbox .setText (f"{base_text } ({num_threads_val } Threads)") - else :self .use_multithreading_checkbox .setText (f"{base_text } (Invalid: >0)") - except ValueError : - self .use_multithreading_checkbox .setText (f"{base_text } (Invalid Input)") - else : - self .use_multithreading_checkbox .setText (f"{self ._tr ('use_multithreading_checkbox_base_label','Use Multithreading')} (1 Thread)") - - - def _handle_multithreading_toggle (self ,checked ): - if not checked : - self .thread_count_input .setEnabled (False ) - self .thread_count_label .setEnabled (False ) - self .use_multithreading_checkbox .setText ("Use Multithreading (1 Thread)") - else : - self .thread_count_input .setEnabled (True ) - self .thread_count_label .setEnabled (True ) - self .update_multithreading_label (self .thread_count_input .text ()) - - def _update_multithreading_for_date_mode (self ): - """ - Checks if Manga Mode is ON and 'Date Based' style is selected. - If so, disables multithreading. Otherwise, enables it. - """ - if not hasattr (self ,'manga_mode_checkbox')or not hasattr (self ,'use_multithreading_checkbox'): - return - - manga_on =self .manga_mode_checkbox .isChecked () - is_sequential_style_requiring_single_thread =( - self .manga_filename_style ==STYLE_DATE_BASED or - self .manga_filename_style ==STYLE_POST_TITLE_GLOBAL_NUMBERING - ) - if manga_on and is_sequential_style_requiring_single_thread : - if self .use_multithreading_checkbox .isChecked ()or self .use_multithreading_checkbox .isEnabled (): - if self .use_multithreading_checkbox .isChecked (): - self .log_signal .emit ("ℹ️ Manga Date Mode: Multithreading for post processing has been disabled to ensure correct sequential file numbering.") - self .use_multithreading_checkbox .setChecked (False ) - self .use_multithreading_checkbox .setEnabled (False ) - self ._handle_multithreading_toggle (False ) - else : - if not self .use_multithreading_checkbox .isEnabled (): - self .use_multithreading_checkbox .setEnabled (True ) - self ._handle_multithreading_toggle (self .use_multithreading_checkbox .isChecked ()) - - def update_progress_display (self ,total_posts ,processed_posts ): - if total_posts >0 : - progress_percent =(processed_posts /total_posts )*100 - self .progress_label .setText (self ._tr ("progress_posts_text","Progress: {processed_posts} / {total_posts} posts ({progress_percent:.1f}%)").format (processed_posts =processed_posts ,total_posts =total_posts ,progress_percent =progress_percent )) - elif processed_posts >0 : - self .progress_label .setText (self ._tr ("progress_processing_post_text","Progress: Processing post {processed_posts}...").format (processed_posts =processed_posts )) - else : - self .progress_label .setText (self ._tr ("progress_starting_text","Progress: Starting...")) - - if total_posts >0 or processed_posts >0 : - self .file_progress_label .setText ("") - - - def start_download (self ,direct_api_url =None ,override_output_dir =None, is_restore=False ): - global KNOWN_NAMES ,BackendDownloadThread ,PostProcessorWorker ,extract_post_info ,clean_folder_name ,MAX_FILE_THREADS_PER_POST_OR_WORKER - - if self ._is_download_active (): - QMessageBox.warning(self, "Busy", "A download is already in progress.") - return False - - - - if not direct_api_url and self .favorite_download_queue and not self .is_processing_favorites_queue : - self .log_signal .emit (f"ℹ️ Detected {len (self .favorite_download_queue )} item(s) in the queue. Starting processing...") - self .cancellation_message_logged_this_session =False - self ._process_next_favorite_download () - return True - - if not is_restore and self.interrupted_session_data: - self.log_signal.emit("ℹ️ New download started. Discarding previous interrupted session.") - self._clear_session_file() - self.interrupted_session_data = None - self.is_restore_pending = False - api_url =direct_api_url if direct_api_url else self .link_input .text ().strip () - self .download_history_candidates .clear () - self._update_button_states_and_connections() # Ensure buttons are updated to active state - - - if self .favorite_mode_checkbox and self .favorite_mode_checkbox .isChecked ()and not direct_api_url and not api_url : - QMessageBox .information (self ,"Favorite Mode Active", - "Favorite Mode is active. Please use the 'Favorite Artists' or 'Favorite Posts' buttons to start downloads in this mode, or uncheck 'Favorite Mode' to use the URL input.") - self .set_ui_enabled (True ) - return False - - main_ui_download_dir =self .dir_input .text ().strip () - - if not api_url and not self .favorite_download_queue : - QMessageBox .critical (self ,"Input Error","URL is required.") - return False - elif not api_url and self .favorite_download_queue : - self .log_signal .emit ("ℹ️ URL input is empty, but queue has items. Processing queue...") - self .cancellation_message_logged_this_session =False - self ._process_next_favorite_download () - return True - - self .cancellation_message_logged_this_session =False - use_subfolders =self .use_subfolders_checkbox .isChecked () - use_post_subfolders =self .use_subfolder_per_post_checkbox .isChecked () - compress_images =self .compress_images_checkbox .isChecked () - download_thumbnails =self .download_thumbnails_checkbox .isChecked () - - use_multithreading_enabled_by_checkbox =self .use_multithreading_checkbox .isChecked () - try : - num_threads_from_gui =int (self .thread_count_input .text ().strip ()) - if num_threads_from_gui <1 :num_threads_from_gui =1 - except ValueError : - QMessageBox .critical (self ,"Thread Count Error","Invalid number of threads. Please enter a positive number.") - return False - - if use_multithreading_enabled_by_checkbox : - if num_threads_from_gui >MAX_THREADS : - hard_warning_msg =( - f"You've entered a thread count ({num_threads_from_gui }) exceeding the maximum of {MAX_THREADS }.\n\n" - "Using an extremely high number of threads can lead to:\n" - " - Diminishing returns (no significant speed increase).\n" - " - Increased system instability or application crashes.\n" - " - Higher chance of being rate-limited or temporarily IP-banned by the server.\n\n" - f"The thread count has been automatically capped to {MAX_THREADS } for stability." - ) - QMessageBox .warning (self ,"High Thread Count Warning",hard_warning_msg ) - num_threads_from_gui =MAX_THREADS - self .thread_count_input .setText (str (MAX_THREADS )) - self .log_signal .emit (f"⚠️ User attempted {num_threads_from_gui } threads, capped to {MAX_THREADS }.") - if SOFT_WARNING_THREAD_THRESHOLD
ℹ️ The following files from multi-file manga posts " - "(after the first file) kept their original names:
" - ) - self .log_signal .emit (intro_msg ) - - html_list_items ="- "
- for name in kept_original_names_list :
- html_list_items +=f"
- {name } " - html_list_items +="
" - "
- "
- "
- Best suited for large files (e.g., single post videos). " - "
- When downloading a full creator feed with many small files (like images):"
- "
- May not offer significant speed benefits. " - "
- Could potentially make the UI feel choppy. " - "
- May spam the process log with rapid, numerous small download messages.
"
- " - Consider using the 'Videos' filter if downloading a creator feed to primarily target large files for multi-part. " - "
" - "Do you want to enable multi-part download?" - ) - proceed_button =msg_box .addButton ("Proceed Anyway",QMessageBox .AcceptRole ) - cancel_button =msg_box .addButton ("Cancel",QMessageBox .RejectRole ) - msg_box .setDefaultButton (proceed_button ) - msg_box .exec_ () - - if msg_box .clickedButton ()==cancel_button : - self .log_signal .emit ("ℹ️ Multi-part download enabling cancelled by user.") - return - - self .allow_multipart_download_setting =not self .allow_multipart_download_setting - self ._update_multipart_toggle_button_text () - self .settings .setValue (ALLOW_MULTIPART_DOWNLOAD_KEY ,self .allow_multipart_download_setting ) - self .log_signal .emit (f"ℹ️ Multi-part download set to: {'Enabled'if self .allow_multipart_download_setting else 'Disabled'}") - - def _open_known_txt_file (self ): - if not os .path .exists (self .config_file ): - QMessageBox .warning (self ,"File Not Found", - f"The file 'Known.txt' was not found at:\n{self .config_file }\n\n" - "It will be created automatically when you add a known name or close the application.") - self .log_signal .emit (f"ℹ️ 'Known.txt' not found at {self .config_file }. It will be created later.") - return - - try : - if sys .platform =="win32": - os .startfile (self .config_file ) - elif sys .platform =="darwin": - subprocess .call (['open',self .config_file ]) - else : - subprocess .call (['xdg-open',self .config_file ]) - self .log_signal .emit (f"ℹ️ Attempted to open '{os .path .basename (self .config_file )}' with the default editor.") - except FileNotFoundError : - QMessageBox .critical (self ,"Error",f"Could not find '{os .path .basename (self .config_file )}' at {self .config_file } to open it.") - self .log_signal .emit (f"❌ Error: '{os .path .basename (self .config_file )}' not found at {self .config_file } when trying to open.") - except Exception as e : - QMessageBox .critical (self ,"Error Opening File",f"Could not open '{os .path .basename (self .config_file )}':\n{e }") - self .log_signal .emit (f"❌ Error opening '{os .path .basename (self .config_file )}': {e }") - - def _show_add_to_filter_dialog (self ): - global KNOWN_NAMES - if not KNOWN_NAMES : - QMessageBox .information (self ,"No Known Names","Your 'Known.txt' list is empty. Add some names first.") - return - - dialog =KnownNamesFilterDialog (KNOWN_NAMES ,self ,self ) - if dialog .exec_ ()==QDialog .Accepted : - selected_entries =dialog .get_selected_entries () - if selected_entries : - self ._add_names_to_character_filter_input (selected_entries ) - - def _add_names_to_character_filter_input (self ,selected_entries ): - """ - Adds the selected known name entries to the character filter input field. - """ - if not selected_entries : - return - - names_to_add_str_list =[] - for entry in selected_entries : - if entry .get ("is_group"): - aliases_str =", ".join (entry .get ("aliases",[])) - names_to_add_str_list .append (f"({aliases_str })~") - else : - names_to_add_str_list .append (entry .get ("name","")) - - names_to_add_str_list =[s for s in names_to_add_str_list if s ] - - if not names_to_add_str_list : - return - - current_filter_text =self .character_input .text ().strip () - new_text_to_append =", ".join (names_to_add_str_list ) - - self .character_input .setText (f"{current_filter_text }, {new_text_to_append }"if current_filter_text else new_text_to_append ) - self .log_signal .emit (f"ℹ️ Added to character filter: {new_text_to_append }") - - def _update_favorite_scope_button_text (self ): - if not hasattr (self ,'favorite_scope_toggle_button')or not self .favorite_scope_toggle_button : - return - if self .favorite_download_scope ==FAVORITE_SCOPE_SELECTED_LOCATION : - self .favorite_scope_toggle_button .setText (self ._tr ("favorite_scope_selected_location_text","Scope: Selected Location")) - - elif self .favorite_download_scope ==FAVORITE_SCOPE_ARTIST_FOLDERS : - self .favorite_scope_toggle_button .setText (self ._tr ("favorite_scope_artist_folders_text","Scope: Artist Folders")) - - else : - self .favorite_scope_toggle_button .setText (self ._tr ("favorite_scope_unknown_text","Scope: Unknown")) - - - def _cycle_favorite_scope (self ): - if self .favorite_download_scope ==FAVORITE_SCOPE_SELECTED_LOCATION : - self .favorite_download_scope =FAVORITE_SCOPE_ARTIST_FOLDERS - else : - self .favorite_download_scope =FAVORITE_SCOPE_SELECTED_LOCATION - self ._update_favorite_scope_button_text () - self .log_signal .emit (f"ℹ️ Favorite download scope changed to: '{self .favorite_download_scope }'") - - def _show_empty_popup (self ): - """Creates and shows the empty popup dialog.""" - if self.is_restore_pending: - QMessageBox.information(self, self._tr("restore_pending_title", "Restore Pending"), - self._tr("restore_pending_message_creator_selection", - "Please 'Restore Download' or 'Discard Session' before selecting new creators.")) - return - - dialog =EmptyPopupDialog (self .app_base_dir ,self ,self ) - if dialog .exec_ ()==QDialog .Accepted : - if hasattr (dialog ,'selected_creators_for_queue')and dialog .selected_creators_for_queue : - self .favorite_download_queue .clear () - - for creator_data in dialog .selected_creators_for_queue : - service =creator_data .get ('service') - creator_id =creator_data .get ('id') - creator_name =creator_data .get ('name','Unknown Creator') - domain =dialog ._get_domain_for_service (service ) - - if service and creator_id : - url =f"https://{domain }/{service }/user/{creator_id }" - queue_item ={ - 'url':url , - 'name':creator_name , - 'name_for_folder':creator_name , - 'type':'creator_popup_selection', - 'scope_from_popup':dialog .current_scope_mode - } - self .favorite_download_queue .append (queue_item ) - - if self .favorite_download_queue : - self .log_signal .emit (f"ℹ️ {len (self .favorite_download_queue )} creators added to download queue from popup. Click 'Start Download' to process.") - if hasattr (self ,'link_input'): - self .last_link_input_text_for_queue_sync =self .link_input .text () - - def _show_favorite_artists_dialog (self ): - if self ._is_download_active ()or self .is_processing_favorites_queue : - QMessageBox .warning (self ,"Busy","Another download operation is already in progress.") - return - - cookies_config ={ - 'use_cookie':self .use_cookie_checkbox .isChecked ()if hasattr (self ,'use_cookie_checkbox')else False , - 'cookie_text':self .cookie_text_input .text ()if hasattr (self ,'cookie_text_input')else "", - 'selected_cookie_file':self .selected_cookie_filepath , - 'app_base_dir':self .app_base_dir - } - - dialog =FavoriteArtistsDialog (self ,cookies_config ) - if dialog .exec_ ()==QDialog .Accepted : - selected_artists =dialog .get_selected_artists () - if selected_artists : - if len (selected_artists )>1 and self .link_input : - display_names =", ".join ([artist ['name']for artist in selected_artists ]) - if self .link_input : - self .link_input .clear () - self .link_input .setPlaceholderText (f"{len (selected_artists )} favorite artists selected for download queue.") - self .log_signal .emit (f"ℹ️ Multiple favorite artists selected. Displaying names: {display_names }") - elif len (selected_artists )==1 : - self .link_input .setText (selected_artists [0 ]['url']) - self .log_signal .emit (f"ℹ️ Single favorite artist selected: {selected_artists [0 ]['name']}") - - self .log_signal .emit (f"ℹ️ Queuing {len (selected_artists )} favorite artist(s) for download.") - for artist_data in selected_artists : - self .favorite_download_queue .append ({'url':artist_data ['url'],'name':artist_data ['name'],'name_for_folder':artist_data ['name'],'type':'artist'}) - - if not self .is_processing_favorites_queue : - self ._process_next_favorite_download () - else : - self .log_signal .emit ("ℹ️ No favorite artists were selected for download.") - QMessageBox .information (self , - self ._tr ("fav_artists_no_selection_title","No Selection"), - self ._tr ("fav_artists_no_selection_message","Please select at least one artist to download.")) - else : - self .log_signal .emit ("ℹ️ Favorite artists selection cancelled.") - - def _show_favorite_posts_dialog (self ): - if self ._is_download_active ()or self .is_processing_favorites_queue : - QMessageBox .warning (self ,"Busy","Another download operation is already in progress.") - return - - cookies_config ={ - 'use_cookie':self .use_cookie_checkbox .isChecked ()if hasattr (self ,'use_cookie_checkbox')else False , - 'cookie_text':self .cookie_text_input .text ()if hasattr (self ,'cookie_text_input')else "", - 'selected_cookie_file':self .selected_cookie_filepath , - 'app_base_dir':self .app_base_dir - } - global KNOWN_NAMES - - target_domain_preference_for_fetch =None - - if cookies_config ['use_cookie']: - self .log_signal .emit ("Favorite Posts: 'Use Cookie' is checked. Determining target domain...") - kemono_cookies =prepare_cookies_for_request ( - cookies_config ['use_cookie'], - cookies_config ['cookie_text'], - cookies_config ['selected_cookie_file'], - cookies_config ['app_base_dir'], - lambda msg :self .log_signal .emit (f"[FavPosts Cookie Check - Kemono] {msg }"), - target_domain ="kemono.su" - ) - coomer_cookies =prepare_cookies_for_request ( - cookies_config ['use_cookie'], - cookies_config ['cookie_text'], - cookies_config ['selected_cookie_file'], - cookies_config ['app_base_dir'], - lambda msg :self .log_signal .emit (f"[FavPosts Cookie Check - Coomer] {msg }"), - target_domain ="coomer.su" - ) - - kemono_ok =bool (kemono_cookies ) - coomer_ok =bool (coomer_cookies ) - - if kemono_ok and not coomer_ok : - target_domain_preference_for_fetch ="kemono.su" - self .log_signal .emit (" ↳ Only Kemono.su cookies loaded. Will fetch favorites from Kemono.su only.") - elif coomer_ok and not kemono_ok : - target_domain_preference_for_fetch ="coomer.su" - self .log_signal .emit (" ↳ Only Coomer.su cookies loaded. Will fetch favorites from Coomer.su only.") - elif kemono_ok and coomer_ok : - target_domain_preference_for_fetch =None - self .log_signal .emit (" ↳ Cookies for both Kemono.su and Coomer.su loaded. Will attempt to fetch from both.") - else : - self .log_signal .emit (" ↳ No valid cookies loaded for Kemono.su or Coomer.su.") - cookie_help_dialog =CookieHelpDialog (self ,self ) - cookie_help_dialog .exec_ () - return - else : - self .log_signal .emit ("Favorite Posts: 'Use Cookie' is NOT checked. Cookies are required.") - cookie_help_dialog =CookieHelpDialog (self ,self ) - cookie_help_dialog .exec_ () - return - - dialog =FavoritePostsDialog (self ,cookies_config ,KNOWN_NAMES ,target_domain_preference_for_fetch ) - if dialog .exec_ ()==QDialog .Accepted : - selected_posts =dialog .get_selected_posts () - if selected_posts : - self .log_signal .emit (f"ℹ️ Queuing {len (selected_posts )} favorite post(s) for download.") - for post_data in selected_posts : - domain =self ._get_domain_for_service (post_data ['service']) - direct_post_url =f"https://{domain }/{post_data ['service']}/user/{str (post_data ['creator_id'])}/post/{str (post_data ['post_id'])}" - - queue_item ={ - 'url':direct_post_url , - 'name':post_data ['title'], - 'name_for_folder':post_data ['creator_name_resolved'], - 'type':'post' - } - self .favorite_download_queue .append (queue_item ) - - if not self .is_processing_favorites_queue : - self ._process_next_favorite_download () - else : - self .log_signal .emit ("ℹ️ No favorite posts were selected for download.") - else : - self .log_signal .emit ("ℹ️ Favorite posts selection cancelled.") - - def _process_next_favorite_download (self ): - if self ._is_download_active (): - self .log_signal .emit ("ℹ️ Waiting for current download to finish before starting next favorite.") - return - if not self .favorite_download_queue : - if self .is_processing_favorites_queue : - self .is_processing_favorites_queue =False - item_type_log ="item" - if hasattr (self ,'current_processing_favorite_item_info')and self .current_processing_favorite_item_info : - item_type_log =self .current_processing_favorite_item_info .get ('type','item') - self .log_signal .emit (f"✅ All {item_type_log } downloads from favorite queue have been processed.") - self .set_ui_enabled (True ) - return - if not self .is_processing_favorites_queue : - self .is_processing_favorites_queue =True - self .current_processing_favorite_item_info =self .favorite_download_queue .popleft () - next_url =self .current_processing_favorite_item_info ['url'] - item_display_name =self .current_processing_favorite_item_info .get ('name','Unknown Item') - - item_type =self .current_processing_favorite_item_info .get ('type','artist') - self .log_signal .emit (f"▶️ Processing next favorite from queue: '{item_display_name }' ({next_url })") - - override_dir =None - item_scope =self .current_processing_favorite_item_info .get ('scope_from_popup') - if item_scope is None : - item_scope =self .favorite_download_scope - - main_download_dir =self .dir_input .text ().strip () - - - - - should_create_artist_folder =False - if item_type =='creator_popup_selection'and item_scope ==EmptyPopupDialog .SCOPE_CREATORS : - should_create_artist_folder =True - elif item_type !='creator_popup_selection'and self .favorite_download_scope ==FAVORITE_SCOPE_ARTIST_FOLDERS : - should_create_artist_folder =True - - if should_create_artist_folder and main_download_dir : - folder_name_key =self .current_processing_favorite_item_info .get ('name_for_folder','Unknown_Folder') - item_specific_folder_name =clean_folder_name (folder_name_key ) - override_dir =os .path .normpath (os .path .join (main_download_dir ,item_specific_folder_name )) - self .log_signal .emit (f" Scope requires artist folder. Target directory: '{override_dir }'") - - success_starting_download =self .start_download (direct_api_url =next_url ,override_output_dir =override_dir ) - - if not success_starting_download : - self .log_signal .emit (f"⚠️ Failed to initiate download for '{item_display_name }'. Skipping this item in queue.") - self .download_finished (total_downloaded =0 ,total_skipped =1 ,cancelled_by_user =True ,kept_original_names_list =[]) - -if __name__ =='__main__': - import traceback - import sys - import os - import time - - def handle_uncaught_exception (exc_type ,exc_value ,exc_traceback ): - """Handles uncaught exceptions by logging them to a file.""" - - if getattr (sys ,'frozen',False )and hasattr (sys ,'_MEIPASS'): - - base_dir_for_log =sys ._MEIPASS - else : - - base_dir_for_log =os .path .dirname (os .path .abspath (__file__ )) - - log_dir =os .path .join (base_dir_for_log ,"logs") - log_file_path =os .path .join (log_dir ,"uncaught_exceptions.log") - - try : - os .makedirs (os .path .dirname (log_file_path ),exist_ok =True ) - with open (log_file_path ,"a",encoding ="utf-8")as f : - f .write (f"Timestamp: {time .strftime ('%Y-%m-%d %H:%M:%S')}\n") - traceback .print_exception (exc_type ,exc_value ,exc_traceback ,file =f ) - f .write ("-"*80 +"\n\n") - except Exception as log_ex : - - print (f"CRITICAL: Failed to write to uncaught_exceptions.log: {log_ex }",file =sys .stderr ) - traceback .print_exception (exc_type ,exc_value ,exc_traceback ,file =sys .stderr ) - sys .__excepthook__ (exc_type ,exc_value ,exc_traceback ) - - sys .excepthook =handle_uncaught_exception - - try : - qt_app =QApplication (sys .argv ) - - QCoreApplication .setOrganizationName (CONFIG_ORGANIZATION_NAME ) - QCoreApplication .setApplicationName (CONFIG_APP_NAME_MAIN ) - if getattr (sys ,'frozen',False )and hasattr (sys ,'_MEIPASS'): - base_dir =sys ._MEIPASS - else : - base_dir =os .path .dirname (os .path .abspath (__file__ )) - icon_path =os .path .join (base_dir ,'assets','Kemono.ico') - if os .path .exists (icon_path ):qt_app .setWindowIcon (QIcon (icon_path )) - else :print (f"Warning: Application icon 'assets/Kemono.ico' not found at {icon_path }") - - downloader_app_instance =DownloaderApp () - primary_screen =QApplication .primaryScreen () - if not primary_screen : - screens =QApplication .screens () - if not screens : - downloader_app_instance .resize (1024 ,768 ) - downloader_app_instance .show () - sys .exit (qt_app .exec_ ()) - primary_screen =screens [0 ] - - available_geo =primary_screen .availableGeometry () - screen_width =available_geo .width () - screen_height =available_geo .height () - min_app_width =960 - min_app_height =680 - desired_app_width_ratio =0.80 - desired_app_height_ratio =0.85 - - app_width =max (min_app_width ,int (screen_width *desired_app_width_ratio )) - app_height =max (min_app_height ,int (screen_height *desired_app_height_ratio )) - app_width =min (app_width ,screen_width ) - app_height =min (app_height ,screen_height ) - - downloader_app_instance .resize (app_width ,app_height ) - downloader_app_instance .show () - downloader_app_instance ._center_on_screen () - try : - tour_result =TourDialog .run_tour_if_needed (downloader_app_instance ) - if tour_result ==QDialog .Accepted :print ("Tour completed by user.") - elif tour_result ==QDialog .Rejected :print ("Tour skipped or was already shown.") - except NameError : - print ("[Main] TourDialog class not found. Skipping tour.") - except Exception as e_tour : - print (f"[Main] Error during tour execution: {e_tour }") - - exit_code =qt_app .exec_ () - print (f"Application finished with exit code: {exit_code }") - sys .exit (exit_code ) - except SystemExit :pass - except Exception as e : - print ("--- CRITICAL APPLICATION ERROR ---") - print (f"An unhandled exception occurred: {e }") - traceback .print_exc () - print ("--- END CRITICAL ERROR ---") \ No newline at end of file + downloader_app_instance.resize(app_width, app_height) + + # Show the main window and center it + downloader_app_instance.show() + if hasattr(downloader_app_instance, '_center_on_screen'): + downloader_app_instance._center_on_screen() + + # --- First-Run Welcome Tour --- + # Check if the tour should be shown and run it. + # This static method call keeps the logic clean and contained. + if TourDialog.should_show_tour(): + tour_dialog = TourDialog(parent_app=downloader_app_instance) + tour_dialog.exec_() + + # --- Start Application --- + exit_code = qt_app.exec_() + print(f"Application finished with exit code: {exit_code}") + sys.exit(exit_code) + + except SystemExit: + # Allow sys.exit() to work as intended + pass + except Exception as e: + print("--- CRITICAL APPLICATION STARTUP ERROR ---") + print(f"An unhandled exception occurred during application startup: {e}") + traceback.print_exc() + print("--- END CRITICAL ERROR ---") + + +if __name__ == '__main__': + main() diff --git a/src/__init__.py b/src/__init__.py new file mode 100644 index 0000000..7c4386b --- /dev/null +++ b/src/__init__.py @@ -0,0 +1 @@ +# ...existing code... \ No newline at end of file diff --git a/src/config/__init__.py b/src/config/__init__.py new file mode 100644 index 0000000..7c4386b --- /dev/null +++ b/src/config/__init__.py @@ -0,0 +1 @@ +# ...existing code... \ No newline at end of file diff --git a/src/config/constants.py b/src/config/constants.py new file mode 100644 index 0000000..0386606 --- /dev/null +++ b/src/config/constants.py @@ -0,0 +1,110 @@ +# --- Application Metadata --- +CONFIG_ORGANIZATION_NAME = "KemonoDownloader" +CONFIG_APP_NAME_MAIN = "ApplicationSettings" +CONFIG_APP_NAME_TOUR = "ApplicationTour" + +# --- Filename and Folder Naming Styles --- +STYLE_POST_TITLE = "post_title" +STYLE_ORIGINAL_NAME = "original_name" +STYLE_DATE_BASED = "date_based" +STYLE_DATE_POST_TITLE = "date_post_title" +STYLE_POST_TITLE_GLOBAL_NUMBERING = "post_title_global_numbering" +MANGA_DATE_PREFIX_DEFAULT = "" + +# --- Download Scopes --- +SKIP_SCOPE_FILES = "files" +SKIP_SCOPE_POSTS = "posts" +SKIP_SCOPE_BOTH = "both" + +CHAR_SCOPE_TITLE = "title" +CHAR_SCOPE_FILES = "files" +CHAR_SCOPE_BOTH = "both" +CHAR_SCOPE_COMMENTS = "comments" + +FAVORITE_SCOPE_SELECTED_LOCATION = "selected_location" +FAVORITE_SCOPE_ARTIST_FOLDERS = "artist_folders" + +# --- Download Status Constants --- +FILE_DOWNLOAD_STATUS_SUCCESS = "success" +FILE_DOWNLOAD_STATUS_SKIPPED = "skipped" +FILE_DOWNLOAD_STATUS_FAILED_RETRYABLE_LATER = "failed_retry_later" +FILE_DOWNLOAD_STATUS_FAILED_PERMANENTLY_THIS_SESSION = "failed_permanent_session" + +# --- Threading and Performance --- +MAX_THREADS = 200 +RECOMMENDED_MAX_THREADS = 50 +SOFT_WARNING_THREAD_THRESHOLD = 40 +MAX_FILE_THREADS_PER_POST_OR_WORKER = 10 +POST_WORKER_BATCH_THRESHOLD = 30 +POST_WORKER_NUM_BATCHES = 4 +POST_WORKER_BATCH_DELAY_SECONDS = 2.5 +MAX_POST_WORKERS_WHEN_COMMENT_FILTERING = 3 + +# --- Multipart Download Settings --- +MIN_SIZE_FOR_MULTIPART_DOWNLOAD = 10 * 1024 * 1024 # 10 MB +MAX_PARTS_FOR_MULTIPART_DOWNLOAD = 15 + +# --- UI and Settings Keys (for QSettings) --- +TOUR_SHOWN_KEY = "neverShowTourAgainV19" +MANGA_FILENAME_STYLE_KEY = "mangaFilenameStyleV1" +SKIP_WORDS_SCOPE_KEY = "skipWordsScopeV1" +ALLOW_MULTIPART_DOWNLOAD_KEY = "allowMultipartDownloadV1" +USE_COOKIE_KEY = "useCookieV1" +COOKIE_TEXT_KEY = "cookieTextV1" +CHAR_FILTER_SCOPE_KEY = "charFilterScopeV1" +THEME_KEY = "currentThemeV2" +SCAN_CONTENT_IMAGES_KEY = "scanContentForImagesV1" +LANGUAGE_KEY = "currentLanguageV1" +DOWNLOAD_LOCATION_KEY = "downloadLocationV1" + +# --- UI Constants and Identifiers --- +HTML_PREFIX = "" +LOG_DISPLAY_LINKS = "links" +LOG_DISPLAY_DOWNLOAD_PROGRESS = "download_progress" + +# --- Dialog Return Codes --- +CONFIRM_ADD_ALL_ACCEPTED = 1 +CONFIRM_ADD_ALL_SKIP_ADDING = 2 +CONFIRM_ADD_ALL_CANCEL_DOWNLOAD = 3 + +# --- File Type Extensions --- +IMAGE_EXTENSIONS = { + '.jpg', '.jpeg', '.png', '.gif', '.bmp', '.tiff', '.tif', '.webp', + '.heic', '.heif', '.svg', '.ico', '.jfif', '.pjpeg', '.pjp', '.avif' +} +VIDEO_EXTENSIONS = { + '.mp4', '.mov', '.mkv', '.webm', '.avi', '.wmv', '.flv', '.mpeg', + '.mpg', '.m4v', '.3gp', '.ogv', '.ts', '.vob' +} +ARCHIVE_EXTENSIONS = { + '.zip', '.rar', '.7z', '.tar', '.gz', '.bz2' +} +AUDIO_EXTENSIONS = { + '.mp3', '.wav', '.aac', '.flac', '.ogg', '.wma', '.m4a', '.opus', + '.aiff', '.ape', '.mid', '.midi' +} + +# --- Text Processing Constants --- +MAX_FILENAME_COMPONENT_LENGTH = 150 + +# Words to ignore when creating folder names from titles +FOLDER_NAME_STOP_WORDS = { + "a", "alone", "am", "an", "and", "at", "be", "by", "com", + "for", "he", "her", "his", "i", "im", "in", "is", "it", "its", + "me", "my", "net", "not", "of", "on", "or", "org", "our", + "s", "she", "so", "the", "their", "they", "this", + "to", "ve", "was", "we", "were", "with", "www", "you", "your", +} + +# Additional words to ignore specifically for creator-level downloads +CREATOR_DOWNLOAD_DEFAULT_FOLDER_IGNORE_WORDS = { + "poll", "cover", "fan-art", "fanart", "requests", "request", "holiday", + "batch", "open", "closed", "winner", "loser", "wip", + "update", "news", "discussion", "question", "stream", "video", "sketchbook", + # Months and days + "jan", "january", "feb", "february", "mar", "march", "apr", "april", + "may", "jun", "june", "jul", "july", "aug", "august", "sep", "september", + "oct", "october", "nov", "november", "dec", "december", + "mon", "monday", "tue", "tuesday", "wed", "wednesday", "thu", "thursday", + "fri", "friday", "sat", "saturday", "sun", "sunday" +} diff --git a/src/core/__init__.py b/src/core/__init__.py new file mode 100644 index 0000000..7c4386b --- /dev/null +++ b/src/core/__init__.py @@ -0,0 +1 @@ +# ...existing code... \ No newline at end of file diff --git a/src/core/api_client.py b/src/core/api_client.py new file mode 100644 index 0000000..9a37b5f --- /dev/null +++ b/src/core/api_client.py @@ -0,0 +1,321 @@ +# --- Standard Library Imports --- +import time +import traceback +from urllib.parse import urlparse + +# --- Third-Party Library Imports --- +import requests + +# --- Local Application Imports --- +from ..utils.network_utils import extract_post_info, prepare_cookies_for_request +from ..config.constants import ( + STYLE_DATE_POST_TITLE +) + + +def fetch_posts_paginated(api_url_base, headers, offset, logger, cancellation_event=None, pause_event=None, cookies_dict=None): + """ + Fetches a single page of posts from the API with retry logic. + + Args: + api_url_base (str): The base URL for the user's posts. + headers (dict): The request headers. + offset (int): The offset for pagination. + logger (callable): Function to log messages. + cancellation_event (threading.Event): Event to signal cancellation. + pause_event (threading.Event): Event to signal pause. + cookies_dict (dict): A dictionary of cookies to include in the request. + + Returns: + list: A list of post data dictionaries from the API. + + Raises: + RuntimeError: If the fetch fails after all retries or encounters a non-retryable error. + """ + if cancellation_event and cancellation_event.is_set(): + logger(" Fetch cancelled before request.") + raise RuntimeError("Fetch operation cancelled by user.") + if pause_event and pause_event.is_set(): + logger(" Post fetching paused...") + while pause_event.is_set(): + if cancellation_event and cancellation_event.is_set(): + logger(" Post fetching cancelled while paused.") + raise RuntimeError("Fetch operation cancelled by user.") + time.sleep(0.5) + logger(" Post fetching resumed.") + + paginated_url = f'{api_url_base}?o={offset}' + max_retries = 3 + retry_delay = 5 + + for attempt in range(max_retries): + if cancellation_event and cancellation_event.is_set(): + raise RuntimeError("Fetch operation cancelled by user during retry loop.") + + log_message = f" Fetching: {paginated_url} (Page approx. {offset // 50 + 1})" + if attempt > 0: + log_message += f" (Attempt {attempt + 1}/{max_retries})" + logger(log_message) + + try: + response = requests.get(paginated_url, headers=headers, timeout=(15, 90), cookies=cookies_dict) + response.raise_for_status() + + if 'application/json' not in response.headers.get('Content-Type', '').lower(): + logger(f"⚠️ Unexpected content type from API: {response.headers.get('Content-Type')}. Body: {response.text[:200]}") + return [] + + return response.json() + + except (requests.exceptions.Timeout, requests.exceptions.ConnectionError) as e: + logger(f" ⚠️ Retryable network error on page fetch (Attempt {attempt + 1}): {e}") + if attempt < max_retries - 1: + delay = retry_delay * (2 ** attempt) + logger(f" Retrying in {delay} seconds...") + time.sleep(delay) + continue + else: + logger(f" ❌ Failed to fetch page after {max_retries} attempts.") + raise RuntimeError(f"Timeout or connection error fetching offset {offset}") + except requests.exceptions.RequestException as e: + err_msg = f"Error fetching offset {offset}: {e}" + if e.response is not None: + err_msg += f" (Status: {e.response.status_code}, Body: {e.response.text[:200]})" + raise RuntimeError(err_msg) + except ValueError as e: # JSON decode error + raise RuntimeError(f"Error decoding JSON from offset {offset}: {e}. Response: {response.text[:200]}") + + raise RuntimeError(f"Failed to fetch page {paginated_url} after all attempts.") + + +def fetch_post_comments(api_domain, service, user_id, post_id, headers, logger, cancellation_event=None, pause_event=None, cookies_dict=None): + """Fetches all comments for a specific post.""" + if cancellation_event and cancellation_event.is_set(): + raise RuntimeError("Comment fetch operation cancelled by user.") + + comments_api_url = f"https://{api_domain}/api/v1/{service}/user/{user_id}/post/{post_id}/comments" + logger(f" Fetching comments: {comments_api_url}") + + try: + response = requests.get(comments_api_url, headers=headers, timeout=(10, 30), cookies=cookies_dict) + response.raise_for_status() + return response.json() + except requests.exceptions.RequestException as e: + raise RuntimeError(f"Error fetching comments for post {post_id}: {e}") + except ValueError as e: + raise RuntimeError(f"Error decoding JSON from comments API for post {post_id}: {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 , +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']): + logger (f"⚠️ Unrecognized domain '{api_domain }' from input URL. Defaulting to kemono.su for API calls.") + api_domain ="kemono.su" + cookies_for_api =None + if use_cookie and app_base_dir : + cookies_for_api =prepare_cookies_for_request (use_cookie ,cookie_text ,selected_cookie_file ,app_base_dir ,logger ,target_domain =api_domain ) + if target_post_id : + direct_post_api_url =f"https://{api_domain }/api/v1/{service }/user/{user_id }/post/{target_post_id }" + logger (f" Attempting direct fetch for target post: {direct_post_api_url }") + try : + direct_response =requests .get (direct_post_api_url ,headers =headers ,timeout =(10 ,30 ),cookies =cookies_for_api ) + direct_response .raise_for_status () + direct_post_data =direct_response .json () + if isinstance (direct_post_data ,list )and direct_post_data : + direct_post_data =direct_post_data [0 ] + if isinstance (direct_post_data ,dict )and 'post'in direct_post_data and isinstance (direct_post_data ['post'],dict ): + direct_post_data =direct_post_data ['post'] + if isinstance (direct_post_data ,dict )and direct_post_data .get ('id')==target_post_id : + logger (f" ✅ Direct fetch successful for post {target_post_id }.") + yield [direct_post_data ] + return + else : + response_type =type (direct_post_data ).__name__ + response_snippet =str (direct_post_data )[:200 ] + logger (f" ⚠️ Direct fetch for post {target_post_id } returned unexpected data (Type: {response_type }, Snippet: '{response_snippet }'). Falling back to pagination.") + except requests .exceptions .RequestException as e : + logger (f" ⚠️ Direct fetch failed for post {target_post_id }: {e }. Falling back to pagination.") + except Exception as e : + logger (f" ⚠️ Unexpected error during direct fetch for post {target_post_id }: {e }. Falling back to pagination.") + if not service or not user_id : + logger (f"❌ Invalid URL or could not extract service/user: {api_url_input }") + 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_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_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 : + current_offset_manga =(start_page -1 )*page_size + logger (f" Manga Mode: Starting fetch from page {start_page } (offset {current_offset_manga }).") + elif start_page : + logger (f" Manga Mode: Starting fetch from page 1 (offset 0).") + if end_page : + logger (f" Manga Mode: Will fetch up to page {end_page }.") + while True : + if pause_event and pause_event .is_set (): + logger (" Manga mode post fetching paused...") + while pause_event .is_set (): + if cancellation_event and cancellation_event .is_set (): + logger (" Manga mode post fetching cancelled while paused.") + break + time .sleep (0.5 ) + if not (cancellation_event and cancellation_event .is_set ()):logger (" Manga mode post fetching resumed.") + if cancellation_event and cancellation_event .is_set (): + logger (" Manga mode post fetching cancelled.") + break + current_page_num_manga =(current_offset_manga //page_size )+1 + if end_page and current_page_num_manga >end_page : + logger (f" Manga Mode: Reached specified end page ({end_page }). Stopping post fetch.") + break + try : + posts_batch_manga =fetch_posts_paginated (api_base_url ,headers ,current_offset_manga ,logger ,cancellation_event ,pause_event ,cookies_dict =cookies_for_api ) + if not isinstance (posts_batch_manga ,list ): + logger (f"❌ API Error (Manga Mode): Expected list of posts, got {type (posts_batch_manga )}.") + break + if not posts_batch_manga : + logger ("✅ Reached end of posts (Manga Mode fetch all).") + if start_page and not end_page and current_page_num_manga
To use cookies, you typically need a cookies.txt file from your browser.
", -"cookie_help_how_to_get_title":"How to get cookies.txt:
", -"download_history_dialog_title_first_processed": "First Processed Files History", -"first_files_processed_header": "First {count} Files Processed in this Session:", -"history_file_label": "File:", -"history_from_post_label": "From Post:", -"history_post_uploaded_label": "Post Uploaded:", -"history_file_downloaded_label": "File Downloaded:", -"download_history_dialog_title_empty": "Download History (Empty)", -"no_download_history_header": "No Downloads Yet", -"cookie_help_step1_extension_intro":"Get cookies.txt LOCALLY on Chrome Web Store
cookies.txt file to your computer.- ",
-"cookie_help_step6a_checkbox":"
- Ensure the 'Use Cookie' checkbox is checked. ", -"cookie_help_step6b_browse":"
- Click the 'Browse...' button next to the cookie text field. ", -"cookie_help_step6c_select":"
- Select the
cookies.txtfile you just saved.
Alternatively, some extensions might allow you to copy the cookie string directly. If so, you can paste it into the text field instead of browsing for a file.
", -"cookie_help_proceed_without_button":"Download without Cookies", -"cookie_help_cancel_download_button":"Cancel Download", -"character_input_tooltip":( -"Enter character names (comma-separated). Supports advanced grouping and affects folder naming " -"if 'Separate Folders' is enabled.\n\n" -"Examples:\n" -"- Nami → Matches 'Nami', creates folder 'Nami'.\n" -"- (Ulti, Vivi) → Matches either, folder 'Ulti Vivi', adds both to Known.txt separately.\n" -"- (Boa, Hancock)~ → Matches either, folder 'Boa Hancock', adds as one group in Known.txt.\n\n" -"Names are treated as aliases for matching.\n\n" -"Filter Modes (button cycles):\n" -"- Files: Filters by filename.\n" -"- Title: Filters by post title.\n" -"- Both: Title first, then filename.\n" -"- Comments (Beta): Filename first, then post comments." -), -"tour_dialog_title":"Welcome to Kemono Downloader!", -"tour_dialog_never_show_checkbox":"Never show this tour again", -"tour_dialog_skip_button":"Skip Tour", -"tour_dialog_back_button":"Back", -"tour_dialog_next_button":"Next", -"tour_dialog_finish_button":"Finish", -"tour_dialog_step1_title":"👋 Welcome!", -"tour_dialog_step1_content":"""Hello! This quick tour will walk you through the main features of the Kemono Downloader, including recent updates like enhanced filtering, manga mode improvements, and cookie management. --
-
- My goal is to help you easily download content from Kemono and Coomer.
- 🎨 Creator Selection Button: Next to the URL input, click the palette icon to open a dialog. Browse and select creators from your
creators.jsonfile to quickly add their names to the URL input. - Important Tip: App '(Not Responding)'?
- After clicking 'Start Download', especially for large creator feeds or with many threads, the application might temporarily show as '(Not Responding)'. Your operating system (Windows, macOS, Linux) might even suggest you 'End Process' or 'Force Quit'.
- Please be patient! The app is often still working hard in the background. Before force-closing, try checking your chosen 'Download Location' in your file explorer. If you see new folders being created or files appearing, it means the download is progressing correctly. Give it some time to become responsive again. - Use the Next and Back buttons to navigate.
- Many options have tooltips if you hover over them for more details.
- Click Skip Tour to close this guide at any time.
- Check 'Never show this tour again' if you don't want to see this on future startups. -
-
-
-
-
-
-
-
-
- 🔗 Kemono Creator/Post URL:
- Paste the full web address (URL) of a creator's page (e.g., https://kemono.su/patreon/user/12345) - or a specific post (e.g., .../post/98765). - 📁 Download Location:
- Click 'Browse...' to choose a folder on your computer where all downloaded files will be saved. - This is required unless you are using 'Only Links' mode. - 📄 Page Range (Creator URLs only):
- If downloading from a creator's page, you can specify a range of pages to fetch (e.g., pages 2 to 5). - Leave blank for all pages. This is disabled for single post URLs or when Manga/Comic Mode is active.
-
- or a Coomer creator (e.g., https://coomer.su/onlyfans/user/artistname) -
-
-
-
- 🎯 Filter by Character(s):
- Enter character names, comma-separated (e.g., Tifa, Aerith). Group aliases for a combined folder name: (alias1, alias2, alias3) becomes folder 'alias1 alias2 alias3' (after cleaning). All names in the group are used as aliases for matching.
- The 'Filter: [Type]' button (next to this input) cycles how this filter applies: -- Filter: Files: Checks individual filenames. A post is kept if any file matches; only matching files are downloaded. Folder naming uses the character from the matching filename (if 'Separate Folders' is on).
- Filter: Title: Checks post titles. All files from a matching post are downloaded. Folder naming uses the character from the matching post title. -
- ⤵️ Add to Filter Button (Known Names): Next to the 'Add' button for Known Names (see Step 5), this opens a popup. Select names from your
Known.txtlist via checkboxes (with a search bar) to quickly add them to the 'Filter by Character(s)' field. Grouped names like(Boa, Hancock)from Known.txt will be added as(Boa, Hancock)~to the filter. - Filter: Both: Checks post title first. If it matches, all files are downloaded. If not, it then checks filenames, and only matching files are downloaded. Folder naming prioritizes title match, then file match.
- Filter: Comments (Beta): Checks filenames first. If a file matches, all files from the post are downloaded. If no file match, it then checks post comments. If a comment matches, all files are downloaded. (Uses more API requests). Folder naming prioritizes file match, then comment match.
-
-
- - 🚫 Skip with Words:
- Enter words, comma-separated (e.g., WIP, sketch, preview). - The 'Scope: [Type]' button (next to this input) cycles how this filter applies: -- Scope: Files: Skips files if their names contain any of these words.
- Scope: Posts: Skips entire posts if their titles contain any of these words.
- Scope: Both: Applies both file and post title skipping (post first, then files).
-
- - Filter Files (Radio Buttons): Choose what to download:
-
-
-
- All: Downloads all file types found.
- Images/GIFs: Only common image formats and GIFs.
- Videos: Only common video formats.
- 📦 Only Archives: Exclusively downloads .zip and .rar files. When selected, 'Skip .zip' and 'Skip .rar' checkboxes are automatically disabled and unchecked. 'Show External Links' is also disabled.
- 🎧 Only Audio: Only common audio formats (MP3, WAV, FLAC, etc.).
- 🔗 Only Links: Extracts and displays external links from post descriptions instead of downloading files. Download-related options and 'Show External Links' are disabled. -
-
-
-
-
-
-
-
-
-
-
- ⭐ Favorite Mode Checkbox:
- Located next to the '🔗 Only Links' radio button. Check this to activate Favorite Mode. - What Happens in Favorite Mode:
-
- The '🔗 Kemono Creator/Post URL' input area is replaced with a message indicating Favorite Mode is active.
- The standard 'Start Download', 'Pause', 'Cancel' buttons are replaced with '🖼️ Favorite Artists' and '📄 Favorite Posts' buttons (Note: 'Favorite Posts' is planned for the future).
- The '🍪 Use Cookie' option is automatically enabled and locked, as cookies are required to fetch your favorites.
-
- - 🖼️ Favorite Artists Button:
- Click this to open a dialog listing your favorited artists from Kemono.su. You can select one or more artists to download. - Favorite Download Scope (Button):
- This button (next to 'Favorite Posts') controls where selected favorites are downloaded: -- Scope: Selected Location: All selected artists are downloaded into the main 'Download Location' you've set. Filters apply globally.
- Scope: Artist Folders: A subfolder (named after the artist) is created inside your main 'Download Location' for each selected artist. Content for that artist goes into their specific subfolder. Filters apply within each artist's folder.
- - Filters in Favorite Mode:
- The 'Filter by Character(s)', 'Skip with Words', and 'Filter Files' options still apply to the content downloaded from your selected favorite artists.
-
-
-
-
-
-
-
- Skip .zip / Skip .rar: Check these to avoid downloading these archive file types. - (Note: These are disabled and ignored if '📦 Only Archives' filter mode is selected).
- ✂️ Remove Words from name:
- Enter words, comma-separated (e.g., patreon, [HD]), to remove from downloaded filenames (case-insensitive). - Download Thumbnails Only: Downloads small preview images instead of full-sized files (if available).
- Compress Large Images: If the 'Pillow' library is installed, images larger than 1.5MB will be converted to WebP format if the WebP version is significantly smaller.
- 🗄️ Custom Folder Name (Single Post Only):
- If you are downloading a single specific post URL AND 'Separate Folders by Name/Title' is enabled, - you can enter a custom name here for that post's download folder. - 🍪 Use Cookie: Check this to use cookies for requests. You can either:
-
- Enter a cookie string directly into the text field (e.g., name1=value1; name2=value2).
- Click 'Browse...' to select a cookies.txt file (Netscape format). The path will appear in the text field.
-
-
-
-
-
-
-
-
-
- ⚙️ Separate Folders by Name/Title: Creates subfolders based on the 'Filter by Character(s)' input or post titles (can use the Known.txt list as a fallback for folder names).
- Subfolder per Post: If 'Separate Folders' is on, this creates an additional subfolder for each individual post inside the main character/title folder.
- 🚀 Use Multithreading (Threads): Enables faster operations. The number in 'Threads' input means:
-
- For Creator Feeds: Number of posts to process simultaneously. Files within each post are downloaded sequentially by its worker (unless 'Date Based' manga naming is on, which forces 1 post worker).
- For Single Post URLs: Number of files to download concurrently from that single post.
- - Multi-part Download Toggle (Top-right of log area):
- The 'Multi-part: [ON/OFF]' button allows enabling/disabling multi-segment downloads for individual large files. -- ON: Can speed up large file downloads (e.g., videos) but may increase UI choppiness or log spam with many small files. An advisory will appear when enabling. If a multi-part download fails, it retries as single-stream.
- OFF (Default): Files are downloaded in a single stream.
- - 📖 Manga/Comic Mode (Creator URLs only): Tailored for sequential content.
-
-
-
- Downloads posts from oldest to newest.
- The 'Page Range' input is disabled as all posts are fetched.
- A filename style toggle button (e.g., 'Name: Post Title') appears in the top-right of the log area when this mode is active for a creator feed. Click it to cycle through naming styles:
-
-
-
- Name: Post Title (Default): The first file in a post is named after the post's cleaned title (e.g., 'My Chapter 1.jpg'). Subsequent files within the *same post* will attempt to keep their original filenames (e.g., 'page_02.png', 'bonus_art.jpg'). If the post has only one file, it's named after the post title. This is generally recommended for most manga/comics.
- Name: Original File: All files attempt to keep their original filenames. An optional prefix (e.g., 'MySeries_') can be entered in the input field that appears next to the style button. Example: 'MySeries_OriginalFile.jpg'.
- Name: Title+G.Num (Post Title + Global Numbering): All files across all posts in the current download session are named sequentially using the post's cleaned title as a prefix, followed by a global counter. For example: Post 'Chapter 1' (2 files) -> 'Chapter 1_001.jpg', 'Chapter 1_002.png'. The next post, 'Chapter 2' (1 file), would continue the numbering -> 'Chapter 2_003.jpg'. Multithreading for post processing is automatically disabled for this style to ensure correct global numbering.
- Name: Date Based: Files are named sequentially (001.ext, 002.ext, ...) based on post publication order. An optional prefix (e.g., 'MySeries_') can be entered in the input field that appears next to the style button. Example: 'MySeries_001.jpg'. Multithreading for post processing is automatically disabled for this style. -
-
-
- - For best results with 'Name: Post Title', 'Name: Title+G.Num', or 'Name: Date Based' styles, use the 'Filter by Character(s)' field with the manga/series title for folder organization. -
-
-
- - 🎭 Known.txt for Smart Folder Organization:
-Known.txt(in the app's directory) allows fine-grained control over automatic folder organization when 'Separate Folders by Name/Title' is active. --
-
- How it Works: Each line in
Known.txtis an entry. -- A simple line like
My Awesome Seriesmeans content matching this will go into a folder named "My Awesome Series". - A grouped line like
(Character A, Char A, Alt Name A)means content matching "Character A", "Char A", OR "Alt Name A" will ALL go into a single folder named "Character A Char A Alt Name A" (after cleaning). All terms in the parentheses become aliases for that folder.
-
- - A simple line like
- Intelligent Fallback: When 'Separate Folders by Name/Title' is active, and if a post doesn't match any specific 'Filter by Character(s)' input, the downloader consults
Known.txtto find a matching primary name for folder creation. - User-Friendly Management: Add simple (non-grouped) names via the UI list below. For advanced editing (like creating/modifying grouped aliases), click 'Open Known.txt' to edit the file in your text editor. The app reloads it on next use or startup. -
-
- - How it Works: Each line in
-
-
-
-
-
-
-
- Character Input Tooltip:
- Enter character names, comma-separated (e.g., Tifa, Aerith).
- Group aliases for a combined folder name: (alias1, alias2, alias3) becomes folder 'alias1 alias2 alias3'.
- All names in the group are used as aliases for matching content.
- The 'Filter: [Type]' button next to this input cycles how this filter applies:
- - Filter: Files: Checks individual filenames. Only matching files are downloaded.
- - Filter: Title: Checks post titles. All files from a matching post are downloaded.
- - Filter: Both: Checks post title first. If no match, then checks filenames.
- - Filter: Comments (Beta): Checks filenames first. If no match, then checks post comments.
- This filter also influences folder naming if 'Separate Folders by Name/Title' is enabled. - 502 Bad Gateway / 503 Service Unavailable / 504 Gateway Timeout:
- These usually indicate temporary server-side problems with Kemono/Coomer. The site might be overloaded, down for maintenance, or experiencing issues.
- Solution: Wait a while (e.g., 30 minutes to a few hours) and try again later. Check the site directly in your browser. - Connection Lost / Connection Refused / Timeout (during file download):
- This can happen due to your internet connection, server instability, or if the server drops the connection for a large file.
- Solution: Check your internet. Try reducing the number of 'Threads' if it's high. The app might prompt to retry some failed files at the end of a session. - IncompleteRead Error:
- The server sent less data than expected. Often a temporary network hiccup or server issue.
- Solution: The app will often mark these files for a retry attempt at the end of the download session. - 403 Forbidden / 401 Unauthorized (less common for public posts):
- You might not have permission to access the content. For some paywalled or private content, using the 'Use Cookie' option with valid cookies from your browser session might help. Ensure your cookies are fresh. - 404 Not Found:
- The post or file URL is incorrect, or the content has been removed from the site. Double-check the URL. - 'No posts found' / 'Target post not found':
- Ensure the URL is correct and the creator/post exists. If using page ranges, make sure they are valid for the creator. For very new posts, there might be a slight delay before they appear in the API. - General Slowness / App '(Not Responding)':
- As mentioned in Step 1, if the app seems to hang after starting, especially with large creator feeds or many threads, please give it time. It's likely processing data in the background. Reducing thread count can sometimes improve responsiveness if this is frequent.
-
-
-
-
-
-
-
-
-
-
- 📜 Progress Log / Extracted Links Log: Shows detailed download messages. If '🔗 Only Links' mode is active, this area displays the extracted links.
- Show External Links in Log: If checked, a secondary log panel appears below the main log to display any external links found in post descriptions. (This is disabled if '🔗 Only Links' or '📦 Only Archives' mode is active).
- Log View Toggle (👁️ / 🙈 Button):
- This button (top-right of log area) switches the main log view: -- 👁️ Progress Log (Default): Shows all download activity, errors, and summaries.
- 🙈 Missed Character Log: Displays a list of key terms from post titles that were skipped due to your 'Filter by Character(s)' settings. Useful for identifying content you might be unintentionally missing.
- - 🔄 Reset: Clears all input fields, logs, and resets temporary settings to their defaults. Can only be used when no download is active.
- ⬇️ Start Download / 🔗 Extract Links / ⏸️ Pause / ❌ Cancel: These buttons control the process. 'Cancel & Reset UI' stops the current operation and performs a soft UI reset, preserving your URL and Directory inputs. 'Pause/Resume' allows temporarily halting and continuing.
- If some files fail with recoverable errors (like 'IncompleteRead'), you might be prompted to retry them at the end of a session. -
-
-
-
-
-
You're all set! Click 'Finish' to close the tour and start using the downloader.""" -}, -} - -translations ["zh_TW"]={ "settings_dialog_title": "設定", +translations ["zh_TW"]={ + "settings_dialog_title": "設定", "language_label": "語言：", "lang_english": "英文 (English)", "lang_japanese": "日文 (日本語)", @@ -3161,532 +2605,648 @@ translations ["fr"]={ "help_guide_step9_content": "
Fichiers clés utilisés par l'application
\n- \n
Known.txt:\n- \n
- Situé dans le répertoire de l'application (où se trouve le
.exeoumain.py). \n - Stocke votre liste de séries, personnages ou titres de séries connus pour l'organisation automatique des dossiers lorsque 'Dossiers séparés par Nom/Titre' est activé. \n
- Format :\n
- \n
- Chaque ligne est une entrée. \n
- Nom simple : par ex.,
Ma Super Série. Le contenu correspondant ira dans un dossier nommé \"Ma Super Série\". \n - Alias groupés : par ex.,
(Personnage A, Perso A, Nom Alt A). Le contenu correspondant à \"Personnage A\", \"Perso A\", OU \"Nom Alt A\" ira TOUS dans un seul dossier nommé \"Personnage A Perso A Nom Alt A\" (après nettoyage). Tous les termes entre parenthèses deviennent des alias pour ce dossier. \n
\n - Utilisation : Sert de solution de repli pour le nommage des dossiers si une publication ne correspond pas à votre entrée active 'Filtrer par Personnage(s)'. Vous pouvez gérer les entrées simples via l'UI ou éditer le fichier directement pour les alias complexes. L'application le recharge au démarrage ou à la prochaine utilisation. \n
\n- Situé dans le répertoire de l'application (où se trouve le
cookies.txt(Optionnel) :\n- \n
- Si vous utilisez la fonctionnalité 'Utiliser le cookie' et que vous ne fournissez pas de chaîne de cookie directe ou que vous ne parcourez pas un fichier spécifique, l'application cherchera un fichier nommé
cookies.txtdans son répertoire. \n - Format : Doit être au format de fichier de cookie Netscape. \n
- Utilisation : Permet au téléchargeur d'utiliser la session de connexion de votre navigateur pour accéder au contenu qui pourrait être derrière une connexion sur Kemono/Coomer. \n
\n- Si vous utilisez la fonctionnalité 'Utiliser le cookie' et que vous ne fournissez pas de chaîne de cookie directe ou que vous ne parcourez pas un fichier spécifique, l'application cherchera un fichier nommé
Visite pour le premier utilisateur
\n- \n
- Au premier lancement (ou si réinitialisé), une boîte de dialogue de visite de bienvenue apparaît, vous guidant à travers les principales fonctionnalités. Vous pouvez la passer ou choisir de \"Ne plus jamais afficher cette visite.\" \n
De nombreux éléments de l'UI ont également des info-bulles qui apparaissent lorsque vous survolez votre souris, fournissant des conseils rapides.
\n" } +translations ["en"]={ + "settings_dialog_title": "Settings", + "language_label": "Language:", + "lang_english": "English", + "lang_japanese": "Japanese (日本語)", + "theme_toggle_light": "Switch to light mode", + "theme_toggle_dark": "Switch to dark mode", + "theme_tooltip_light": "Change the application's appearance to light.", + "theme_tooltip_dark": "Change the application's appearance to dark.", + "ok_button": "OK", + "appearance_group_title": "Appearance", + "language_group_title": "Language Settings", + "creator_post_url_label": "🔗 Creator/Post Kemono URL:", + "download_location_label": "📁 Download Location:", + "filter_by_character_label": "🎯 Filter by Character(s) (comma-separated):", + "skip_with_words_label": "🚫 Skip with words (comma-separated):", + "remove_words_from_name_label": "✂️ Remove words from name:", + "filter_all_radio": "All", + "filter_images_radio": "Images/GIFs", + "filter_videos_radio": "Videos", + "filter_archives_radio": "📦 Only Archives", + "filter_links_radio": "🔗 Only Links", + "filter_audio_radio": "🎧 Only Audio", + "favorite_mode_checkbox_label": "⭐ Favorite Mode", + "browse_button_text": "Browse...", + "char_filter_scope_files_text": "Filter: Files", + "char_filter_scope_files_tooltip": "Current scope: Files\n\nFilters individual files by name. A post is kept if any file matches.\nOnly the matching files from that post are downloaded.\nExample: Filter 'Tifa'. File 'Tifa_artwork.jpg' matches and is downloaded.\nFolder Naming: Uses the character from the matching filename.\n\nClick to switch to: Both", + "char_filter_scope_title_text": "Filter: Title", + "char_filter_scope_title_tooltip": "Current scope: Title\n\nFilters entire posts by their title. All files from a matching post are downloaded.\nExample: Filter 'Aerith'. Post titled 'Aerith's Garden' matches; all its files are downloaded.\nFolder Naming: Uses the character from the matching post title.\n\nClick to switch to: Files", + "char_filter_scope_both_text": "Filter: Both", + "char_filter_scope_both_tooltip": "Current scope: Both (Title then Files)\n\n1. Checks the post title: If it matches, all files in the post are downloaded.\n2. If the title doesn't match, checks filenames: If a file matches, only that file is downloaded.\nExample: Filter 'Cloud'.\n - Post 'Cloud Strife' (title match) -> all files are downloaded.\n - Post 'Motorcycle Chase' with 'Cloud_fenrir.jpg' (file match) -> only 'Cloud_fenrir.jpg' is downloaded.\nFolder Naming: Prioritizes title match, then file match.\n\nClick to switch to: Comments", + "char_filter_scope_comments_text": "Filter: Comments (Beta)", + "char_filter_scope_comments_tooltip": "Current scope: Comments (Beta - Files first, then Comments as fallback)\n\n1. Checks filenames: If a file in the post matches the filter, the entire post is downloaded. Comments are NOT checked for this filter term.\n2. If no file matches, THEN checks post comments: If a comment matches, the entire post is downloaded.\nExample: Filter 'Barret'.\n - Post A: Files 'Barret_gunarm.jpg', 'other.png'. File 'Barret_gunarm.jpg' matches. All files from Post A are downloaded. Comments are not checked for 'Barret'.\n - Post B: Files 'dyne.jpg', 'weapon.gif'. Comments: '...a drawing of Barret Wallace...'. No file match for 'Barret'. Comment matches. All files from Post B are downloaded.\nFolder Naming: Prioritizes character from file match, then comment match.\n\nClick to switch to: Title", + "char_filter_scope_unknown_text": "Filter: Unknown", + "char_filter_scope_unknown_tooltip": "Current Scope: Unknown\n\nThe character filter scope is in an unknown state. Please cycle or reset.\n\nClick to switch to: Title", + "skip_words_input_tooltip": "Enter words, comma-separated, to skip downloading certain content (e.g., WIP, sketch, preview).\n\nThe 'Scope: [Type]' button next to this input changes how this filter applies:\n- Scope: Files: Skips individual files if their names contain any of these words.\n- Scope: Posts: Skips entire posts if their titles contain any of these words.\n- Scope: Both: Applies both (post title first, then individual files if post title is OK).", + "remove_words_input_tooltip": "Enter words, comma-separated, to remove from downloaded filenames (case-insensitive).\nUseful for cleaning up common prefixes/suffixes.\nExample: patreon, kemono, [HD], _final", + "skip_scope_files_text": "Scope: Files", + "skip_scope_files_tooltip": "Current Skip Scope: Files\n\nSkips individual files if their names contain any of the 'Skip Words'.\nExample: Skip Words \"WIP, sketch\".\n- File \"art_WIP.jpg\" -> SKIPPED.\n- File \"final_art.png\" -> DOWNLOADED (if other conditions met).\n\nThe post is still processed for other non-skipped files.\nClick to switch to: Both", + "skip_scope_posts_text": "Scope: Posts", + "skip_scope_posts_tooltip": "Current Skip Scope: Posts\n\nSkips entire posts if their titles contain any of the 'Skip Words'.\nAll files from a skipped post are ignored.\nExample: Skip Words \"preview, announcement\".\n- Post \"Exciting Announcement!\" -> SKIPPED.\n- Post \"Finished Artwork\" -> PROCESSED (if other conditions met).\n\nClick to switch to: Files", + "skip_scope_both_text": "Scope: Both", + "skip_scope_both_tooltip": "Current Skip Scope: Both (Posts then Files)\n\n1. Checks the post title: If the title contains a skip word, the entire post is SKIPPED.\n2. If post title is OK, then checks individual filenames: If a filename contains a skip word, only that file is SKIPPED.\nExample: Skip Words \"WIP, sketch\".\n- Post \"Sketches and WIPs\" (title match) -> ENTIRE POST SKIPPED.\n- Post \"Art Update\" (title OK) with files:\n - \"character_WIP.jpg\" (file match) -> SKIPPED.\n - \"final_scene.png\" (file OK) -> DOWNLOADED.\n\nClick to switch to: Posts", + "skip_scope_unknown_text": "Scope: Unknown", + "skip_scope_unknown_tooltip": "Current Skip Scope: Unknown\n\nThe skip words scope is in an unknown state. Please cycle or reset.\n\nClick to switch to: Posts", + "language_change_title": "Language Changed", + "language_change_message": "The language has been changed. A restart is required for all changes to take full effect.", + "language_change_informative": "Do you want to restart the application now?", + "restart_now_button": "Restart Now", + "skip_zip_checkbox_label": "Skip .zip", + "skip_rar_checkbox_label": "Skip .rar", + "download_thumbnails_checkbox_label": "Download thumbnails only", + "scan_content_images_checkbox_label": "Scan content for images", + "compress_images_checkbox_label": "Compress to WebP", + "separate_folders_checkbox_label": "Separate folders by Name/Title", + "subfolder_per_post_checkbox_label": "Subfolder per post", + "use_cookie_checkbox_label": "Use cookie", + "use_multithreading_checkbox_base_label": "Use multithreading", + "show_external_links_checkbox_label": "Show external links in log", + "manga_comic_mode_checkbox_label": "Manga/Comic Mode", + "threads_label": "Threads:", + "start_download_button_text": "⬇️ Start Download", + "start_download_button_tooltip": "Click to start the download or link extraction process with the current settings.", + "extract_links_button_text": "🔗 Extract Links", + "pause_download_button_text": "⏸️ Pause Download", + "pause_download_button_tooltip": "Click to pause the currently running download process.", + "resume_download_button_text": "▶️ Resume Download", + "resume_download_button_tooltip": "Click to resume the download.", + "cancel_button_text": "❌ Cancel & Reset UI", + "cancel_button_tooltip": "Click to cancel the current download/extraction process and reset the UI fields (keeping URL and directory).", + "error_button_text": "Error", + "error_button_tooltip": "View files skipped due to errors and optionally retry them.", + "cancel_retry_button_text": "❌ Cancel Retry", + "known_chars_label_text": "🎭 Known Series/Characters (for folder names):", + "open_known_txt_button_text": "Open Known.txt", + "known_chars_list_tooltip": "This list contains names used for automatic folder creation when 'Separate Folders' is on\nand no specific 'Filter by Character(s)' is provided or matches a post.\nAdd the names of series, games, or characters you frequently download.", + "open_known_txt_button_tooltip": "Open the 'Known.txt' file in your default text editor.\nThe file is located in the application's directory.", + "add_char_button_text": "➕ Add", + "add_char_button_tooltip": "Add the name from the input field to the 'Known Series/Characters' list.", + "add_to_filter_button_text": "⤵️ Add to Filter", + "add_to_filter_button_tooltip": "Select names from the 'Known Series/Characters' list to add them to the 'Filter by Character(s)' field above.", + "delete_char_button_text": "🗑️ Delete Selected", + "delete_char_button_tooltip": "Delete the selected name(s) from the 'Known Series/Characters' list.", + "progress_log_label_text": "📜 Progress Log:", + "radio_all_tooltip": "Download all file types found in posts.", + "radio_images_tooltip": "Download only common image formats (JPG, PNG, GIF, WEBP, etc.).", + "radio_videos_tooltip": "Download only common video formats (MP4, MKV, WEBM, MOV, etc.).", + "radio_only_archives_tooltip": "Exclusively download .zip and .rar files. Other file-specific options are disabled.", + "radio_only_audio_tooltip": "Download only common audio formats (MP3, WAV, FLAC, etc.).", + "radio_only_links_tooltip": "Extract and display external links from post descriptions instead of downloading files.\nDownload-related options will be disabled.", + "favorite_mode_checkbox_tooltip": "Enable Favorite Mode to browse and download from saved artists/posts.\nThis will replace the URL input field with Favorite selection buttons.", + "skip_zip_checkbox_tooltip": "If checked, .zip archive files will not be downloaded.\n(Disabled if 'Archives Only' is selected).", + "skip_rar_checkbox_tooltip": "If checked, .rar archive files will not be downloaded.\n(Disabled if 'Archives Only' is selected).", + "download_thumbnails_checkbox_tooltip": "Downloads the small preview images from the API instead of full-size files (if available).\nIf 'Scan post content for image URLs' is also checked, this mode will *only* download images found by content scanning (ignoring API thumbnails).", + "scan_content_images_checkbox_tooltip": "If checked, the downloader will scan the HTML content of posts for image URLs (fromTo use cookies, you typically need a cookies.txt file from your browser.
", + "cookie_help_how_to_get_title": "How to get cookies.txt:
", + "cookie_help_step1_extension_intro": "Get cookies.txt LOCALLY on Chrome Web Store
cookies.txt file to your computer.- ",
+ "cookie_help_step6a_checkbox": "
- Make sure the 'Use cookie' box is checked. ", + "cookie_help_step6b_browse": "
- Click the 'Browse...' button next to the cookie text field. ", + "cookie_help_step6c_select": "
- Select the
cookies.txtfile you just saved.
Alternatively, some extensions may let you copy the cookie string directly. If so, you can paste that into the text field instead of browsing for a file.
", + "cookie_help_proceed_without_button": "Download without cookies", + "cookie_help_cancel_download_button": "Cancel Download", + "character_input_tooltip": "Enter character names (comma-separated). Supports advanced grouping and affects folder naming if 'Separate Folders' is enabled.\n\nExamples:\n- Nami → Matches 'Nami', creates 'Nami' folder.\n- (Ulti, Vivi) → Matches either, folder 'Ulti Vivi', adds both to Known.txt separately.\n- (Boa, Hancock)~ → Matches either, folder 'Boa Hancock', adds as one group to Known.txt.\n\nNames are treated as aliases for matching.\n\nFilter Modes (button cycles):\n- Files: Filters by filename.\n- Title: Filters by post title.\n- Both: Title first, then filename.\n- Comments (Beta): Filename first, then post comments.", + "tour_dialog_title": "Welcome to Kemono Downloader!", + "tour_dialog_never_show_checkbox": "Never show this tour again", + "tour_dialog_skip_button": "Skip Tour", + "tour_dialog_back_button": "Back", + "tour_dialog_next_button": "Next", + "tour_dialog_finish_button": "Finish", + "tour_dialog_step1_title": "👋 Welcome!", + "tour_dialog_step1_content": "Hello! This quick tour will guide you through the main features of Kemono Downloader, including recent updates like enhanced filtering, manga mode improvements, and cookie handling.\n- \n
- My goal is to help you easily download content from Kemono and Coomer.
- 🎨 Creator Selection Button: Next to the URL input, click the palette icon to open a dialog. Browse and select creators from your
creators.jsonfile to quickly add their names to the URL input. - Important Tip: App '(Not Responding)'?
\nAfter clicking 'Start Download', especially for large creator feeds or with many threads, the app might temporarily show '(Not Responding)'. Your operating system (Windows, macOS, Linux) might even suggest you 'End Process' or 'Force Quit'.
\nPlease be patient! The app is often working hard in the background. Before force-closing, try checking your chosen 'Download Location' in your file explorer. If you see new folders being created or files appearing, it means the download is progressing correctly. Give it some time to become responsive again. - Use the Next and Back buttons to navigate.
- Many options have tooltips if you hover over them for more details.
- Click Skip Tour to close this guide at any time.
- Check 'Never show this tour again' if you don't want to see this on future startups. \n
\n
\n
\n
\n
\n
\n
- \n
- 🔗 Creator/Post Kemono URL:
\nPaste the full web address (URL) of a creator's page (e.g., https://kemono.su/patreon/user/12345) \nor a specific post (e.g., .../post/98765).
\nor a Coomer creator (e.g., https://coomer.su/onlyfans/user/artistname) - 📁 Download Location:
\nClick 'Browse...' to choose a folder on your computer where all downloaded files will be saved. \nThis is required unless you are using 'Links Only' mode. - 📄 Page Range (Creator URLs only):
\nIf downloading from a creator's page, you can specify a range of pages to grab (e.g., pages 2 to 5). \nLeave blank for all pages. This is disabled for single post URLs or when Manga/Comic Mode is active. \n
\n
\n
- \n
- 🎯 Filter by Character(s):
\nEnter character names, separated by commas (e.g., Tifa, Aerith). Group aliases for a combined folder name: (alias1, alias2, alias3) becomes the folder 'alias1 alias2 alias3' (after cleanup). All names in the group are used as aliases for matching.
\nThe 'Filter: [Type]' button (next to this input) changes how this filter applies:\n- Filter: Files: Checks individual filenames. A post is kept if any file matches; only the matching files are downloaded. Folder naming uses the character from the matching filename (if 'Separate Folders' is on).
- Filter: Title: Checks post titles. All files from a matching post are downloaded. Folder naming uses the character from the matching post title. \n
- ⤵️ Add to Filter Button (Known Names): Next to the 'Add' button for Known Names (see Step 5), this opens a popup. Select names from your
Known.txtlist via checkboxes (with a search bar) to quickly add them to the 'Filter by Character(s)' field. Grouped names like(Boa, Hancock)from Known.txt will be added as(Boa, Hancock)~to the filter. - Filter: Both: Checks the post title first. If it matches, all files are downloaded. If not, it then checks filenames, and only matching files are downloaded. Folder naming prioritizes the title match, then the file match.
- Filter: Comments (Beta): Checks filenames first. If a file matches, all files in the post are downloaded. If no file match, it then checks post comments. If a comment matches, all files are downloaded. (Uses more API requests). Folder naming prioritizes the file match, then the comment match.
\n
\n
\n - 🚫 Skip with words:
\nEnter words, comma-separated (e.g., WIP, sketch, preview). \nThe 'Scope: [Type]' button (next to this input) changes how this filter applies:\n- Scope: Files: Skips files if their names contain any of these words.
- Scope: Posts: Skips entire posts if their titles contain any of these words.
- Scope: Both: Applies both file and post title skipping (post first, then files).
\n
\n - Filter Files (Radio Buttons): Choose what to download:\n
- \n
- All: Downloads all file types found.
- Images/GIFs: Only common image formats and GIFs.
- Videos: Only common video formats.
- 📦 Only Archives: Exclusively downloads .zip and .rar files. When this is selected, the 'Skip .zip' and 'Skip .rar' checkboxes are automatically disabled and unchecked. 'Show external links' is also disabled.
- 🎧 Only Audio: Only common audio formats (MP3, WAV, FLAC, etc.).
- 🔗 Only Links: Extracts and displays external links from post descriptions instead of downloading files. Download-related options and 'Show external links' are disabled. \n
\n
\n
\n
\n
\n \n
\n
\n
- \n
- ⭐ Favorite Mode Checkbox:
\nLocated next to the '🔗 Only Links' radio button. Check this box to enable Favorite Mode. - What Happens in Favorite Mode:\n
- The '🔗 Creator/Post Kemono URL' input area is replaced with a message indicating Favorite Mode is active.
- The standard 'Start Download', 'Pause', 'Cancel' buttons are replaced with '🖼️ Favorite Artists' and '📄 Favorite Posts' buttons (Note: 'Favorite Posts' is planned for the future).
- The '🍪 Use cookie' option is automatically enabled and locked, as cookies are required to fetch your favorites.
\n
\n - 🖼️ Favorite Artists Button:
\nClick this to open a dialog listing your favorite artists from Kemono.su. You can select one or more artists to download. - Favorite Download Scope (Button):
\nThis button (next to 'Favorite Posts') controls where selected favorites are downloaded:\n- Scope: Selected Location: All selected artists are downloaded into the main 'Download Location' you set. Filters apply globally.
- Scope: Artist Folders: A subfolder (named after the artist) is created in your main 'Download Location' for each selected artist. That artist's content goes into their specific folder. Filters apply within each artist's folder.
\n - Filters in Favorite Mode:
\nThe 'Filter by Character(s)', 'Skip with words', and 'Filter Files' options still apply to the content downloaded from your selected favorite artists. \n
\n
\n
\n
\n
- \n
- Skip .zip / Skip .rar: Check these to avoid downloading these archive file types. \n(Note: These are disabled and ignored if '📦 Only Archives' filter mode is selected).
- ✂️ Remove words from name:
\nEnter words, comma-separated (e.g., patreon, [HD]), to be removed from downloaded filenames (case-insensitive). - Download thumbnails only: Downloads the small preview images instead of full-size files (if available).
- Compress large images: If the 'Pillow' library is installed, images over 1.5MB will be converted to WebP format if the WebP version is significantly smaller.
- 🗄️ Custom Folder Name (Single Post Only):
\nIf you are downloading a specific post URL AND 'Separate folders by Name/Title' is enabled, \nyou can enter a custom name here for that post's download folder. - 🍪 Use cookie: Check this to use cookies for requests. You can either:\n
- Enter a cookie string directly into the text field (e.g., name1=value1; name2=value2).
- Click 'Browse...' to select a cookies.txt file (Netscape format). The path will appear in the text field.
\n \n
\n
\n
\n
\n
\n
- \n
- ⚙️ Separate folders by Name/Title: Creates subfolders based on the 'Filter by Character(s)' input or post titles (can use the Known.txt list as a fallback for folder names).
- Subfolder per post: If 'Separate Folders' is on, this creates an additional subfolder for each individual post inside the main character/title folder.
- 🚀 Use multithreading (Threads): Enables faster operations. The number in the 'Threads' input means:\n
- For Creator Feeds: Number of posts to process simultaneously. Files from each post are downloaded sequentially by its worker (unless 'Date Based' manga naming is on, which forces 1 post worker).
- For Single Post URLs: Number of files to download simultaneously from that single post.
\n - Multipart Download Toggle (top-right of log area):
\nThe 'Multi-part: [ON/OFF]' button enables/disables multi-segment downloads for individual large files. \n- ON: Can speed up large file downloads (e.g., videos) but may increase UI stutter or log spam with many small files. A warning will appear on activation. If a multipart download fails, it retries as a single stream.
- OFF (Default): Files are downloaded in a single stream.
\n - 📖 Manga/Comic Mode (Creator URLs only): Designed for sequential content.\n
- \n
- Downloads posts from oldest to newest.
- The 'Page Range' input is disabled as all posts are fetched.
- A filename style toggle button (e.g., 'Name: Post Title') appears at the top-right of the log area when this mode is active for a creator feed. Click it to cycle between naming styles:\n
- \n
- Name: Post Title (Default): The first file in a post is named after the cleaned post title (e.g., 'My Chapter 1.jpg'). Subsequent files in the *same post* will attempt to keep their original filenames (e.g., 'page_02.png', 'bonus_art.jpg'). If the post has only one file, it's named after the post title. This is generally recommended for most manga/comics.
- Name: Original File: All files attempt to keep their original filenames. An optional prefix (e.g., 'MySeries_') can be entered in the input field that appears next to the style button. Example: 'MySeries_OriginalFile.jpg'.
- Name: Title+G.Num (Post Title + Global Numbering): All files across all posts in the current download session are named sequentially using the cleaned post title as a prefix, followed by a global counter. E.g.: Post 'Chapter 1' (2 files) -> 'Chapter 1_001.jpg', 'Chapter 1_002.png'. The next post, 'Chapter 2' (1 file), would continue the numbering -> 'Chapter 2_003.jpg'. Multithreading for post processing is automatically disabled for this style to ensure correct global numbering.
- Name: Date Based: Files are named sequentially (001.ext, 002.ext, ...) based on the publish order of the posts. An optional prefix (e.g., 'MySeries_') can be entered in the input field that appears next to the style button. Example: 'MySeries_001.jpg'. Multithreading for post processing is automatically disabled for this style. \n
\n
\n
\n - For best results with the 'Name: Post Title', 'Name: Title+G.Num', or 'Name: Date Based' styles, use the 'Filter by Character(s)' field with the manga/series title for folder organization. \n
\n
\n
\n - 🎭 Known.txt for Smart Folder Organization:
\nKnown.txt(in the app directory) allows fine-grained control over automatic folder organization when 'Separate folders by Name/Title' is on.\n- \n
- How it works: Each line in
Known.txtis an entry. \n- A simple line like
My Awesome Seriesmeans matching content will go into a folder named \"My Awesome Series\". - A grouped line like
(Character A, Char A, Alt Name A)means content matching \"Character A\", \"Char A\", OR \"Alt Name A\" will ALL go into a single folder named \"Character A Char A Alt Name A\" (after cleanup). All terms in the parentheses become aliases for that folder.
\n \n - A simple line like
- Smart Fallback: When 'Separate folders by Name/Title' is on, and if a post doesn't match any specific 'Filter by Character(s)' entries, the downloader consults
Known.txtto find a matching master name for folder creation. - User-Friendly Management: Add simple (non-grouped) names via the UI list below. For advanced editing (like creating/modifying grouped aliases), click 'Open Known.txt' to edit the file in your text editor. The app reloads it on next use or next startup. \n
\n \n - How it works: Each line in
\n
\n
\n
\n
\n
- \n
- Character Input Tooltip:
\nEnter character names, comma-separated (e.g., Tifa, Aerith).
\nGroup aliases for a combined folder name: (alias1, alias2, alias3) becomes folder 'alias1 alias2 alias3'.
\nAll names in the group are used as aliases for content matching.
\nThe 'Filter: [Type]' button next to this input changes how this filter applies:
\n- Filter: Files: Checks individual filenames. Only matching files are downloaded.
\n- Filter: Title: Checks post titles. All files from a matching post are downloaded.
\n- Filter: Both: Checks post title first. If no match, then checks filenames.
\n- Filter: Comments (Beta): Checks filenames first. If no match, then checks post comments.
\nThis filter also influences folder naming if 'Separate folders by Name/Title' is enabled. - 502 Bad Gateway / 503 Service Unavailable / 504 Gateway Timeout:
\nThese usually indicate temporary server-side problems with Kemono/Coomer. The site might be overloaded, down for maintenance, or having issues.
\nSolution: Wait a while (e.g., 30 minutes to a few hours) and try again later. Check the site directly in your browser. - Connection Lost / Connection Refused / Timeout (during file download):
\nThis can happen due to your internet connection, server instability, or if the server drops the connection for a large file.
\nSolution: Check your internet. Try reducing the 'Threads' count if it's high. The app may offer to retry some failed files at the end of a session. - IncompleteRead Error:
\nThe server sent less data than expected. Often a temporary network hiccup or server issue.
\nSolution: The app will often mark these files for a retry at the end of the download session. - 403 Forbidden / 401 Unauthorized (less common for public posts):
\nYou may not have permission to access the content. For some paywalled or private content, using the 'Use cookie' option with valid cookies from your browser session might help. Ensure your cookies are up to date. - 404 Not Found:
\nThe post or file URL is incorrect, or the content has been deleted from the site. Double-check the URL. - 'No posts found' / 'Target post not found':
\nEnsure the URL is correct and the creator/post exists. If using page ranges, make sure they are valid for the creator. For very new posts, there might be a slight delay before they appear in the API. - General Slowness / App '(Not Responding)':
\nAs mentioned in Step 1, if the app appears to freeze after starting, especially with large creator feeds or many threads, please give it time. It is likely processing data in the background. Reducing the thread count can sometimes improve responsiveness if this is frequent. \n
\n
\n
\n
\n
\n
\n
\n
- \n
- 📜 Progress Log / Extracted Links Log: Shows detailed download messages. If '🔗 Only Links' mode is active, this area displays the extracted links.
- Show external links in log: If checked, a secondary log panel appears below the main log to display external links found in post descriptions. (This is disabled if '🔗 Only Links' or '📦 Only Archives' mode is active).
- Log Display Toggle (👁️ / 🙈 Button):
\nThis button (top-right of the log area) changes the main log view:\n- 👁️ Progress Log (Default): Shows all download activity, errors, and summaries.
- 🙈 Missed Character Log: Displays a list of key terms from post titles that were skipped due to your 'Filter by Character(s)' settings. Useful for identifying content you might be unintentionally missing.
\n - 🔄 Reset: Clears all input fields, logs, and resets temporary settings to their defaults. Can only be used when no download is active.
- ⬇️ Start Download / 🔗 Extract Links / ⏸️ Pause / ❌ Cancel: These buttons control the process. 'Cancel & Reset UI' stops the current operation and performs a soft reset of the UI, keeping your URL and directory inputs. 'Pause/Resume' allows for temporary halting and continuing.
- If some files fail with recoverable errors (like 'IncompleteRead'), you may be prompted to retry them at the end of a session. \n
\n
\n
\n
\n
\n
You're all set! Click 'Finish' to close the tour and start using the downloader.", + "help_guide_dialog_title": "Kemono Downloader - Feature Guide", + "help_guide_github_tooltip": "Visit the project's GitHub page (Opens in browser)", + "help_guide_instagram_tooltip": "Visit our Instagram page (Opens in browser)", + "help_guide_discord_tooltip": "Join our Discord community (Opens in browser)", + "help_guide_step1_title": "① Introduction & Main Inputs", + "help_guide_step1_content": "
This guide provides an overview of the features, fields, and buttons in the Kemono Downloader.
\nMain Input Area (Top-Left)
\n- \n
- 🔗 Creator/Post Kemono URL:\n
- \n
- Enter the full web address of a creator's page (e.g., https://kemono.su/patreon/user/12345) or a specific post (e.g., .../post/98765). \n
- Supports Kemono (kemono.su, kemono.party) and Coomer (coomer.su, coomer.party) URLs. \n
\n - Page Range (Start to End):\n
- \n
- For creator URLs: Specify a range of pages to grab (e.g., pages 2 to 5). Leave blank for all pages. \n
- Disabled for single post URLs or when Manga/Comic Mode is active. \n
\n - 📁 Download Location:\n
- \n
- Click 'Browse...' to choose a main folder on your computer where all downloaded files will be saved. \n
- This field is required unless you are using '🔗 Only Links' mode. \n
\n - 🎨 Creator Selection Button (next to URL input):\n
- \n
- Click the palette icon (🎨) to open the 'Creator Selection' dialog. \n
- This dialog loads creators from your
creators.jsonfile (which must be in the app directory). \n - Inside the dialog:\n
- \n
- Search bar: Type to filter the creator list by name or service. \n
- Creator list: Displays creators from your
creators.json. Creators you have marked as 'favorites' (in the JSON data) appear at the top. \n - Checkboxes: Select one or more creators by checking the box next to their name. \n
- 'Scope' Button (e.g., 'Scope: Characters'): This button toggles the download organization when initiating downloads from this popup:\n
- Scope: Characters: Downloads will be organized into character-named folders directly in your main 'Download Location'. Art from different creators for the same character will be grouped. \n
- Scope: Creators: Downloads will first create a creator-named folder in your main 'Download Location'. Character-named subfolders will then be created inside each creator's folder.
\n - 'Add Selected' Button: Clicking this will take the names of all checked creators and add them to the main '🔗 Creator/Post Kemono URL' input field, separated by commas. The dialog will then close. \n
\n - This feature provides a quick way to populate the URL field for multiple creators without manually typing or pasting each URL. \n
\n
Filtering Downloads (Left Panel)
\n- \n
- 🎯 Filter by Character(s):\n
- \n
- Enter names, comma-separated (e.g.,
Tifa, Aerith). \n - Grouped Aliases for Shared Folder (Separate Known.txt entries):
(Vivi, Ulti, Uta).\n- Content matching \"Vivi\", \"Ulti\", OR \"Uta\" will go into a shared folder named \"Vivi Ulti Uta\" (after cleanup). \n
- If these names are new, you will be prompted to add \"Vivi\", \"Ulti\", and \"Uta\" as separate individual entries to
Known.txt. \n
\n - Grouped Aliases for Shared Folder (Single Known.txt entry):
(Yuffie, Sonon)~(note the tilde~).\n- Content matching \"Yuffie\" OR \"Sonon\" will go into a shared folder named \"Yuffie Sonon\". \n
- If new, \"Yuffie Sonon\" (with aliases Yuffie, Sonon) will be proposed to be added as a single group entry to
Known.txt. \n
\n - This filter influences folder naming if 'Separate folders by Name/Title' is enabled. \n
\n - Enter names, comma-separated (e.g.,
- Filter: [Type] Button (Character Filter Scope): Cycles how 'Filter by Character(s)' applies:\n
- \n
Filter: Files: Checks individual filenames. A post is kept if a file matches; only matching files are downloaded. Folder naming uses the character from the matching filename. \nFilter: Title: Checks post titles. All files from a matching post are downloaded. Folder naming uses the character from the matching post title. \nFilter: Both: Checks post title first. If it matches, all files are downloaded. If not, it then checks filenames, and only matching files are downloaded. Folder naming prioritizes the title match, then the file match. \nFilter: Comments (Beta): Checks filenames first. If a file matches, all files in the post are downloaded. If no file match, it then checks post comments. If a comment matches, all files are downloaded. (Uses more API requests). Folder naming prioritizes the file match, then the comment match. \n
\n - 🗄️ Custom Folder Name (Single Post Only):\n
- \n
- Visible and usable only when downloading a specific post URL AND 'Separate folders by Name/Title' is enabled. \n
- Allows specifying a custom name for that single post's download folder. \n
\n - 🚫 Skip with words:\n
- Enter words, comma-separated (e.g.,
WIP, sketch, preview) to ignore certain content.
\n - Enter words, comma-separated (e.g.,
- Scope: [Type] Button (Skip Words Scope): Cycles how 'Skip with words' applies:\n
- \n
Scope: Files: Skips individual files if their names contain any of these words. \nScope: Posts: Skips entire posts if their titles contain any of these words. \nScope: Both: Applies both (post title first, then individual files). \n
\n - ✂️ Remove words from name:\n
- Enter words, comma-separated (e.g.,
patreon, [HD]), to be removed from downloaded filenames (case-insensitive).
\n - Enter words, comma-separated (e.g.,
- Filter Files (Radio Buttons): Choose what to download:\n
- \n
All: Downloads all file types found. \nImages/GIFs: Only common image formats (JPG, PNG, GIF, WEBP, etc.) and GIFs. \nVideos: Only common video formats (MP4, MKV, WEBM, MOV, etc.). \n📦 Only Archives: Exclusively downloads .zip and .rar files. When this is selected, the 'Skip .zip' and 'Skip .rar' checkboxes are automatically disabled and unchecked. 'Show external links' is also disabled. \n🎧 Only Audio: Downloads only common audio formats (MP3, WAV, FLAC, M4A, OGG, etc.). Other file-specific options behave as in 'Images' or 'Videos' mode. \n🔗 Only Links: Extracts and displays external links from post descriptions instead of downloading files. Download-related options and 'Show external links' are disabled. The main download button becomes '🔗 Extract Links'. \n
\n
Download Options & Settings (Left Panel)
\n- \n
- Skip .zip / Skip .rar: Checkboxes to avoid downloading these archive file types. (Disabled and ignored if '📦 Only Archives' filter mode is selected). \n
- Download thumbnails only: Downloads the small preview images instead of full-size files (if available). \n
- Compress large images (to WebP): If the 'Pillow' (PIL) library is installed, images over 1.5MB will be converted to WebP format if the WebP version is significantly smaller. \n
- ⚙️ Advanced Settings:\n
- \n
- Separate folders by Name/Title: Creates subfolders based on the 'Filter by Character(s)' input or post titles. Can use the Known.txt list as a fallback for folder names.
⚙️ Advanced Settings (Continued)
- Subfolder per post: If 'Separate Folders' is on, this creates an additional subfolder for each individual post inside the main character/title folder. \n
- Use cookie: Check this box to use cookies for requests.\n
- \n
- Text Field: Enter a cookie string directly (e.g.,
name1=value1; name2=value2). \n - Browse...: Select a
cookies.txtfile (Netscape format). The path will appear in the text field. \n - Priority: The text field (if filled) takes priority over a browsed file. If 'Use cookie' is checked but both are empty, it attempts to load
cookies.txtfrom the app's directory. \n
\n - Text Field: Enter a cookie string directly (e.g.,
- Use multithreading & Threads Input:\n
- \n
- Enables faster operations. The number in the 'Threads' input means:\n
- \n
- For Creator Feeds: Number of posts to process simultaneously. Files from each post are downloaded sequentially by its worker (unless 'Date Based' manga naming is on, which forces 1 post worker). \n
- For Single Post URLs: Number of files to download simultaneously from that single post. \n
\n - If unchecked, 1 thread is used. High thread counts (e.g., >40) may show a warning. \n
- Enables faster operations. The number in the 'Threads' input means:\n
- \n
⚙️ Advanced Settings (Continued)
- Show external links in log: If checked, a secondary log panel appears below the main log to display external links found in post descriptions. (Disabled if '🔗 Only Links' or '📦 Only Archives' mode is active). \n
- 📖 Manga/Comic Mode (Creator URLs only): Designed for sequential content.\n
- \n
- Downloads posts from oldest to newest. \n
- The 'Page Range' input is disabled as all posts are fetched. \n
- A filename style toggle button (e.g., 'Name: Post Title') appears at the top-right of the log area when this mode is active for a creator feed. Click it to cycle between naming styles:\n
- \n
Name: Post Title (Default): The first file in a post is named after the cleaned post title (e.g., 'My Chapter 1.jpg'). Subsequent files in the *same post* will attempt to keep their original filenames (e.g., 'page_02.png', 'bonus_art.jpg'). If the post has only one file, it's named after the post title. This is generally recommended for most manga/comics. \nName: Original File: All files attempt to keep their original filenames. \nName: Original File: All files attempt to keep their original filenames. When this style is active, an input field for an optional filename prefix (e.g., 'MySeries_') will appear next to this style button. Example: 'MySeries_OriginalFile.jpg'. \nName: Title+G.Num (Post Title + Global Numbering): All files across all posts in the current download session are named sequentially using the cleaned post title as a prefix, followed by a global counter. E.g.: Post 'Chapter 1' (2 files) -> 'Chapter 1 001.jpg', 'Chapter 1 002.png'. Next post 'Chapter 2' (1 file) -> 'Chapter 2 003.jpg'. Multithreading for post processing is automatically disabled for this style. \nName: Date Based: Files are named sequentially (001.ext, 002.ext, ...) based on the publish order. When this style is active, an input field for an optional filename prefix (e.g., 'MySeries_') will appear next to this style button. Example: 'MySeries_001.jpg'. Multithreading for post processing is automatically disabled for this style. \n
\n - For best results with the 'Name: Post Title', 'Name: Title+G.Num', or 'Name: Date Based' styles, use the 'Filter by Character(s)' field with the manga/series title for folder organization. \n
\n
- \n
Main Actions (Left Panel)
\n- \n
- ⬇️ Start Download / 🔗 Extract Links: This button's text and function changes based on the 'Filter Files' radio button selection. It starts the main operation. \n
- ⏸️ Pause Download / ▶️ Resume Download: Allows for temporarily halting the current download/extraction process and resuming it later. Some UI settings can be changed while paused. \n
- ❌ Cancel & Reset UI: Stops the current operation and performs a soft reset of the UI. Your URL and download directory inputs are kept, but other settings and logs are cleared. \n
Managing the Known Series/Characters List (Bottom-Left)
\nThis section helps manage the Known.txt file, which is used for smart folder organization when 'Separate folders by Name/Title' is on, especially as a fallback if a post doesn't match your active 'Filter by Character(s)' input.
- \n
- Open Known.txt: Opens the
Known.txtfile (located in the app directory) in your default text editor for advanced editing (like creating complex grouped aliases). \n - Search characters...: Filters the list of known names displayed below. \n
- List Widget: Displays the master names from your
Known.txt. Select entries here to delete them. \n - Add new series/character name (Input Field): Enter a name or group to add.\n
- \n
- Simple Name: e.g.,
My Awesome Series. Adds as a single entry. \n - Group for separate Known.txt entries: e.g.,
(Vivi, Ulti, Uta). Adds \"Vivi\", \"Ulti\", and \"Uta\" as three separate, individual entries toKnown.txt. \n - Group for Shared Folder & Single Known.txt Entry (Tilde
~): e.g.,(Character A, Char A)~. Adds an entry toKnown.txtnamed \"Character A Char A\". \"Character A\" and \"Char A\" become aliases for this single folder/entry. \n
\n - Simple Name: e.g.,
- Button ➕ Add: Adds the name/group from the input field above to the list and to
Known.txt. \n - Button ⤵️ Add to Filter:\n
- \n
- Located next to the '➕ Add' button for the 'Known Series/Characters' list. \n
- Clicking this opens a popup window showing all names from your
Known.txtfile, each with a checkbox. \n - The popup includes a search bar to quickly filter the list of names. \n
- You can select one or more names using the checkboxes. \n
- Click 'Add Selected' to insert the chosen names into the main window's 'Filter by Character(s)' input field. \n
- If a selected name in
Known.txtwas originally a group (e.g., defined as(Boa, Hancock)in Known.txt), it will be added to the filter field as(Boa, Hancock)~. Simple names are added as-is. \n - 'Select All' and 'Deselect All' buttons are available in the popup for convenience. \n
- Click 'Cancel' to close the popup without any changes. \n
\n - Button 🗑️ Delete Selected: Deletes the selected name(s) from the list and from
Known.txt. \n - Button ❓ (This one!): Displays this comprehensive help guide. \n
Log Area & Controls (Right Panel)
\n- \n
- 📜 Progress Log / Extracted Links Log (Label): Title for the main log area; changes if '🔗 Only Links' mode is active. \n
- Search links... / Button 🔍 (Link Search):\n
- Visible only when '🔗 Only Links' mode is active. Allows for real-time filtering of the extracted links shown in the main log by text, URL, or platform.
\n - Name: [Style] Button (Manga Filename Style):\n
- Visible only when Manga/Comic Mode is active for a creator feed and not in 'Links Only' or 'Archives Only' mode. \n
- Cycles through filename styles:
Post Title,Original File,Date Based. (See Manga/Comic Mode section for details). \n - When 'Original File' or 'Date Based' style is active, an input field for an optional filename prefix will appear next to this button. \n
\n - Multi-part: [ON/OFF] Button:\n
- Toggles multi-segment downloads for individual large files.\n
- ON: Can speed up large file downloads (e.g., videos) but may increase UI stutter or log spam with many small files. A warning appears on activation. If a multipart download fails, it retries as a single stream. \n
- OFF (Default): Files are downloaded in a single stream. \n
- Disabled if '🔗 Only Links' or '📦 Only Archives' mode is active. \n
\n - Toggles multi-segment downloads for individual large files.\n
- Button 👁️ / 🙈 (Log Display Toggle): Changes the main log view:\n
- \n
- 👁️ Progress Log (Default): Shows all download activity, errors, and summaries. \n
- 🙈 Missed Character Log: Displays a list of key terms from post titles/content that were skipped due to your 'Filter by Character(s)' settings. Useful for identifying content you might be unintentionally missing. \n
\n - Button 🔄 Reset: Clears all input fields, logs, and resets temporary settings to their defaults. Can only be used when no download is active. \n
- Main Log Output (Text Area): Displays detailed progress messages, errors, and summaries. If '🔗 Only Links' mode is active, this area displays the extracted links. \n
- Missed Character Log Output (Text Area): (Visible via 👁️ / 🙈 toggle) Shows posts/files skipped due to character filters. \n
- External Log Output (Text Area): Appears below the main log if 'Show external links in log' is checked. Displays external links found in post descriptions. \n
- Export Links Button:\n
- Visible and enabled only when '🔗 Only Links' mode is active and links have been extracted. \n
- Allows saving all extracted links to a
.txtfile. \n
\n - Progress Label: [Status]: Displays the overall progress of the download or link extraction process (e.g., posts processed). \n
- File Progress Label: Displays the progress of individual file downloads, including speed and size, or multipart download status. \n