# aidanpark/screen-translator architecture

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

- Interactive diagram: https://gitdiagram.com/aidanpark/screen-translator
- Repository: https://github.com/aidanpark/screen-translator

## Overview

Screen Translate is an Android floating-screen translator. The user grants capture access, points or selects a screen region, receives on-device OCR and grouped text, and sees a translation in the overlay; fixed-area mode repeats this for a pinned region. The README documents five translation engines and OCR support beyond the sampled implementation. The graph preserves those capabilities, but the translation implementation is not present in the supplied tree. Edges are limited to documented workflow relationships and caller references in the supplied source index/excerpts.

Main entry points: [`app/src/main/java/com/galaxy/airviewdictionary/core/OverlayService.kt`](https://github.com/aidanpark/screen-translator/blob/master/app/src/main/java/com/galaxy/airviewdictionary/core/OverlayService.kt) (Overlay service), [`app/src/main/java/com/galaxy/airviewdictionary/data/local/vision/VisionRepository.kt`](https://github.com/aidanpark/screen-translator/blob/master/app/src/main/java/com/galaxy/airviewdictionary/data/local/vision/VisionRepository.kt) (OCR orchestration), [`app/src/main/java/com/galaxy/airviewdictionary/data/local/capture/CaptureRepository.kt`](https://github.com/aidanpark/screen-translator/blob/master/app/src/main/java/com/galaxy/airviewdictionary/data/local/capture/CaptureRepository.kt) (Screen capture), [`app/src/main/java/com/galaxy/airviewdictionary/data/local/vision/kit/VisionKitSelector.kt`](https://github.com/aidanpark/screen-translator/blob/master/app/src/main/java/com/galaxy/airviewdictionary/data/local/vision/kit/VisionKitSelector.kt) (Recognizer selection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App entry"]
  node_splash["Startup and permissions<br/>[SplashActivity.kt]"]
  node_service["Overlay service<br/>[OverlayService.kt]"]
end

subgraph group_overlay["Floating interaction"]
  node_overlayui["Floating overlay UI<br/>[OverlayView.kt]"]
  node_target["Pointer and selection"]
  node_fixed["Fixed-area mode"]
end

subgraph group_recognition["Screen recognition"]
  node_capture["Screen capture"]
  node_vision["OCR orchestration"]
  node_selector["Recognizer selection"]
  node_mlkit["ML Kit OCR<br/>[MlKitVisionKit.kt]"]
  node_paddle["PaddleOCR"]
  node_assembly["Text grouping"]
  node_textmodel["Recognized text model<br/>[Line.kt]"]
end

subgraph group_services["Preferences and services"]
  node_translation["Translation engines"]
  node_preferences[("User preferences")]
  node_settings["Settings screen"]
  node_tts["Text-to-speech<br/>[TTSRepository.kt]"]
  node_secure[("Secure settings")]
end

node_user(("User"))
node_android(("Android screen"))

node_user -->|"starts app"| node_splash
node_splash -.->|"starts overlay"| node_service
node_user -->|"points or selects"| node_target
node_android -->|"screen frames"| node_capture
node_service -->|"requests frames"| node_capture
node_capture -.->|"supplies image"| node_vision
node_service -->|"requests recognition"| node_vision
node_vision -->|"selects recognizer"| node_selector
node_selector -.->|"dispatches OCR"| node_mlkit
node_selector -.->|"dispatches OCR"| node_paddle
node_vision -->|"groups detected text"| node_assembly
node_assembly -.->|"builds text model"| node_textmodel
node_vision -->|"provides recognized text"| node_translation
node_translation -->|"returns translation"| node_overlayui
node_target -->|"shows result"| node_overlayui
node_fixed -->|"repeats capture"| node_capture
node_settings -->|"reads and saves"| node_preferences
node_service -->|"reads settings"| node_preferences
node_service -->|"uses secure data"| node_secure
node_service -->|"uses speech"| node_tts

click node_splash "https://github.com/aidanpark/screen-translator/blob/master/app/src/main/java/com/galaxy/airviewdictionary/ui/screen/intro/SplashActivity.kt"
click node_service "https://github.com/aidanpark/screen-translator/blob/master/app/src/main/java/com/galaxy/airviewdictionary/core/OverlayService.kt"
click node_overlayui "https://github.com/aidanpark/screen-translator/blob/master/app/src/main/java/com/galaxy/airviewdictionary/ui/screen/overlay/OverlayView.kt"
click node_target "https://github.com/aidanpark/screen-translator/blob/master/app/src/main/java/com/galaxy/airviewdictionary/ui/screen/overlay/targethandle/TargetHandleView.kt"
click node_fixed "https://github.com/aidanpark/screen-translator/blob/master/app/src/main/java/com/galaxy/airviewdictionary/ui/screen/overlay/fixedarea/FixedAreaTranslationView.kt"
click node_capture "https://github.com/aidanpark/screen-translator/blob/master/app/src/main/java/com/galaxy/airviewdictionary/data/local/capture/CaptureRepository.kt"
click node_vision "https://github.com/aidanpark/screen-translator/blob/master/app/src/main/java/com/galaxy/airviewdictionary/data/local/vision/VisionRepository.kt"
click node_selector "https://github.com/aidanpark/screen-translator/blob/master/app/src/main/java/com/galaxy/airviewdictionary/data/local/vision/kit/VisionKitSelector.kt"
click node_mlkit "https://github.com/aidanpark/screen-translator/blob/master/app/src/main/java/com/galaxy/airviewdictionary/data/local/vision/kit/MlKitVisionKit.kt"
click node_paddle "https://github.com/aidanpark/screen-translator/blob/master/app/src/main/java/com/galaxy/airviewdictionary/data/local/vision/kit/paddle/PaddleOcrVisionKit.kt"
click node_assembly "https://github.com/aidanpark/screen-translator/blob/master/app/src/main/java/com/galaxy/airviewdictionary/data/local/vision/ParagraphAssembler.kt"
click node_textmodel "https://github.com/aidanpark/screen-translator/blob/master/app/src/main/java/com/galaxy/airviewdictionary/data/local/vision/model/Line.kt"
click node_preferences "https://github.com/aidanpark/screen-translator/blob/master/app/src/main/java/com/galaxy/airviewdictionary/data/local/preference/PreferenceRepository.kt"
click node_settings "https://github.com/aidanpark/screen-translator/blob/master/app/src/main/java/com/galaxy/airviewdictionary/ui/screen/main/SettingsActivity.kt"
click node_tts "https://github.com/aidanpark/screen-translator/blob/master/app/src/main/java/com/galaxy/airviewdictionary/data/local/tts/TTSRepository.kt"
click node_secure "https://github.com/aidanpark/screen-translator/blob/master/app/src/main/java/com/galaxy/airviewdictionary/data/local/secure/SecureRepository.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_splash,node_service,node_user,node_android toneBlue
class node_overlayui,node_target,node_fixed toneAmber
class node_capture,node_vision,node_selector,node_mlkit,node_paddle,node_assembly,node_textmodel toneMint
class node_translation,node_preferences,node_settings,node_tts,node_secure toneRose
```

## Components

### App entry

- [Startup and permissions](https://github.com/aidanpark/screen-translator/blob/master/app/src/main/java/com/galaxy/airviewdictionary/ui/screen/intro/SplashActivity.kt): `app/src/main/java/com/galaxy/airviewdictionary/ui/screen/intro/SplashActivity.kt`
- [Overlay service](https://github.com/aidanpark/screen-translator/blob/master/app/src/main/java/com/galaxy/airviewdictionary/core/OverlayService.kt): `app/src/main/java/com/galaxy/airviewdictionary/core/OverlayService.kt`

### Floating interaction

- [Floating overlay UI](https://github.com/aidanpark/screen-translator/blob/master/app/src/main/java/com/galaxy/airviewdictionary/ui/screen/overlay/OverlayView.kt): `app/src/main/java/com/galaxy/airviewdictionary/ui/screen/overlay/OverlayView.kt`
- [Pointer and selection](https://github.com/aidanpark/screen-translator/blob/master/app/src/main/java/com/galaxy/airviewdictionary/ui/screen/overlay/targethandle/TargetHandleView.kt): `app/src/main/java/com/galaxy/airviewdictionary/ui/screen/overlay/targethandle/TargetHandleView.kt`
- [Fixed-area mode](https://github.com/aidanpark/screen-translator/blob/master/app/src/main/java/com/galaxy/airviewdictionary/ui/screen/overlay/fixedarea/FixedAreaTranslationView.kt): `app/src/main/java/com/galaxy/airviewdictionary/ui/screen/overlay/fixedarea/FixedAreaTranslationView.kt`

### Screen recognition

- [Screen capture](https://github.com/aidanpark/screen-translator/blob/master/app/src/main/java/com/galaxy/airviewdictionary/data/local/capture/CaptureRepository.kt): `app/src/main/java/com/galaxy/airviewdictionary/data/local/capture/CaptureRepository.kt`
- [OCR orchestration](https://github.com/aidanpark/screen-translator/blob/master/app/src/main/java/com/galaxy/airviewdictionary/data/local/vision/VisionRepository.kt): `app/src/main/java/com/galaxy/airviewdictionary/data/local/vision/VisionRepository.kt`
- [Recognizer selection](https://github.com/aidanpark/screen-translator/blob/master/app/src/main/java/com/galaxy/airviewdictionary/data/local/vision/kit/VisionKitSelector.kt): `app/src/main/java/com/galaxy/airviewdictionary/data/local/vision/kit/VisionKitSelector.kt`
- [ML Kit OCR](https://github.com/aidanpark/screen-translator/blob/master/app/src/main/java/com/galaxy/airviewdictionary/data/local/vision/kit/MlKitVisionKit.kt): `app/src/main/java/com/galaxy/airviewdictionary/data/local/vision/kit/MlKitVisionKit.kt`
- [PaddleOCR](https://github.com/aidanpark/screen-translator/blob/master/app/src/main/java/com/galaxy/airviewdictionary/data/local/vision/kit/paddle/PaddleOcrVisionKit.kt): `app/src/main/java/com/galaxy/airviewdictionary/data/local/vision/kit/paddle/PaddleOcrVisionKit.kt`
- [Text grouping](https://github.com/aidanpark/screen-translator/blob/master/app/src/main/java/com/galaxy/airviewdictionary/data/local/vision/ParagraphAssembler.kt): `app/src/main/java/com/galaxy/airviewdictionary/data/local/vision/ParagraphAssembler.kt`
- [Recognized text model](https://github.com/aidanpark/screen-translator/blob/master/app/src/main/java/com/galaxy/airviewdictionary/data/local/vision/model/Line.kt): `app/src/main/java/com/galaxy/airviewdictionary/data/local/vision/model/Line.kt`

### Preferences and services

- **Translation engines**
- [User preferences](https://github.com/aidanpark/screen-translator/blob/master/app/src/main/java/com/galaxy/airviewdictionary/data/local/preference/PreferenceRepository.kt): `app/src/main/java/com/galaxy/airviewdictionary/data/local/preference/PreferenceRepository.kt`
- [Settings screen](https://github.com/aidanpark/screen-translator/blob/master/app/src/main/java/com/galaxy/airviewdictionary/ui/screen/main/SettingsActivity.kt): `app/src/main/java/com/galaxy/airviewdictionary/ui/screen/main/SettingsActivity.kt`
- [Text-to-speech](https://github.com/aidanpark/screen-translator/blob/master/app/src/main/java/com/galaxy/airviewdictionary/data/local/tts/TTSRepository.kt): `app/src/main/java/com/galaxy/airviewdictionary/data/local/tts/TTSRepository.kt`
- [Secure settings](https://github.com/aidanpark/screen-translator/blob/master/app/src/main/java/com/galaxy/airviewdictionary/data/local/secure/SecureRepository.kt): `app/src/main/java/com/galaxy/airviewdictionary/data/local/secure/SecureRepository.kt`

### Other components

- **User**
- **Android screen**

## Connections

- User → Startup and permissions: starts app (evidence: `app/src/main/java/com/galaxy/airviewdictionary/ui/screen/intro/SplashActivity.kt`)
- Startup and permissions → Overlay service: starts overlay (evidence: `app/src/main/java/com/galaxy/airviewdictionary/core/OverlayService.kt`)
- User → Pointer and selection: points or selects (evidence: `README.md`)
- Android screen → Screen capture: screen frames (evidence: `README.md`)
- Overlay service → Screen capture: requests frames (evidence: `app/src/main/java/com/galaxy/airviewdictionary/core/OverlayService.kt`)
- Screen capture → OCR orchestration: supplies image
- Overlay service → OCR orchestration: requests recognition (evidence: `app/src/main/java/com/galaxy/airviewdictionary/core/OverlayService.kt`)
- OCR orchestration → Recognizer selection: selects recognizer (evidence: `app/src/main/java/com/galaxy/airviewdictionary/data/local/vision/VisionRepository.kt`)
- Recognizer selection → ML Kit OCR: dispatches OCR
- Recognizer selection → PaddleOCR: dispatches OCR
- OCR orchestration → Text grouping: groups detected text (evidence: `app/src/main/java/com/galaxy/airviewdictionary/data/local/vision/VisionRepository.kt`)
- Text grouping → Recognized text model: builds text model (evidence: `app/src/main/java/com/galaxy/airviewdictionary/data/local/vision/ParagraphAssembler.kt`)
- OCR orchestration → Translation engines: provides recognized text (evidence: `README.md`)
- Translation engines → Floating overlay UI: returns translation (evidence: `README.md`)
- Pointer and selection → Floating overlay UI: shows result (evidence: `README.md`)
- Fixed-area mode → Screen capture: repeats capture (evidence: `README.md`)
- Settings screen → User preferences: reads and saves (evidence: `app/src/main/java/com/galaxy/airviewdictionary/ui/screen/main/SettingsActivity.kt`)
- Overlay service → User preferences: reads settings (evidence: `app/src/main/java/com/galaxy/airviewdictionary/core/OverlayService.kt`)
- Overlay service → Secure settings: uses secure data (evidence: `app/src/main/java/com/galaxy/airviewdictionary/core/OverlayService.kt`)
- Overlay service → Text-to-speech: uses speech (evidence: `app/src/main/java/com/galaxy/airviewdictionary/core/OverlayService.kt`)
