Code Index

This index groups the source files mentioned by feature pages and lists the pages that use them. Start here when you need to find an implementation; for translation, setup, or troubleshooting, use the feature page itself.

The list is built from the "File" column of each page's "Code locations" table. Line numbers and anchors are stripped, paths are normalized to repository-relative paths, and method names, directories, and glob/brace-expansion references are kept as written. Links point to the corresponding pages in the current language.

Usage

• The same source file is counted once per page.
• A source file can be cited by many pages, so its links repeat in the cell; the most-cited files are summarized in Coverage overview.
• References that cannot be resolved to one file (method names, directories, globs, brace expansions, or page-specific wording) stay in their original group.
• This index does not replace a feature page; file formats, defaults, and behavior belong on the corresponding feature page.

Coverage overview

The index currently contains 118 documentation pages, 300 source files, and 1509 "source file -> citing page" pairs. File counts per group:

Group	Source files
Desktop Qt UI	86
Core config and pipeline	47
Stage modules	33
Server and web	79
Install and packaging	22
Config, resources, and prompts	1
Research material and data	27
Tests and scripts	5

The 15 most-cited source files:

Source file	Citing pages
desktop_qt_ui/locales/en_US.json	101
desktop_qt_ui/locales/zh_CN.json	101
desktop_qt_ui/app_logic.py	55
manga_translator/manga_translator.py	50
desktop_qt_ui/core/config_models.py	43
manga_translator/config.py	40
desktop_qt_ui/ui/main_page/dynamic_settings.py	28
desktop_qt_ui/ui/main_page/settings_tab_layout.json	28
manga_translator/args.py	19
manga_translator/utils/path_manager.py	19
desktop_qt_ui/services/config_service.py	18
config/config-example.json	17
desktop_qt_ui/ui/main_page/runtime.py	17
manga_translator/server/static/script.js	17
manga_translator/server/main.py	15

Desktop Qt UI

Source file	Citing pages
desktop_qt_ui/app_logic.py	Debug Folder Naming and Overview How to Read and Share a Debug Run Special Workflows and WebSocket Debug Artifacts Connection Tests and Model List API Credentials, Addresses, and Models Custom Request Parameters Feature Selectors Presets and Persistence API Management Tabs and Provider Fields Mask Painting and Clone Stamp AI Colorizer Prompt AI OCR Prompt AI Renderer Prompt Prompt List, Apply, and Preview Prompt Structured Editor System and Translation Prompts Rich-Text Rules Table, Raw Editing, and Matching CLI, Batch, and Output Detection General and Application Settings Mask And Inpainting Mode-Specific Workflows and Template Alignment OCR, Filtering, and Text-Line Merging Settings Shell, Descriptions, and Config Import/Export Translation settings Typesetting and Rendering Upscale and Colorization File List and Input Output Directory and Workflow Progress, Stop, and Task State Context and Prompts Translator Engine Dispatch Glossary, Streaming, and Line Breaking Retry, Rate Limits, and Translation Quality Translator Selection and Target Languages Translator Chaining Adding or Changing a Feature Architecture and Code Boundaries Runtime Requirements First Translation UI Options Reference Settings Parameter Index Workflow Matrix API, Authentication, Rate Limit, and Timeout Troubleshooting Model, GPU, and Memory Troubleshooting Output, JSON, and Rendering Troubleshooting Colorize Only Export Original Text Export Translation Import Translation and Render Inpaint Only Normal Translation Replace Translation Translate JSON Only Upscale Only
desktop_qt_ui/core/config_models.py	CLI Configuration Overrides Workflows and File Modes Special Workflows and WebSocket Debug Artifacts Custom Request Parameters Feature Selectors API Management Tabs and Provider Fields Floating Rich Text Editor Editor Toolbar and Menus AI Colorizer Prompt AI OCR Prompt AI Renderer Prompt System and Translation Prompts Rich Text Styles and Presets Rich-Text Rules Table, Raw Editing, and Matching CLI, Batch, and Output Detection General and Application Settings Mask And Inpainting Mode-Specific Workflows and Template Alignment OCR, Filtering, and Text-Line Merging Settings Shell, Descriptions, and Config Import/Export Translation settings Typesetting and Rendering Upscale and Colorization Output Directory and Workflow Context and Prompts Translator Engine Dispatch Glossary, Streaming, and Line Breaking Retry, Rate Limits, and Translation Quality Translator Selection and Target Languages Adding or Changing a Feature Architecture and Code Boundaries Runtime Requirements First Translation Settings Parameter Index Workflow Matrix Model, GPU, and Memory Troubleshooting Colorize Only Export Original Text Inpaint Only Normal Translation Translate JSON Only Upscale Only
desktop_qt_ui/editor/alignment_service.py	Display, Compare, and Arrange
desktop_qt_ui/editor/commands.py	Floating Rich Text Editor Mask Painting and Clone Stamp
desktop_qt_ui/editor/controller_document_service.py	Display, Compare, and Arrange Editor Import/Export and Writeback Editor Layout and File List Region List and Text Editing Editor Toolbar and Menus General and Application Settings
desktop_qt_ui/editor/controller_export_service.py	Editor Import/Export and Writeback Mask Painting and Clone Stamp Region List and Text Editing Text Properties Editor Toolbar and Menus Output, JSON, and Rendering Troubleshooting
desktop_qt_ui/editor/controller_inpaint_service.py	Mask Painting and Clone Stamp
desktop_qt_ui/editor/document_load_worker.py	Display, Compare, and Arrange Editor Import/Export and Writeback Mask Painting and Clone Stamp Region List and Text Editing
desktop_qt_ui/editor/editor_controller.py	Canvas Tools and Selection Display, Compare, and Arrange Floating Rich Text Editor Mask Painting and Clone Stamp Region List and Text Editing Editor Style Properties Text Properties Editor Toolbar and Menus Replacement Rule Table: Groups, Order, and Matching General and Application Settings
desktop_qt_ui/editor/editor_logic.py	Editor Import/Export and Writeback Editor Layout and File List
desktop_qt_ui/editor/editor_model.py	Canvas Tools and Selection Display, Compare, and Arrange Mask Painting and Clone Stamp Region List and Text Editing
desktop_qt_ui/editor/file_list_model.py	Editor Layout and File List
desktop_qt_ui/editor/image_utils.py	Mask Painting and Clone Stamp
desktop_qt_ui/editor/region_change.py	Region List and Text Editing
desktop_qt_ui/editor/render_layout_pipeline.py	Editor Style Properties
desktop_qt_ui/editor/rich_text_editing.py	Floating Rich Text Editor Rich Text Styles and Presets
desktop_qt_ui/editor/rich_text_editor_state.py	Floating Rich Text Editor Rich Text Styles and Presets Rich-Text Rules Table, Raw Editing, and Matching
desktop_qt_ui/editor/rich_text_presets.py	Rich Text Styles and Presets
desktop_qt_ui/editor/session.py	Canvas Tools and Selection Display, Compare, and Arrange Mask Painting and Clone Stamp Region List and Text Editing
desktop_qt_ui/editor/text_render_pipeline.py	Editor Style Properties Text Properties
desktop_qt_ui/editor/text_renderer_backend.py	Editor Style Properties Text Properties
desktop_qt_ui/locales/en_US.json	CLI Configuration Overrides Local Input and Output Output, Debugging, and Exit Codes CLI Subprocess, Memory, and Recovery Web, WS, and Shared Modes Workflows and File Modes Debug Folder Naming and Overview How to Read and Share a Debug Run Input, Detection, and Rearrangement Debug Artifacts Mask, Inpainting and Rendering Debug Artifacts OCR and Text Region Debug Artifacts Special Workflows and WebSocket Debug Artifacts Connection Tests and Model List API Credentials, Addresses, and Models Custom Request Parameters Failures, Cooldown, and Recovery Feature Selectors Presets and Persistence API Management Tabs and Provider Fields Batch Actions and Order Batch Condition Matching Batch Preview, Apply, and Restore Batch Scheme Management Canvas Tools and Selection Display, Compare, and Arrange Floating Rich Text Editor Editor Import/Export and Writeback Editor Layout and File List Mask Painting and Clone Stamp Region List and Text Editing Editor Shortcuts Editor Style Properties Text Properties Editor Toolbar and Menus AI OCR Prompt AI Renderer Prompt Prompt List, Apply, and Preview Prompt Structured Editor System and Translation Prompts Replacement Rules: Raw YAML Editing, Regex, and Save Replacement Rule Table: Groups, Order, and Matching Rich Text Styles and Presets Rich-Text Rules Table, Raw Editing, and Matching CLI, Batch, and Output Detection General and Application Settings Mask And Inpainting Mode-Specific Workflows and Template Alignment OCR, Filtering, and Text-Line Merging Settings Shell, Descriptions, and Config Import/Export Translation settings Typesetting and Rendering Upscale and Colorization File List and Input Output Directory and Workflow Progress, Stop, and Task State Context and Prompts Glossary, Streaming, and Line Breaking Retry, Rate Limits, and Translation Quality Translator Selection and Target Languages Translator Chaining Adding or Changing a Feature Architecture and Code Boundaries Admin Endpoints: Users, Groups, Quota, and Audit HTTP API Authentication and Errors Batch, Export, and Import Processing HTTP Config, Environment, and Resource Endpoints History, Files, and Download Tickets HTTP Translation Endpoints Packaging and Release Tests and Code Quality Web Server Ports and Deployment Manga Translator Wiki Runtime Requirements Uninstall and Data Cleanup First Translation Product Forms Debug Artifact Index UI Options Reference Settings Parameter Index Workflow Matrix API, Authentication, Rate Limit, and Timeout Troubleshooting Model, GPU, and Memory Troubleshooting Output, JSON, and Rendering Troubleshooting Privacy, Cleanup, and Log Sharing Accounts, Permissions, and API Keys Administrator Interface Web Launch and Access Web Login, Language Switching, and Sessions Web Progress, Results, and History Resources, Fonts, and Prompts Web Upload, Configuration, and Translation Colorize Only Export Original Text Export Translation Import Translation and Render Inpaint Only Normal Translation Replace Translation Translate JSON Only Upscale Only
desktop_qt_ui/locales/zh_CN.json	CLI Configuration Overrides Local Input and Output Output, Debugging, and Exit Codes CLI Subprocess, Memory, and Recovery Web, WS, and Shared Modes Workflows and File Modes Debug Folder Naming and Overview How to Read and Share a Debug Run Input, Detection, and Rearrangement Debug Artifacts Mask, Inpainting and Rendering Debug Artifacts OCR and Text Region Debug Artifacts Special Workflows and WebSocket Debug Artifacts Connection Tests and Model List API Credentials, Addresses, and Models Custom Request Parameters Failures, Cooldown, and Recovery Feature Selectors Presets and Persistence API Management Tabs and Provider Fields Batch Actions and Order Batch Condition Matching Batch Preview, Apply, and Restore Batch Scheme Management Canvas Tools and Selection Display, Compare, and Arrange Floating Rich Text Editor Editor Import/Export and Writeback Editor Layout and File List Mask Painting and Clone Stamp Region List and Text Editing Editor Shortcuts Editor Style Properties Text Properties Editor Toolbar and Menus AI OCR Prompt AI Renderer Prompt Prompt List, Apply, and Preview Prompt Structured Editor System and Translation Prompts Replacement Rules: Raw YAML Editing, Regex, and Save Replacement Rule Table: Groups, Order, and Matching Rich Text Styles and Presets Rich-Text Rules Table, Raw Editing, and Matching CLI, Batch, and Output Detection General and Application Settings Mask And Inpainting Mode-Specific Workflows and Template Alignment OCR, Filtering, and Text-Line Merging Settings Shell, Descriptions, and Config Import/Export Translation settings Typesetting and Rendering Upscale and Colorization File List and Input Output Directory and Workflow Progress, Stop, and Task State Context and Prompts Glossary, Streaming, and Line Breaking Retry, Rate Limits, and Translation Quality Translator Selection and Target Languages Translator Chaining Adding or Changing a Feature Architecture and Code Boundaries Admin Endpoints: Users, Groups, Quota, and Audit HTTP API Authentication and Errors Batch, Export, and Import Processing HTTP Config, Environment, and Resource Endpoints History, Files, and Download Tickets HTTP Translation Endpoints Packaging and Release Tests and Code Quality Web Server Ports and Deployment Manga Translator Wiki Runtime Requirements Uninstall and Data Cleanup First Translation Product Forms Debug Artifact Index UI Options Reference Settings Parameter Index Workflow Matrix API, Authentication, Rate Limit, and Timeout Troubleshooting Model, GPU, and Memory Troubleshooting Output, JSON, and Rendering Troubleshooting Privacy, Cleanup, and Log Sharing Accounts, Permissions, and API Keys Administrator Interface Web Launch and Access Web Login, Language Switching, and Sessions Web Progress, Results, and History Resources, Fonts, and Prompts Web Upload, Configuration, and Translation Colorize Only Export Original Text Export Translation Import Translation and Render Inpaint Only Normal Translation Replace Translation Translate JSON Only Upscale Only
desktop_qt_ui/main.py	Debug Folder Naming and Overview How to Read and Share a Debug Run Special Workflows and WebSocket Debug Artifacts Architecture and Code Boundaries Packaging and Release Manga Translator Wiki Windows from Source Uninstall and Data Cleanup Product Forms Debug Artifact Index Installation and Startup Troubleshooting Privacy, Cleanup, and Log Sharing
desktop_qt_ui/ruff.toml	Tests and Code Quality
desktop_qt_ui/services/__init__.py	Architecture and Code Boundaries Installation and Startup Troubleshooting
desktop_qt_ui/services/batch_edit_engine.py	Batch Actions and Order Batch Condition Matching Batch Preview, Apply, and Restore UI Options Reference
desktop_qt_ui/services/batch_edit_schemes.py	Batch Actions and Order Batch Condition Matching Batch Preview, Apply, and Restore Batch Scheme Management
desktop_qt_ui/services/batch_edit_service.py	Batch Actions and Order Batch Preview, Apply, and Restore
desktop_qt_ui/services/config_service.py	CLI Configuration Overrides API Credentials, Addresses, and Models Presets and Persistence API Slots and Rotation Floating Rich Text Editor AI Colorizer Prompt AI Renderer Prompt Rich-Text Rules Table, Raw Editing, and Matching General and Application Settings Mask And Inpainting Settings Shell, Descriptions, and Config Import/Export Typesetting and Rendering Upscale and Colorization Context and Prompts Adding or Changing a Feature Runtime Requirements Windows from Source Privacy, Cleanup, and Log Sharing
desktop_qt_ui/services/export_service.py	Editor Import/Export and Writeback Mask Painting and Clone Stamp Text Properties Replacement Rule Table: Groups, Order, and Matching CLI, Batch, and Output Import Translation and Render
desktop_qt_ui/services/file_list_data_service.py	Editor Layout and File List File List and Input
desktop_qt_ui/services/file_service.py	Local Input and Output Mask Painting and Clone Stamp Region List and Text Editing File List and Input Output Directory and Workflow First Translation Workflow Matrix Normal Translation Upscale Only
desktop_qt_ui/services/i18n_service.py	Connection Tests and Model List Editor Layout and File List General and Application Settings Adding or Changing a Feature Manga Translator Wiki UI Options Reference
desktop_qt_ui/services/log_service.py	How to Read and Share a Debug Run
desktop_qt_ui/services/ocr_service.py	Region List and Text Editing Model, GPU, and Memory Troubleshooting
desktop_qt_ui/services/preset_service.py	Presets and Persistence
desktop_qt_ui/services/render_parameter_service.py	Editor Style Properties Text Properties
desktop_qt_ui/services/state_manager.py	Progress, Stop, and Task State
desktop_qt_ui/services/translation_service.py	Region List and Text Editing Translator Selection and Target Languages UI Options Reference
desktop_qt_ui/services/workflow_service.py	Workflows and File Modes CLI, Batch, and Output Product Forms Output, JSON, and Rendering Troubleshooting Export Original Text Export Translation Import Translation and Render
desktop_qt_ui/theme_registry.py	General and Application Settings
desktop_qt_ui/ui/editor/graphics_items.py	Canvas Tools and Selection Display, Compare, and Arrange
desktop_qt_ui/ui/editor/graphics_view_input.py	Canvas Tools and Selection Display, Compare, and Arrange Mask Painting and Clone Stamp Editor Shortcuts Editor Toolbar and Menus
desktop_qt_ui/ui/editor/graphics_view_layers.py	Display, Compare, and Arrange
desktop_qt_ui/ui/editor/graphics_view.py	Canvas Tools and Selection Editor Toolbar and Menus
desktop_qt_ui/ui/editor/mask_layer.py	Mask Painting and Clone Stamp
desktop_qt_ui/ui/editor/original_compare_view.py	Display, Compare, and Arrange
desktop_qt_ui/ui/editor/overlay_layer.py	Mask Painting and Clone Stamp
desktop_qt_ui/ui/editor/selection_manager.py	Canvas Tools and Selection
desktop_qt_ui/ui/editor/shortcut_manager.py	Editor Import/Export and Writeback Editor Shortcuts Editor Style Properties
desktop_qt_ui/ui/editor/view.py	Canvas Tools and Selection Display, Compare, and Arrange Floating Rich Text Editor Editor Import/Export and Writeback Editor Layout and File List Mask Painting and Clone Stamp Region List and Text Editing Editor Shortcuts Editor Style Properties Text Properties Editor Toolbar and Menus General and Application Settings
desktop_qt_ui/ui/main_page/dynamic_settings.py	Debug Folder Naming and Overview How to Read and Share a Debug Run API Credentials, Addresses, and Models Custom Request Parameters Feature Selectors Presets and Persistence API Management Tabs and Provider Fields API Slots and Rotation AI Colorizer Prompt AI OCR Prompt AI Renderer Prompt CLI, Batch, and Output Detection General and Application Settings Mode-Specific Workflows and Template Alignment OCR, Filtering, and Text-Line Merging Settings Shell, Descriptions, and Config Import/Export Upscale and Colorization Context and Prompts Translator Engine Dispatch Glossary, Streaming, and Line Breaking Retry, Rate Limits, and Translation Quality Adding or Changing a Feature Runtime Requirements Debug Artifact Index UI Options Reference Settings Parameter Index Model, GPU, and Memory Troubleshooting
desktop_qt_ui/ui/main_page/env_management.py	Connection Tests and Model List API Credentials, Addresses, and Models Custom Request Parameters Failures, Cooldown, and Recovery Feature Selectors Presets and Persistence API Management Tabs and Provider Fields API Slots and Rotation Translator Engine Dispatch UI Options Reference API, Authentication, Rate Limit, and Timeout Troubleshooting
desktop_qt_ui/ui/main_page/layout.py	Batch Scheme Management AI Colorizer Prompt Prompt List, Apply, and Preview Prompt Structured Editor General and Application Settings UI Options Reference
desktop_qt_ui/ui/main_page/pages/batch_edit_page.py	Batch Actions and Order Batch Condition Matching Batch Preview, Apply, and Restore Batch Scheme Management
desktop_qt_ui/ui/main_page/pages/env_page.py	API Credentials, Addresses, and Models Feature Selectors API Management Tabs and Provider Fields API, Authentication, Rate Limit, and Timeout Troubleshooting
desktop_qt_ui/ui/main_page/pages/prompt_page.py	Prompt List, Apply, and Preview Prompt Structured Editor System and Translation Prompts
desktop_qt_ui/ui/main_page/pages/replacements_page.py	Replacement Rules: Raw YAML Editing, Regex, and Save Replacement Rule Table: Groups, Order, and Matching
desktop_qt_ui/ui/main_page/pages/rich_text_rules_page.py	Rich Text Styles and Presets Rich-Text Rules Table, Raw Editing, and Matching
desktop_qt_ui/ui/main_page/pages/settings_page.py	Settings Shell, Descriptions, and Config Import/Export Adding or Changing a Feature Settings Parameter Index
desktop_qt_ui/ui/main_page/pages/translation_page.py	Workflows and File Modes Special Workflows and WebSocket Debug Artifacts Batch Scheme Management File List and Input Output Directory and Workflow First Translation UI Options Reference Workflow Matrix Colorize Only Export Original Text Inpaint Only Normal Translation
desktop_qt_ui/ui/main_page/runtime.py	Workflows and File Modes Special Workflows and WebSocket Debug Artifacts Mode-Specific Workflows and Template Alignment Output Directory and Workflow Progress, Stop, and Task State First Translation UI Options Reference Workflow Matrix Colorize Only Export Original Text Export Translation Import Translation and Render Inpaint Only Normal Translation Replace Translation Translate JSON Only Upscale Only
desktop_qt_ui/ui/main_page/settings_tab_layout.json	Debug Folder Naming and Overview How to Read and Share a Debug Run Mask, Inpainting and Rendering Debug Artifacts Special Workflows and WebSocket Debug Artifacts Custom Request Parameters AI Colorizer Prompt AI OCR Prompt AI Renderer Prompt CLI, Batch, and Output Detection General and Application Settings Mask And Inpainting Mode-Specific Workflows and Template Alignment OCR, Filtering, and Text-Line Merging Settings Shell, Descriptions, and Config Import/Export Translation settings Typesetting and Rendering Upscale and Colorization Context and Prompts Glossary, Streaming, and Line Breaking Retry, Rate Limits, and Translation Quality Translator Selection and Target Languages Translator Chaining Adding or Changing a Feature Debug Artifact Index Settings Parameter Index Model, GPU, and Memory Troubleshooting Output, JSON, and Rendering Troubleshooting
desktop_qt_ui/ui/main_page/view.py	Custom Request Parameters Replacement Rules: Raw YAML Editing, Regex, and Save Rich-Text Rules Table, Raw Editing, and Matching Settings Shell, Descriptions, and Config Import/Export Progress, Stop, and Task State Manga Translator Wiki Model, GPU, and Memory Troubleshooting
desktop_qt_ui/ui/main_window.py	Batch Condition Matching Batch Preview, Apply, and Restore Batch Scheme Management Editor Import/Export and Writeback Editor Layout and File List Replacement Rule Table: Groups, Order, and Matching Rich-Text Rules Table, Raw Editing, and Matching File List and Input Progress, Stop, and Task State Architecture and Code Boundaries Packaging and Release Manga Translator Wiki Product Forms
desktop_qt_ui/ui/secondary_pages/ai_colorizer_prompt_editor.py	AI Colorizer Prompt Prompt List, Apply, and Preview Prompt Structured Editor
desktop_qt_ui/ui/secondary_pages/batch_edit_condition_widgets.py	Batch Actions and Order Batch Condition Matching
desktop_qt_ui/ui/secondary_pages/batch_edit_panel.py	Batch Actions and Order Batch Condition Matching Batch Preview, Apply, and Restore Batch Scheme Management
desktop_qt_ui/ui/secondary_pages/custom_api_params_editor.py	Custom Request Parameters
desktop_qt_ui/ui/secondary_pages/filter_list_editor.py	OCR, Filtering, and Text-Line Merging
desktop_qt_ui/ui/secondary_pages/model_selector_dialog.py	Connection Tests and Model List
desktop_qt_ui/ui/secondary_pages/prompt_preview.py	Prompt List, Apply, and Preview Prompt Structured Editor Glossary, Streaming, and Line Breaking
desktop_qt_ui/ui/secondary_pages/replacements_editor.py	Replacement Rules: Raw YAML Editing, Regex, and Save Replacement Rule Table: Groups, Order, and Matching
desktop_qt_ui/ui/secondary_pages/rich_text_rules_editor.py	Rich Text Styles and Presets Rich-Text Rules Table, Raw Editing, and Matching
desktop_qt_ui/ui/secondary_pages/simple_prompt_editor_dialog.py	AI OCR Prompt AI Renderer Prompt
desktop_qt_ui/ui/widgets/color_picker.py	Editor Style Properties
desktop_qt_ui/ui/widgets/editor_toolbar.py	Display, Compare, and Arrange Editor Import/Export and Writeback Editor Shortcuts Editor Toolbar and Menus
desktop_qt_ui/ui/widgets/file_list_view.py	Editor Layout and File List File List and Input First Translation
desktop_qt_ui/ui/widgets/property_panel.py	Canvas Tools and Selection Mask Painting and Clone Stamp Region List and Text Editing Editor Shortcuts Editor Style Properties Text Properties UI Options Reference
desktop_qt_ui/ui/widgets/region_list_view.py	Region List and Text Editing Editor Shortcuts
desktop_qt_ui/ui/widgets/rich_text_editor_components.py	Floating Rich Text Editor Rich Text Styles and Presets UI Options Reference
desktop_qt_ui/ui/widgets/rich_text_floating_editor.py	Floating Rich Text Editor Editor Shortcuts Rich Text Styles and Presets
desktop_qt_ui/utils/app_version.py	Packaging and Release
desktop_qt_ui/utils/font_list.py	Text Properties Runtime Requirements
desktop_qt_ui/utils/memory_cleanup.py	Model, GPU, and Memory Troubleshooting

Core config and pipeline

Source file	Citing pages
manga_translator/__main__.py	Command Structure CLI Configuration Overrides Output, Debugging, and Exit Codes CLI Subprocess, Memory, and Recovery Web, WS, and Shared Modes Architecture and Code Boundaries Internal Shared and WebSocket Protocol Web Server Ports and Deployment Manga Translator Wiki Windows from Source Product Forms Installation and Startup Troubleshooting Model, GPU, and Memory Troubleshooting Web Launch and Access
manga_translator/api_key_rotation.py	Connection Tests and Model List API Credentials, Addresses, and Models Custom Request Parameters Failures, Cooldown, and Recovery API Management Tabs and Provider Fields API Slots and Rotation AI OCR Prompt Retry, Rate Limits, and Translation Quality Architecture and Code Boundaries UI Options Reference API, Authentication, Rate Limit, and Timeout Troubleshooting
manga_translator/api_request_params.py	Custom Request Parameters
manga_translator/args.py	Command Structure CLI Configuration Overrides Local Input and Output Output, Debugging, and Exit Codes CLI Subprocess, Memory, and Recovery Web, WS, and Shared Modes Workflows and File Modes OCR and Text Region Debug Artifacts CLI, Batch, and Output Internal Shared and WebSocket Protocol Web Server Ports and Deployment Manga Translator Wiki Docker Deployment Windows from Source Product Forms Installation and Startup Troubleshooting Model, GPU, and Memory Troubleshooting Web Deployment, Security, and Troubleshooting Web Launch and Access
manga_translator/config.py	CLI Configuration Overrides Workflows and File Modes Input, Detection, and Rearrangement Debug Artifacts Mask, Inpainting and Rendering Debug Artifacts OCR and Text Region Debug Artifacts Custom Request Parameters Feature Selectors API Management Tabs and Provider Fields Editor Style Properties AI Colorizer Prompt AI OCR Prompt AI Renderer Prompt System and Translation Prompts CLI, Batch, and Output Detection General and Application Settings Mask And Inpainting Mode-Specific Workflows and Template Alignment OCR, Filtering, and Text-Line Merging Translation settings Typesetting and Rendering Upscale and Colorization Context and Prompts Translator Engine Dispatch Glossary, Streaming, and Line Breaking Retry, Rate Limits, and Translation Quality Translator Selection and Target Languages Translator Chaining Adding or Changing a Feature Architecture and Code Boundaries Uninstall and Data Cleanup UI Options Reference Settings Parameter Index Model, GPU, and Memory Troubleshooting Resources, Fonts, and Prompts Colorize Only Normal Translation Replace Translation Translate JSON Only Upscale Only
manga_translator/custom_api_params.py	Custom Request Parameters AI OCR Prompt
manga_translator/image_formats.py	Command Structure Local Input and Output Editor Import/Export and Writeback Editor Layout and File List CLI, Batch, and Output File List and Input UI Options Reference Output, JSON, and Rendering Troubleshooting
manga_translator/inpainting/__init__.py	Mask, Inpainting and Rendering Debug Artifacts Mask And Inpainting
manga_translator/inpainting/none.py	Mask, Inpainting and Rendering Debug Artifacts Mask And Inpainting
manga_translator/inpainting/original.py	Mask And Inpainting
manga_translator/manga_translator.py	Local Input and Output Output, Debugging, and Exit Codes Workflows and File Modes Debug Folder Naming and Overview How to Read and Share a Debug Run Input, Detection, and Rearrangement Debug Artifacts Mask, Inpainting and Rendering Debug Artifacts OCR and Text Region Debug Artifacts Special Workflows and WebSocket Debug Artifacts Editor Import/Export and Writeback AI Colorizer Prompt AI OCR Prompt AI Renderer Prompt Prompt List, Apply, and Preview Prompt Structured Editor System and Translation Prompts Replacement Rules: Raw YAML Editing, Regex, and Save Replacement Rule Table: Groups, Order, and Matching CLI, Batch, and Output Detection General and Application Settings Mask And Inpainting Mode-Specific Workflows and Template Alignment OCR, Filtering, and Text-Line Merging Translation settings Typesetting and Rendering Output Directory and Workflow Context and Prompts Translator Engine Dispatch Glossary, Streaming, and Line Breaking Retry, Rate Limits, and Translation Quality Translator Chaining Adding or Changing a Feature Architecture and Code Boundaries First Translation Product Forms Debug Artifact Index Workflow Matrix Model, GPU, and Memory Troubleshooting Output, JSON, and Rendering Troubleshooting Resources, Fonts, and Prompts Colorize Only Export Original Text Export Translation Import Translation and Render Inpaint Only Normal Translation Replace Translation Translate JSON Only Upscale Only
manga_translator/mask_refinement/__init__.py	Output, Debugging, and Exit Codes Debug Folder Naming and Overview Mask, Inpainting and Rendering Debug Artifacts Mask And Inpainting OCR, Filtering, and Text-Line Merging Debug Artifact Index
manga_translator/mode/local.py	Command Structure CLI Configuration Overrides Local Input and Output Output, Debugging, and Exit Codes CLI Subprocess, Memory, and Recovery Workflows and File Modes Debug Folder Naming and Overview How to Read and Share a Debug Run CLI, Batch, and Output General and Application Settings Architecture and Code Boundaries Debug Artifact Index Privacy, Cleanup, and Log Sharing
manga_translator/mode/share.py	Command Structure Web, WS, and Shared Modes Special Workflows and WebSocket Debug Artifacts Architecture and Code Boundaries HTTP Streaming Protocol Internal Shared and WebSocket Protocol Web Server Ports and Deployment
manga_translator/mode/subprocess_manager.py	Command Structure Output, Debugging, and Exit Codes CLI Subprocess, Memory, and Recovery
manga_translator/mode/ws.py	Command Structure Web, WS, and Shared Modes Debug Folder Naming and Overview Special Workflows and WebSocket Debug Artifacts Architecture and Code Boundaries Internal Shared and WebSocket Protocol Web Server Ports and Deployment Debug Artifact Index
manga_translator/runtime_api_resolver.py	Connection Tests and Model List API Credentials, Addresses, and Models Custom Request Parameters Failures, Cooldown, and Recovery Feature Selectors Presets and Persistence API Slots and Rotation AI OCR Prompt Translator Engine Dispatch Retry, Rate Limits, and Translation Quality Translator Chaining Architecture and Code Boundaries API, Authentication, Rate Limit, and Timeout Troubleshooting
manga_translator/runtime_files.py	How to Read and Share a Debug Run Custom Request Parameters AI Colorizer Prompt AI Renderer Prompt Replacement Rules: Raw YAML Editing, Regex, and Save Replacement Rule Table: Groups, Order, and Matching Rich-Text Rules Table, Raw Editing, and Matching Installation and Startup Troubleshooting Output, JSON, and Rendering Troubleshooting Privacy, Cleanup, and Log Sharing
manga_translator/runtime_paths.py	Local Input and Output Output, Debugging, and Exit Codes Batch Scheme Management Rich-Text Rules Table, Raw Editing, and Matching Web Server Ports and Deployment Windows from Source Uninstall and Data Cleanup Update and Version Switching Windows Portable Privacy, Cleanup, and Log Sharing
manga_translator/save.py	Local Input and Output How to Read and Share a Debug Run Mask, Inpainting and Rendering Debug Artifacts CLI, Batch, and Output General and Application Settings Output, JSON, and Rendering Troubleshooting Privacy, Cleanup, and Log Sharing
manga_translator/server_paths.py	HTTP Config, Environment, and Resource Endpoints Web Server Ports and Deployment Uninstall and Data Cleanup Privacy, Cleanup, and Log Sharing Web Deployment, Security, and Troubleshooting
manga_translator/translators/__init__.py	Feature Selectors Translator Engine Dispatch Translator Selection and Target Languages Translator Chaining Adding or Changing a Feature Architecture and Code Boundaries
manga_translator/translators/common.py	Connection Tests and Model List Prompt List, Apply, and Preview Prompt Structured Editor System and Translation Prompts Translation settings Context and Prompts Glossary, Streaming, and Line Breaking Retry, Rate Limits, and Translation Quality Translator Chaining
manga_translator/translators/gemini_hq.py	Custom Request Parameters Prompt List, Apply, and Preview System and Translation Prompts Glossary, Streaming, and Line Breaking Retry, Rate Limits, and Translation Quality
manga_translator/translators/gemini.py	API Credentials, Addresses, and Models Custom Request Parameters Failures, Cooldown, and Recovery API Slots and Rotation Prompt List, Apply, and Preview System and Translation Prompts Context and Prompts Glossary, Streaming, and Line Breaking Retry, Rate Limits, and Translation Quality Translator Chaining API, Authentication, Rate Limit, and Timeout Troubleshooting
manga_translator/translators/none.py	Translator Chaining
manga_translator/translators/openai_hq.py	Custom Request Parameters Prompt List, Apply, and Preview System and Translation Prompts Glossary, Streaming, and Line Breaking Retry, Rate Limits, and Translation Quality
manga_translator/translators/openai.py	API Credentials, Addresses, and Models Custom Request Parameters Failures, Cooldown, and Recovery API Slots and Rotation Prompt List, Apply, and Preview System and Translation Prompts Context and Prompts Glossary, Streaming, and Line Breaking Retry, Rate Limits, and Translation Quality Translator Chaining API, Authentication, Rate Limit, and Timeout Troubleshooting
manga_translator/translators/original.py	Translator Chaining
manga_translator/translators/prompt_loader.py	AI OCR Prompt Prompt List, Apply, and Preview Prompt Structured Editor System and Translation Prompts Context and Prompts Glossary, Streaming, and Line Breaking Resources, Fonts, and Prompts
manga_translator/translators/sakura.py	API, Authentication, Rate Limit, and Timeout Troubleshooting
manga_translator/utils/ai_image_preprocess.py	AI Renderer Prompt
manga_translator/utils/concurrent_pipeline.py	CLI, Batch, and Output First Translation
manga_translator/utils/dotenv_utils.py	API Credentials, Addresses, and Models Presets and Persistence HTTP Config, Environment, and Resource Endpoints Web Server Ports and Deployment
manga_translator/utils/generic.py	Output, Debugging, and Exit Codes Debug Folder Naming and Overview Input, Detection, and Rearrangement Debug Artifacts OCR and Text Region Debug Artifacts Debug Artifact Index Model, GPU, and Memory Troubleshooting Output, JSON, and Rendering Troubleshooting
manga_translator/utils/inference.py	Runtime Requirements Uninstall and Data Cleanup Model, GPU, and Memory Troubleshooting
manga_translator/utils/log.py	Output, Debugging, and Exit Codes Privacy, Cleanup, and Log Sharing
manga_translator/utils/onnx_runtime.py	Model, GPU, and Memory Troubleshooting
manga_translator/utils/openai_compat.py	Connection Tests and Model List
manga_translator/utils/path_manager.py	Local Input and Output Workflows and File Modes Batch Preview, Apply, and Restore Editor Import/Export and Writeback Mode-Specific Workflows and Template Alignment Output Directory and Workflow First Translation Product Forms Workflow Matrix Output, JSON, and Rendering Troubleshooting Colorize Only Export Original Text Export Translation Import Translation and Render Inpaint Only Normal Translation Replace Translation Translate JSON Only Upscale Only
manga_translator/utils/photoshop_export.py	Output, Debugging, and Exit Codes Debug Folder Naming and Overview Debug Artifact Index
manga_translator/utils/replace_translation.py	Debug Folder Naming and Overview Special Workflows and WebSocket Debug Artifacts Mode-Specific Workflows and Template Alignment Output Directory and Workflow Debug Artifact Index Workflow Matrix Replace Translation
manga_translator/utils/retry.py	Retry, Rate Limits, and Translation Quality API, Authentication, Rate Limit, and Timeout Troubleshooting
manga_translator/utils/text_filter.py	OCR, Filtering, and Text-Line Merging
manga_translator/utils/textblock.py	OCR and Text Region Debug Artifacts
manga_translator/utils/threading.py	Internal Shared and WebSocket Protocol
manga_translator/utils/translation_template.py	Workflows and File Modes Mode-Specific Workflows and Template Alignment Output Directory and Workflow First Translation Workflow Matrix Output, JSON, and Rendering Troubleshooting Export Original Text Export Translation Import Translation and Render

Stage modules

Source file	Citing pages
manga_translator/colorization/	Upscale and Colorization
manga_translator/colorization/__init__.py	Feature Selectors AI Colorizer Prompt
manga_translator/colorization/model_api_colorizer.py	API Credentials, Addresses, and Models Custom Request Parameters Failures, Cooldown, and Recovery AI Colorizer Prompt
manga_translator/colorization/prompt_loader.py	AI Colorizer Prompt
manga_translator/detection/__init__.py	Input, Detection, and Rearrangement Debug Artifacts Detection Architecture and Code Boundaries
manga_translator/detection/*.py	Debug Artifact Index
manga_translator/detection/common.py	Detection
manga_translator/detection/ctd.py	Input, Detection, and Rearrangement Debug Artifacts
manga_translator/detection/dbnet_convnext.py	Input, Detection, and Rearrangement Debug Artifacts
manga_translator/detection/default.py	Input, Detection, and Rearrangement Debug Artifacts Detection
manga_translator/detection/yolo_obb.py	Output, Debugging, and Exit Codes Input, Detection, and Rearrangement Debug Artifacts Detection Debug Artifact Index
manga_translator/ocr/__init__.py	Feature Selectors AI OCR Prompt OCR, Filtering, and Text-Line Merging
manga_translator/ocr/*.py	Output, Debugging, and Exit Codes Debug Folder Naming and Overview
manga_translator/ocr/common.py	OCR, Filtering, and Text-Line Merging
manga_translator/ocr/model_32px.py	OCR and Text Region Debug Artifacts Debug Artifact Index
manga_translator/ocr/model_48px_ctc.py	OCR and Text Region Debug Artifacts Debug Artifact Index
manga_translator/ocr/model_48px.py	OCR and Text Region Debug Artifacts Debug Artifact Index
manga_translator/ocr/model_api_ocr.py	API Credentials, Addresses, and Models Custom Request Parameters Failures, Cooldown, and Recovery AI OCR Prompt
manga_translator/ocr/model_manga_ocr.py	OCR and Text Region Debug Artifacts Debug Artifact Index
manga_translator/ocr/model_paddleocr.py	OCR and Text Region Debug Artifacts Debug Artifact Index
manga_translator/ocr/prompt_loader.py	AI OCR Prompt
manga_translator/rendering/__init__.py	Mask, Inpainting and Rendering Debug Artifacts Feature Selectors Region List and Text Editing AI Renderer Prompt Replacement Rules: Raw YAML Editing, Regex, and Save Replacement Rule Table: Groups, Order, and Matching Rich Text Styles and Presets Rich-Text Rules Table, Raw Editing, and Matching Typesetting and Rendering Glossary, Streaming, and Line Breaking Output, JSON, and Rendering Troubleshooting Replace Translation
manga_translator/rendering/chinese_linebreak.py	Mask, Inpainting and Rendering Debug Artifacts Typesetting and Rendering Runtime Requirements Output, JSON, and Rendering Troubleshooting
manga_translator/rendering/model_api_renderer.py	API Credentials, Addresses, and Models Custom Request Parameters Failures, Cooldown, and Recovery Feature Selectors AI Renderer Prompt Typesetting and Rendering Output, JSON, and Rendering Troubleshooting
manga_translator/rendering/prompt_loader.py	AI Renderer Prompt
manga_translator/rendering/rich_text_rules.py	Floating Rich Text Editor Rich Text Styles and Presets Rich-Text Rules Table, Raw Editing, and Matching
manga_translator/rendering/rich_text_sync.py	Replacement Rule Table: Groups, Order, and Matching Rich Text Styles and Presets Rich-Text Rules Table, Raw Editing, and Matching
manga_translator/rendering/rich_text.py	Floating Rich Text Editor Rich Text Styles and Presets
manga_translator/rendering/text_render/_fonts.py	Output, JSON, and Rendering Troubleshooting Resources, Fonts, and Prompts
manga_translator/rendering/text_replacement_layout.py	Replacement Rules: Raw YAML Editing, Regex, and Save Replacement Rule Table: Groups, Order, and Matching Rich Text Styles and Presets Rich-Text Rules Table, Raw Editing, and Matching
manga_translator/rendering/text_replacements.py	Region List and Text Editing Text Properties Replacement Rules: Raw YAML Editing, Regex, and Save Replacement Rule Table: Groups, Order, and Matching
manga_translator/textline_merge/__init__.py	OCR, Filtering, and Text-Line Merging
manga_translator/upscaling/	Upscale and Colorization

Server and web

Source file	Citing pages
manga_translator/server/args.py	Web Server Ports and Deployment
manga_translator/server/core/{config_manager,group_management_service,group_service,quota_service,audit_service,permission_service,middleware,task_manager}.py	Administrator Interface
manga_translator/server/core/account_service.py	Admin Endpoints: Users, Groups, Quota, and Audit Accounts, Permissions, and API Keys Web Login, Language Switching, and Sessions
manga_translator/server/core/api_key_policy.py	HTTP Config, Environment, and Resource Endpoints Accounts, Permissions, and API Keys
manga_translator/server/core/audit_service.py	Admin Endpoints: Users, Groups, Quota, and Audit
manga_translator/server/core/cleanup_service.py	History, Files, and Download Tickets Uninstall and Data Cleanup Privacy, Cleanup, and Log Sharing
manga_translator/server/core/config_management_service.py	HTTP Config, Environment, and Resource Endpoints
manga_translator/server/core/config_manager.py	Translator Chaining HTTP Config, Environment, and Resource Endpoints Web Server Ports and Deployment Docker Deployment Web Deployment, Security, and Troubleshooting
manga_translator/server/core/download_ticket_service.py	History, Files, and Download Tickets Web Deployment, Security, and Troubleshooting Web Progress, Results, and History
manga_translator/server/core/env_service.py	HTTP Config, Environment, and Resource Endpoints Web Server Ports and Deployment
manga_translator/server/core/group_management_service.py	Admin Endpoints: Users, Groups, Quota, and Audit
manga_translator/server/core/group_service.py	Admin Endpoints: Users, Groups, Quota, and Audit
manga_translator/server/core/history_service.py	History, Files, and Download Tickets Web Progress, Results, and History
manga_translator/server/core/middleware.py	Admin Endpoints: Users, Groups, Quota, and Audit HTTP API Authentication and Errors HTTP Translation Endpoints API, Authentication, Rate Limit, and Timeout Troubleshooting Accounts, Permissions, and API Keys Web Deployment, Security, and Troubleshooting Web Login, Language Switching, and Sessions
manga_translator/server/core/models.py	Admin Endpoints: Users, Groups, Quota, and Audit
manga_translator/server/core/permission_integration.py	History, Files, and Download Tickets
manga_translator/server/core/permission_service_v2.py	History, Files, and Download Tickets
manga_translator/server/core/permission_service.py	Admin Endpoints: Users, Groups, Quota, and Audit Accounts, Permissions, and API Keys
manga_translator/server/core/quota_scheduler.py	Admin Endpoints: Users, Groups, Quota, and Audit
manga_translator/server/core/quota_service.py	Admin Endpoints: Users, Groups, Quota, and Audit
manga_translator/server/core/request_rate_limiter.py	API, Authentication, Rate Limit, and Timeout Troubleshooting
manga_translator/server/core/resource_service.py	HTTP Config, Environment, and Resource Endpoints Resources, Fonts, and Prompts
manga_translator/server/core/response_utils.py	Batch, Export, and Import Processing HTTP Config, Environment, and Resource Endpoints HTTP Translation Endpoints Accounts, Permissions, and API Keys
manga_translator/server/core/session_security_service.py	HTTP API Authentication and Errors API, Authentication, Rate Limit, and Timeout Troubleshooting Web Deployment, Security, and Troubleshooting
manga_translator/server/core/session_service.py	HTTP API Authentication and Errors Web Deployment, Security, and Troubleshooting Web Login, Language Switching, and Sessions
manga_translator/server/core/system_init.py	Admin Endpoints: Users, Groups, Quota, and Audit Web Login, Language Switching, and Sessions
manga_translator/server/core/task_manager.py	Architecture and Code Boundaries Batch, Export, and Import Processing HTTP Streaming Protocol HTTP Translation Endpoints
manga_translator/server/core/translation_integration.py	Architecture and Code Boundaries Privacy, Cleanup, and Log Sharing
manga_translator/server/export_utils.py	Web Server Ports and Deployment
manga_translator/server/instance.py	Web, WS, and Shared Modes Internal Shared and WebSocket Protocol
manga_translator/server/main.py	Command Structure Web, WS, and Shared Modes Architecture and Code Boundaries HTTP API Authentication and Errors HTTP Config, Environment, and Resource Endpoints History, Files, and Download Tickets Internal Shared and WebSocket Protocol Web Server Ports and Deployment Docker Deployment Product Forms API, Authentication, Rate Limit, and Timeout Troubleshooting Installation and Startup Troubleshooting Web Deployment, Security, and Troubleshooting Web Launch and Access Web Upload, Configuration, and Translation
manga_translator/server/models/group_models.py	Admin Endpoints: Users, Groups, Quota, and Audit
manga_translator/server/models/quota_models.py	Admin Endpoints: Users, Groups, Quota, and Audit
manga_translator/server/myqueue.py	Batch, Export, and Import Processing HTTP Streaming Protocol HTTP Translation Endpoints
manga_translator/server/repositories/group_repository.py	Admin Endpoints: Users, Groups, Quota, and Audit
manga_translator/server/repositories/quota_repository.py	Admin Endpoints: Users, Groups, Quota, and Audit
manga_translator/server/repositories/translation_repository.py	History, Files, and Download Tickets
manga_translator/server/request_extraction.py	Web, WS, and Shared Modes Batch, Export, and Import Processing History, Files, and Download Tickets HTTP Streaming Protocol HTTP Translation Endpoints Web Progress, Results, and History Web Upload, Configuration, and Translation
manga_translator/server/routes/	Docker Deployment Product Forms
manga_translator/server/routes/{admin,users,groups,sessions,quota,audit,config_management}.py	Administrator Interface
manga_translator/server/routes/admin.py	HTTP Streaming Protocol
manga_translator/server/routes/audit.py	Admin Endpoints: Users, Groups, Quota, and Audit
manga_translator/server/routes/auth.py	HTTP API Authentication and Errors API, Authentication, Rate Limit, and Timeout Troubleshooting Accounts, Permissions, and API Keys Web Deployment, Security, and Troubleshooting Web Launch and Access Web Login, Language Switching, and Sessions
manga_translator/server/routes/config_management.py	HTTP API Authentication and Errors HTTP Config, Environment, and Resource Endpoints
manga_translator/server/routes/config.py	Translator Chaining HTTP Config, Environment, and Resource Endpoints HTTP Streaming Protocol Accounts, Permissions, and API Keys Web Login, Language Switching, and Sessions Resources, Fonts, and Prompts Web Upload, Configuration, and Translation
manga_translator/server/routes/groups.py	Admin Endpoints: Users, Groups, Quota, and Audit HTTP API Authentication and Errors
manga_translator/server/routes/history.py	HTTP API Authentication and Errors History, Files, and Download Tickets Web Progress, Results, and History
manga_translator/server/routes/logs.py	Privacy, Cleanup, and Log Sharing Web Progress, Results, and History
manga_translator/server/routes/quota.py	Admin Endpoints: Users, Groups, Quota, and Audit
manga_translator/server/routes/resources.py	HTTP Config, Environment, and Resource Endpoints Resources, Fonts, and Prompts
manga_translator/server/routes/sessions.py	HTTP API Authentication and Errors
manga_translator/server/routes/translation_auth.py	HTTP API Authentication and Errors Batch, Export, and Import Processing HTTP Translation Endpoints
manga_translator/server/routes/translation.py	HTTP API Authentication and Errors Batch, Export, and Import Processing HTTP Streaming Protocol HTTP Translation Endpoints Web Progress, Results, and History Web Upload, Configuration, and Translation
manga_translator/server/routes/users.py	Admin Endpoints: Users, Groups, Quota, and Audit HTTP API Authentication and Errors Accounts, Permissions, and API Keys
manga_translator/server/routes/web.py	HTTP API Authentication and Errors API, Authentication, Rate Limit, and Timeout Troubleshooting Administrator Interface Web Deployment, Security, and Troubleshooting Web Launch and Access Web Login, Language Switching, and Sessions Web Upload, Configuration, and Translation
manga_translator/server/runtime_api.py	Batch, Export, and Import Processing HTTP Config, Environment, and Resource Endpoints HTTP Translation Endpoints Web Upload, Configuration, and Translation
manga_translator/server/sent_data_internal.py	Web, WS, and Shared Modes HTTP Streaming Protocol Internal Shared and WebSocket Protocol
manga_translator/server/server_config.json	Resources, Fonts, and Prompts
manga_translator/server/server_utils.py	HTTP Streaming Protocol Internal Shared and WebSocket Protocol
manga_translator/server/static/admin-new.html	Admin Endpoints: Users, Groups, Quota, and Audit Web Server Ports and Deployment Privacy, Cleanup, and Log Sharing Accounts, Permissions, and API Keys Administrator Interface Web Deployment, Security, and Troubleshooting Web Login, Language Switching, and Sessions
manga_translator/server/static/index.html	Batch, Export, and Import Processing HTTP Config, Environment, and Resource Endpoints HTTP Translation Endpoints Manga Translator Wiki Product Forms Web Login, Language Switching, and Sessions Web Progress, Results, and History Resources, Fonts, and Prompts Web Upload, Configuration, and Translation
manga_translator/server/static/js/admin/app.js	Administrator Interface Web Login, Language Switching, and Sessions
manga_translator/server/static/js/admin/components/permission-editor.js	Admin Endpoints: Users, Groups, Quota, and Audit Accounts, Permissions, and API Keys Administrator Interface
manga_translator/server/static/js/admin/i18n.js	Administrator Interface Web Login, Language Switching, and Sessions
manga_translator/server/static/js/admin/modules/{users,groups,quota,sessions,tasks,history,logs,envvars,config,announcement,cleanup}.js	Administrator Interface
manga_translator/server/static/js/admin/modules/{users,groups,quota}.js	Admin Endpoints: Users, Groups, Quota, and Audit
manga_translator/server/static/js/admin/modules/cleanup.js	Privacy, Cleanup, and Log Sharing
manga_translator/server/static/js/admin/modules/envvars.js	Accounts, Permissions, and API Keys
manga_translator/server/static/js/admin/modules/history.js	History, Files, and Download Tickets
manga_translator/server/static/js/admin/modules/logs.js	Privacy, Cleanup, and Log Sharing
manga_translator/server/static/js/admin/modules/permissions.js	Accounts, Permissions, and API Keys
manga_translator/server/static/js/admin/modules/users.js	Accounts, Permissions, and API Keys
manga_translator/server/static/js/history-gallery.js	History, Files, and Download Tickets Product Forms Web Progress, Results, and History
manga_translator/server/static/js/i18n.js	HTTP API Authentication and Errors HTTP Streaming Protocol Manga Translator Wiki Accounts, Permissions, and API Keys Administrator Interface Web Deployment, Security, and Troubleshooting Resources, Fonts, and Prompts Web Upload, Configuration, and Translation
manga_translator/server/static/js/shared/api-key-schema.js	HTTP Config, Environment, and Resource Endpoints Web Upload, Configuration, and Translation
manga_translator/server/static/login.html	HTTP API Authentication and Errors Accounts, Permissions, and API Keys Web Deployment, Security, and Troubleshooting Web Launch and Access Web Login, Language Switching, and Sessions
manga_translator/server/static/script.js	Translator Chaining HTTP API Authentication and Errors Batch, Export, and Import Processing HTTP Config, Environment, and Resource Endpoints HTTP Streaming Protocol HTTP Translation Endpoints Manga Translator Wiki Uninstall and Data Cleanup Product Forms Accounts, Permissions, and API Keys Administrator Interface Web Deployment, Security, and Troubleshooting Web Launch and Access Web Login, Language Switching, and Sessions Web Progress, Results, and History Resources, Fonts, and Prompts Web Upload, Configuration, and Translation
manga_translator/server/streaming.py	HTTP Streaming Protocol Web Upload, Configuration, and Translation
manga_translator/server/to_json.py	Batch, Export, and Import Processing HTTP Streaming Protocol HTTP Translation Endpoints

Install and packaging

Source file	Citing pages
.github/workflows/build-and-release.yml	Packaging and Release
.github/workflows/docker-build-push.yml	Packaging and Release
.github/workflows/tests.yml	Tests and Code Quality
.gitignore	Tests and Code Quality
packaging/.dockerignore	Packaging and Release
packaging/build_packages.py	Packaging and Release
packaging/check_version.py	Packaging and Release
packaging/docker-compose.yml	Packaging and Release Web Server Ports and Deployment Manga Translator Wiki Docker Deployment Uninstall and Data Cleanup Product Forms Installation and Startup Troubleshooting Web Deployment, Security, and Troubleshooting Web Launch and Access
packaging/docker-entrypoint.sh	Packaging and Release Web Server Ports and Deployment Docker Deployment Installation and Startup Troubleshooting Web Deployment, Security, and Troubleshooting
packaging/Dockerfile	Packaging and Release Web Server Ports and Deployment Manga Translator Wiki Docker Deployment Uninstall and Data Cleanup Product Forms Installation and Startup Troubleshooting Web Deployment, Security, and Troubleshooting Web Launch and Access
packaging/launch.py	Packaging and Release Linux and macOS Installation Runtime Requirements Windows from Source Update and Version Switching Windows Portable Installation and Startup Troubleshooting
packaging/maintenance_config.json	Linux and macOS Installation
packaging/manga-translator-{cpu,gpu}.spec	Packaging and Release
packaging/VERSION	Packaging and Release Update and Version Switching Windows Portable
pyproject.toml	Adding or Changing a Feature Packaging and Release Tests and Code Quality Docker Deployment Linux and macOS Installation Runtime Requirements Windows from Source Update and Version Switching Windows Portable
Unix-*.sh	Packaging and Release
Unix-Install-or-Update.sh	Linux and macOS Installation Uninstall and Data Cleanup Update and Version Switching
Unix-Start.sh	Linux and macOS Installation Uninstall and Data Cleanup Update and Version Switching Installation and Startup Troubleshooting
uv.lock	Tests and Code Quality Docker Deployment Runtime Requirements Update and Version Switching Windows Portable
Win-*.bat	Packaging and Release
Win-Install-or-Update.bat	Windows from Source Uninstall and Data Cleanup Update and Version Switching Windows Portable
Win-Start.bat	Windows from Source Uninstall and Data Cleanup Update and Version Switching Windows Portable Installation and Startup Troubleshooting

Config, resources, and prompts

Source file

Citing pages

config/config-example.json

CLI Configuration Overrides Feature Selectors API Management Tabs and Provider Fields Editor Toolbar and Menus AI OCR Prompt System and Translation Prompts Rich Text Styles and Presets CLI, Batch, and Output Mode-Specific Workflows and Template Alignment OCR, Filtering, and Text-Line Merging Translation settings Upscale and Colorization Adding or Changing a Feature Runtime Requirements Model, GPU, and Memory Troubleshooting Inpaint Only Upscale Only

Research material and data

Source file	Citing pages
doc/wiki/.vitepress/config.ts	Manga Translator Wiki
doc/wiki/.vitepress/theme/components/LanguageSwitch.vue	Manga Translator Wiki
doc/wiki/BLUEPRINT.md	Related Projects and Links Code Index
doc/wiki/data/coverage.generated.json	Code Index
doc/wiki/data/i18n.generated.json	Web, WS, and Shared Modes Batch Preview, Apply, and Restore Text Properties Translator Chaining Batch, Export, and Import Processing History, Files, and Download Tickets UI Options Reference Settings Parameter Index Code Index Administrator Interface Web Launch and Access Web Login, Language Switching, and Sessions Web Progress, Results, and History
doc/wiki/data/README.md	Related Projects and Links
doc/wiki/data/related-projects.schema.json	Related Projects and Links
doc/wiki/data/related-projects.yml	Related Projects and Links
doc/wiki/data/settings.generated.json	Translator Chaining UI Options Reference Settings Parameter Index
doc/wiki/PAGE_GUIDELINES.md	Code Index
doc/wiki/research/cli-command-inventory.md	CLI Subprocess, Memory, and Recovery Web, WS, and Shared Modes Workflows and File Modes Internal Shared and WebSocket Protocol Product Forms Installation and Startup Troubleshooting
doc/wiki/research/desktop-main-navigation.md	Product Forms
doc/wiki/research/phase0-debug-artifact-path-trace.md	Debug Folder Naming and Overview Input, Detection, and Rearrangement Debug Artifacts OCR and Text Region Debug Artifacts Debug Artifact Index
doc/wiki/research/phase0-options-i18n-matrix.md	UI Options Reference Settings Parameter Index
doc/wiki/research/phase0-page-coverage-matrix.md	Debug Folder Naming and Overview Internal Shared and WebSocket Protocol Related Projects and Links Debug Artifact Index Settings Parameter Index Code Index Installation and Startup Troubleshooting
doc/wiki/research/phase0-related-files-formats-debug-safety.md	Debug Folder Naming and Overview Input, Detection, and Rearrangement Debug Artifacts Windows from Source Windows Portable Product Forms Debug Artifact Index
doc/wiki/research/phase0-web-user-http.md	Web, WS, and Shared Modes Internal Shared and WebSocket Protocol Product Forms
doc/wiki/research/workflow-matrix-source-evidence.md	Workflows and File Modes Product Forms Workflow Matrix
doc/wiki/scripts/build-i18n-catalog.mjs	Adding or Changing a Feature
doc/wiki/scripts/build-settings-catalog.py	Adding or Changing a Feature
doc/wiki/scripts/verify-route-mirror.mjs	Code Index
doc/wiki/scripts/verify-source-evidence.mjs	Code Index
doc/wiki/TODO.md	Code Index
doc/wiki/verify_related_projects.py	Related Projects and Links
doc/wiki/zh/**/*.md	Code Index
doc/wiki/zh/desktop/settings/*.md	Settings Parameter Index

Tests and scripts

Source file	Citing pages
test/_bootstrap.py	Tests and Code Quality
test/README.md	Adding or Changing a Feature Tests and Code Quality
test/test_app_logic_file_sources.py	Progress, Stop, and Task State
test/test_yolo_obb_rearrange_edge_merge.py	Detection
test/test_yolo_obb_sfx_filter.py	Detection

Read next

Page	Relationship to this page
Settings Index	grouped parameter index with stored values, defaults, and consumers
UI Options Reference	value, English, and Simplified Chinese matrix of all enum/dropdown options
Workflow Matrix	inputs, skipped stages, and outputs of the nine workflows
Debug Artifact Index	generation and purpose of debug files, images, JSON, and directories
PAGE_GUIDELINES.md (Page Guidelines)	frontmatter, i18n three-column table, parameter template, and Mermaid requirements
BLUEPRINT.md (Wiki Blueprint)	reference indexes only summarize and reverse-link

Data sources

Data	File	Use
Page conventions	doc/wiki/BLUEPRINT.md, PAGE_GUIDELINES.md	index scope and page format
Generated data	doc/wiki/data/coverage.generated.json, i18n.generated.json	coverage and UI-text statistics
Aggregation input	the "Code locations" tables under doc/wiki/zh/**/*.md	file-to-page relationships
Maintenance scripts	doc/wiki/scripts/	route, UI-text, and index maintenance