How ciddwd/overlay-translator works
屏译 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: CaptureService.kt Capture service · RoutingTranslator.kt Translation routing · RoutingOcrEngine.kt OCR engines · SettingsRepository.kt Settings storage
Components 19
Capture and triggers
- Capture service
app/src/main/java/com/gameocr/app/service/CaptureService.kt - Screen capture
app/src/main/java/com/gameocr/app/capture - Capture triggers
app/src/main/java/com/gameocr/app/trigger/GameOcrAccessibilityService.kt
OCR and image processing
- OCR engines
app/src/main/java/com/gameocr/app/ocr/RoutingOcrEngine.kt - Paddle OCR
app/src/main/java/com/gameocr/app/ocr/PaddleOcrEngine.kt - Manga OCR
app/src/main/java/com/gameocr/app/ocr/MangaOcrEngine.kt - Recognized text
app/src/main/java/com/gameocr/app/ocr/TextBlock.kt - Gallery translation
app/src/main/java/com/gameocr/app/gallery/GalleryTranslationManager.kt
Translation and lookup
- Translation routing
app/src/main/java/com/gameocr/app/translate/RoutingTranslator.kt - Translation engines
app/src/main/java/com/gameocr/app/translate - Glossary and memory
app/src/main/java/com/gameocr/app/glossary/TranslationGlossary.kt - Word lookup
app/src/main/java/com/gameocr/app/translate/WordSelectTranslationCoordinator.kt
Presentation and speech
- Translation overlay
app/src/main/java/com/gameocr/app/overlay/OverlayManager.kt - Floating controls
app/src/main/java/com/gameocr/app/overlay/FloatingButtonManager.kt - Speech engines
app/src/main/java/com/gameocr/app/tts/RoutingTtsEngine.kt
Settings and resources
- Settings storage
app/src/main/java/com/gameocr/app/data/SettingsRepository.kt - Model downloads
app/src/main/java/com/gameocr/app/download/ModelDownloadManager.kt
Other components
- User
- External services
Connections 25
- User → Floating controls: triggers
- User → Gallery translation: selects images
- Capture triggers → Capture service: starts capture
app/src/main/java/com/gameocr/app/trigger/GameOcrAccessibilityService.kt - Floating controls → Capture service: requests translation
app/src/main/java/com/gameocr/app/service/CaptureService.kt - Capture service → Screen capture: captures screen
app/src/main/java/com/gameocr/app/service/CaptureService.kt - Capture service → OCR engines: recognizes content
- OCR engines → Paddle OCR: selects engine
app/src/main/java/com/gameocr/app/ocr/RoutingOcrEngine.kt - OCR engines → Manga OCR: selects engine
app/src/main/java/com/gameocr/app/ocr/RoutingOcrEngine.kt - Paddle OCR → Recognized text: returns blocks
app/src/main/java/com/gameocr/app/ocr/PaddleOcrEngine.kt - Manga OCR → Recognized text: returns blocks
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
app/src/main/java/com/gameocr/app/service/CaptureService.kt - Settings storage → OCR engines: configures OCR
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