# ciddwd/overlay-translator architecture

> Architecture diagram of the GitHub repository ciddwd/overlay-translator, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ciddwd/overlay-translator
- Repository: https://github.com/ciddwd/overlay-translator

## Overview

屏译 is an Android screen and image translator. Its main runtime flow starts with a user-triggered capture, sends the captured content through OCR and translation, then presents translated text in an overlay; speech is an optional presentation action. The repository also supports background gallery translation, word lookup, input translation, configurable engine choices, and model downloads. The README documents these product flows, while the sampled source confirms key service, OCR, text-block, and overlay responsibilities; some links to unsampled subsystems are therefore documented rather than source-verified.

Main entry points: [`app/src/main/java/com/gameocr/app/service/CaptureService.kt`](https://github.com/ciddwd/overlay-translator/blob/main/app/src/main/java/com/gameocr/app/service/CaptureService.kt) (Capture service), [`app/src/main/java/com/gameocr/app/translate/RoutingTranslator.kt`](https://github.com/ciddwd/overlay-translator/blob/main/app/src/main/java/com/gameocr/app/translate/RoutingTranslator.kt) (Translation routing), [`app/src/main/java/com/gameocr/app/ocr/RoutingOcrEngine.kt`](https://github.com/ciddwd/overlay-translator/blob/main/app/src/main/java/com/gameocr/app/ocr/RoutingOcrEngine.kt) (OCR engines), [`app/src/main/java/com/gameocr/app/data/SettingsRepository.kt`](https://github.com/ciddwd/overlay-translator/blob/main/app/src/main/java/com/gameocr/app/data/SettingsRepository.kt) (Settings storage)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_capture["Capture and triggers"]
  node_capture_service["Capture service<br/>[CaptureService.kt]"]
  node_capture_methods["Screen capture"]
  node_capture_triggers["Capture triggers"]
end

subgraph group_recognition["OCR and image processing"]
  node_ocr_routing["OCR engines"]
  node_paddle_ocr["Paddle OCR<br/>[PaddleOcrEngine.kt]"]
  node_manga_ocr["Manga OCR<br/>[MangaOcrEngine.kt]"]
  node_text_blocks["Recognized text<br/>[TextBlock.kt]"]
  node_gallery["Gallery translation"]
end

subgraph group_translation["Translation and lookup"]
  node_translator["Translation routing"]
  node_translation_engines["Translation engines"]
  node_glossary_memory[("Glossary and memory")]
  node_word_lookup["Word lookup"]
end

subgraph group_presentation["Presentation and speech"]
  node_overlay["Translation overlay<br/>[OverlayManager.kt]"]
  node_floating_button["Floating controls"]
  node_tts["Speech engines"]
end

subgraph group_support["Settings and resources"]
  node_settings[("Settings storage")]
  node_model_download["Model downloads"]
end

node_user(("User"))
node_external_services{{"External services"}}

node_user -->|"triggers"| node_floating_button
node_user -->|"selects images"| node_gallery
node_capture_triggers -->|"starts capture"| node_capture_service
node_floating_button -.->|"requests translation"| node_capture_service
node_capture_service -->|"captures screen"| node_capture_methods
node_capture_service -->|"recognizes content"| node_ocr_routing
node_ocr_routing -.->|"selects engine"| node_paddle_ocr
node_ocr_routing -.->|"selects engine"| node_manga_ocr
node_paddle_ocr -->|"returns blocks"| node_text_blocks
node_manga_ocr -->|"returns blocks"| node_text_blocks
node_capture_service -->|"translates text"| node_translator
node_translator -.->|"routes request"| node_translation_engines
node_translator -.->|"uses terminology"| node_glossary_memory
node_capture_service -->|"presents results"| node_overlay
node_overlay -->|"reads text"| node_tts
node_gallery -->|"translates images"| node_translator
node_user -->|"selects text"| node_word_lookup
node_word_lookup -.->|"translates selection"| node_translator
node_settings -.->|"configures capture"| node_capture_service
node_settings -.->|"configures OCR"| node_ocr_routing
node_settings -.->|"configures engines"| node_translator
node_user -->|"requests models"| node_model_download
node_model_download -.->|"downloads models"| node_external_services
node_translation_engines -->|"calls providers"| node_external_services
node_tts -.->|"uses speech service"| node_external_services

click node_capture_service "https://github.com/ciddwd/overlay-translator/blob/main/app/src/main/java/com/gameocr/app/service/CaptureService.kt"
click node_capture_methods "https://github.com/ciddwd/overlay-translator/tree/main/app/src/main/java/com/gameocr/app/capture"
click node_capture_triggers "https://github.com/ciddwd/overlay-translator/blob/main/app/src/main/java/com/gameocr/app/trigger/GameOcrAccessibilityService.kt"
click node_ocr_routing "https://github.com/ciddwd/overlay-translator/blob/main/app/src/main/java/com/gameocr/app/ocr/RoutingOcrEngine.kt"
click node_paddle_ocr "https://github.com/ciddwd/overlay-translator/blob/main/app/src/main/java/com/gameocr/app/ocr/PaddleOcrEngine.kt"
click node_manga_ocr "https://github.com/ciddwd/overlay-translator/blob/main/app/src/main/java/com/gameocr/app/ocr/MangaOcrEngine.kt"
click node_text_blocks "https://github.com/ciddwd/overlay-translator/blob/main/app/src/main/java/com/gameocr/app/ocr/TextBlock.kt"
click node_gallery "https://github.com/ciddwd/overlay-translator/blob/main/app/src/main/java/com/gameocr/app/gallery/GalleryTranslationManager.kt"
click node_translator "https://github.com/ciddwd/overlay-translator/blob/main/app/src/main/java/com/gameocr/app/translate/RoutingTranslator.kt"
click node_translation_engines "https://github.com/ciddwd/overlay-translator/tree/main/app/src/main/java/com/gameocr/app/translate"
click node_glossary_memory "https://github.com/ciddwd/overlay-translator/blob/main/app/src/main/java/com/gameocr/app/glossary/TranslationGlossary.kt"
click node_word_lookup "https://github.com/ciddwd/overlay-translator/blob/main/app/src/main/java/com/gameocr/app/translate/WordSelectTranslationCoordinator.kt"
click node_overlay "https://github.com/ciddwd/overlay-translator/blob/main/app/src/main/java/com/gameocr/app/overlay/OverlayManager.kt"
click node_floating_button "https://github.com/ciddwd/overlay-translator/blob/main/app/src/main/java/com/gameocr/app/overlay/FloatingButtonManager.kt"
click node_tts "https://github.com/ciddwd/overlay-translator/blob/main/app/src/main/java/com/gameocr/app/tts/RoutingTtsEngine.kt"
click node_settings "https://github.com/ciddwd/overlay-translator/blob/main/app/src/main/java/com/gameocr/app/data/SettingsRepository.kt"
click node_model_download "https://github.com/ciddwd/overlay-translator/blob/main/app/src/main/java/com/gameocr/app/download/ModelDownloadManager.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_capture_service,node_capture_methods,node_capture_triggers,node_user toneBlue
class node_ocr_routing,node_paddle_ocr,node_manga_ocr,node_text_blocks,node_gallery toneAmber
class node_translator,node_translation_engines,node_glossary_memory,node_word_lookup toneMint
class node_overlay,node_floating_button,node_tts toneRose
class node_settings,node_model_download,node_external_services toneIndigo
```

## Components

### Capture and triggers

- [Capture service](https://github.com/ciddwd/overlay-translator/blob/main/app/src/main/java/com/gameocr/app/service/CaptureService.kt): `app/src/main/java/com/gameocr/app/service/CaptureService.kt`
- [Screen capture](https://github.com/ciddwd/overlay-translator/tree/main/app/src/main/java/com/gameocr/app/capture): `app/src/main/java/com/gameocr/app/capture`
- [Capture triggers](https://github.com/ciddwd/overlay-translator/blob/main/app/src/main/java/com/gameocr/app/trigger/GameOcrAccessibilityService.kt): `app/src/main/java/com/gameocr/app/trigger/GameOcrAccessibilityService.kt`

### OCR and image processing

- [OCR engines](https://github.com/ciddwd/overlay-translator/blob/main/app/src/main/java/com/gameocr/app/ocr/RoutingOcrEngine.kt): `app/src/main/java/com/gameocr/app/ocr/RoutingOcrEngine.kt`
- [Paddle OCR](https://github.com/ciddwd/overlay-translator/blob/main/app/src/main/java/com/gameocr/app/ocr/PaddleOcrEngine.kt): `app/src/main/java/com/gameocr/app/ocr/PaddleOcrEngine.kt`
- [Manga OCR](https://github.com/ciddwd/overlay-translator/blob/main/app/src/main/java/com/gameocr/app/ocr/MangaOcrEngine.kt): `app/src/main/java/com/gameocr/app/ocr/MangaOcrEngine.kt`
- [Recognized text](https://github.com/ciddwd/overlay-translator/blob/main/app/src/main/java/com/gameocr/app/ocr/TextBlock.kt): `app/src/main/java/com/gameocr/app/ocr/TextBlock.kt`
- [Gallery translation](https://github.com/ciddwd/overlay-translator/blob/main/app/src/main/java/com/gameocr/app/gallery/GalleryTranslationManager.kt): `app/src/main/java/com/gameocr/app/gallery/GalleryTranslationManager.kt`

### Translation and lookup

- [Translation routing](https://github.com/ciddwd/overlay-translator/blob/main/app/src/main/java/com/gameocr/app/translate/RoutingTranslator.kt): `app/src/main/java/com/gameocr/app/translate/RoutingTranslator.kt`
- [Translation engines](https://github.com/ciddwd/overlay-translator/tree/main/app/src/main/java/com/gameocr/app/translate): `app/src/main/java/com/gameocr/app/translate`
- [Glossary and memory](https://github.com/ciddwd/overlay-translator/blob/main/app/src/main/java/com/gameocr/app/glossary/TranslationGlossary.kt): `app/src/main/java/com/gameocr/app/glossary/TranslationGlossary.kt`
- [Word lookup](https://github.com/ciddwd/overlay-translator/blob/main/app/src/main/java/com/gameocr/app/translate/WordSelectTranslationCoordinator.kt): `app/src/main/java/com/gameocr/app/translate/WordSelectTranslationCoordinator.kt`

### Presentation and speech

- [Translation overlay](https://github.com/ciddwd/overlay-translator/blob/main/app/src/main/java/com/gameocr/app/overlay/OverlayManager.kt): `app/src/main/java/com/gameocr/app/overlay/OverlayManager.kt`
- [Floating controls](https://github.com/ciddwd/overlay-translator/blob/main/app/src/main/java/com/gameocr/app/overlay/FloatingButtonManager.kt): `app/src/main/java/com/gameocr/app/overlay/FloatingButtonManager.kt`
- [Speech engines](https://github.com/ciddwd/overlay-translator/blob/main/app/src/main/java/com/gameocr/app/tts/RoutingTtsEngine.kt): `app/src/main/java/com/gameocr/app/tts/RoutingTtsEngine.kt`

### Settings and resources

- [Settings storage](https://github.com/ciddwd/overlay-translator/blob/main/app/src/main/java/com/gameocr/app/data/SettingsRepository.kt): `app/src/main/java/com/gameocr/app/data/SettingsRepository.kt`
- [Model downloads](https://github.com/ciddwd/overlay-translator/blob/main/app/src/main/java/com/gameocr/app/download/ModelDownloadManager.kt): `app/src/main/java/com/gameocr/app/download/ModelDownloadManager.kt`

### Other components

- **User**
- **External services**

## Connections

- User → Floating controls: triggers
- User → Gallery translation: selects images
- Capture triggers → Capture service: starts capture (evidence: `app/src/main/java/com/gameocr/app/trigger/GameOcrAccessibilityService.kt`)
- Floating controls → Capture service: requests translation (evidence: `app/src/main/java/com/gameocr/app/service/CaptureService.kt`)
- Capture service → Screen capture: captures screen (evidence: `app/src/main/java/com/gameocr/app/service/CaptureService.kt`)
- Capture service → OCR engines: recognizes content
- OCR engines → Paddle OCR: selects engine (evidence: `app/src/main/java/com/gameocr/app/ocr/RoutingOcrEngine.kt`)
- OCR engines → Manga OCR: selects engine (evidence: `app/src/main/java/com/gameocr/app/ocr/RoutingOcrEngine.kt`)
- Paddle OCR → Recognized text: returns blocks (evidence: `app/src/main/java/com/gameocr/app/ocr/PaddleOcrEngine.kt`)
- Manga OCR → Recognized text: returns blocks (evidence: `app/src/main/java/com/gameocr/app/ocr/MangaOcrEngine.kt`)
- Capture service → Translation routing: translates text
- Translation routing → Translation engines: routes request
- Translation routing → Glossary and memory: uses terminology
- Capture service → Translation overlay: presents results
- Translation overlay → Speech engines: reads text
- Gallery translation → Translation routing: translates images
- User → Word lookup: selects text
- Word lookup → Translation routing: translates selection
- Settings storage → Capture service: configures capture (evidence: `app/src/main/java/com/gameocr/app/service/CaptureService.kt`)
- Settings storage → OCR engines: configures OCR (evidence: `app/src/main/java/com/gameocr/app/ocr/RoutingOcrEngine.kt`)
- Settings storage → Translation routing: configures engines
- User → Model downloads: requests models
- Model downloads → External services: downloads models
- Translation engines → External services: calls providers
- Speech engines → External services: uses speech service
