How aidanpark/screen-translator works
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: OverlayService.kt Overlay service · VisionRepository.kt OCR orchestration · CaptureRepository.kt Screen capture · VisionKitSelector.kt Recognizer selection
Components 19
App entry
- Startup and permissions
app/src/main/java/com/galaxy/airviewdictionary/ui/screen/intro/SplashActivity.kt - Overlay service
app/src/main/java/com/galaxy/airviewdictionary/core/OverlayService.kt
Floating interaction
- Floating overlay UI
app/src/main/java/com/galaxy/airviewdictionary/ui/screen/overlay/OverlayView.kt - Pointer and selection
app/src/main/java/com/galaxy/airviewdictionary/ui/screen/overlay/targethandle/TargetHandleView.kt - Fixed-area mode
app/src/main/java/com/galaxy/airviewdictionary/ui/screen/overlay/fixedarea/FixedAreaTranslationView.kt
Screen recognition
- Screen capture
app/src/main/java/com/galaxy/airviewdictionary/data/local/capture/CaptureRepository.kt - OCR orchestration
app/src/main/java/com/galaxy/airviewdictionary/data/local/vision/VisionRepository.kt - Recognizer selection
app/src/main/java/com/galaxy/airviewdictionary/data/local/vision/kit/VisionKitSelector.kt - ML Kit OCR
app/src/main/java/com/galaxy/airviewdictionary/data/local/vision/kit/MlKitVisionKit.kt - PaddleOCR
app/src/main/java/com/galaxy/airviewdictionary/data/local/vision/kit/paddle/PaddleOcrVisionKit.kt - Text grouping
app/src/main/java/com/galaxy/airviewdictionary/data/local/vision/ParagraphAssembler.kt - Recognized text model
app/src/main/java/com/galaxy/airviewdictionary/data/local/vision/model/Line.kt
Preferences and services
- Translation engines
- User preferences
app/src/main/java/com/galaxy/airviewdictionary/data/local/preference/PreferenceRepository.kt - Settings screen
app/src/main/java/com/galaxy/airviewdictionary/ui/screen/main/SettingsActivity.kt - Text-to-speech
app/src/main/java/com/galaxy/airviewdictionary/data/local/tts/TTSRepository.kt - Secure settings
app/src/main/java/com/galaxy/airviewdictionary/data/local/secure/SecureRepository.kt
Other components
- User
- Android screen
Connections 20
- User → Startup and permissions: starts app
app/src/main/java/com/galaxy/airviewdictionary/ui/screen/intro/SplashActivity.kt - Startup and permissions → Overlay service: starts overlay
app/src/main/java/com/galaxy/airviewdictionary/core/OverlayService.kt - User → Pointer and selection: points or selects
README.md - Android screen → Screen capture: screen frames
README.md - Overlay service → Screen capture: requests frames
app/src/main/java/com/galaxy/airviewdictionary/core/OverlayService.kt - Screen capture → OCR orchestration: supplies image
- Overlay service → OCR orchestration: requests recognition
app/src/main/java/com/galaxy/airviewdictionary/core/OverlayService.kt - OCR orchestration → Recognizer selection: selects recognizer
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
app/src/main/java/com/galaxy/airviewdictionary/data/local/vision/VisionRepository.kt - Text grouping → Recognized text model: builds text model
app/src/main/java/com/galaxy/airviewdictionary/data/local/vision/ParagraphAssembler.kt - OCR orchestration → Translation engines: provides recognized text
README.md - Translation engines → Floating overlay UI: returns translation
README.md - Pointer and selection → Floating overlay UI: shows result
README.md - Fixed-area mode → Screen capture: repeats capture
README.md - Settings screen → User preferences: reads and saves
app/src/main/java/com/galaxy/airviewdictionary/ui/screen/main/SettingsActivity.kt - Overlay service → User preferences: reads settings
app/src/main/java/com/galaxy/airviewdictionary/core/OverlayService.kt - Overlay service → Secure settings: uses secure data
app/src/main/java/com/galaxy/airviewdictionary/core/OverlayService.kt - Overlay service → Text-to-speech: uses speech
app/src/main/java/com/galaxy/airviewdictionary/core/OverlayService.kt