# d3m-sudo/anura architecture

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

- Interactive diagram: https://gitdiagram.com/d3m-sudo/anura
- Repository: https://github.com/d3m-sudo/anura

## Overview

Anura is a native Linux desktop OCR and barcode-reading application. The user captures a screen region or supplies an image; the screenshot service runs barcode detection and OCR, the controller dispatches the extracted result, and the application can copy it to the clipboard and present it in the editor. Other documented branches include language-model management, speech, sharing, preferences, and opt-in local history. Arrows below are limited to relationships visible in excerpts or explicitly documented in the README; several feature implementations were not sampled.

Main entry points: [`anura/window.py`](https://github.com/d3m-sudo/anura/blob/development/anura/window.py) (Main window), [`anura/controllers/ocr_controller.py`](https://github.com/d3m-sudo/anura/blob/development/anura/controllers/ocr_controller.py) (OCR controller), [`anura/services/screenshot_service.py`](https://github.com/d3m-sudo/anura/blob/development/anura/services/screenshot_service.py) (Capture and OCR), [`anura/services/language_manager.py`](https://github.com/d3m-sudo/anura/blob/development/anura/services/language_manager.py) (Language manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and UI"]
  node_main["Application<br/>[main.py]"]
  node_window["Main window<br/>[window.py]"]
  node_welcome["Welcome page<br/>[welcome_page.py]"]
  node_editor["Extracted editor<br/>[extracted_page.py]"]
  node_history_ui["History page<br/>[history_page.py]"]
  node_preferences["Preferences UI"]
  node_shortcuts["Shortcut overlay"]
end

subgraph group_capture["Capture and extraction"]
  node_ocr_controller["OCR controller<br/>[ocr_controller.py]"]
  node_dnd_controller["Drop controller<br/>[dnd_controller.py]"]
  node_screenshot["Capture and OCR"]
  node_barcode["Barcode detection"]
end

subgraph group_services["Core services"]
  node_language["Language manager"]
  node_download["Model downloads"]
  node_cache["Model cache<br/>[cache_manager.py]"]
  node_validator["Language validation<br/>[validator.py]"]
  node_settings["Settings<br/>[settings.py]"]
  node_tasks["Task manager"]
end

subgraph group_features["User features"]
  node_clipboard["Clipboard"]
  node_dispatcher["Result dispatcher"]
  node_history[("Local history<br/>[history_service.py]")]
  node_tts_controller["Speech controller<br/>[tts_controller.py]"]
  node_tts["Speech service<br/>[service.py]"]
  node_tts_pipeline["Speech pipeline"]
  node_sharing["Share service<br/>[share_service.py]"]
end

subgraph group_domain["Models and processing"]
  node_transformer["Smart parsing<br/>[magic_processor.py]"]
  node_ocr_model["OCR result model<br/>[ocr.py]"]
end

node_user(("Desktop user"))
node_portal{{"Desktop screenshot portal"}}

node_user -.->|"provides image"| node_welcome
node_user -.->|"requests capture"| node_window
node_window -->|"coordinates"| node_ocr_controller
node_window -->|"coordinates"| node_dnd_controller
node_ocr_controller -->|"handles capture signals"| node_screenshot
node_screenshot -.->|"captures screen"| node_portal
node_screenshot -->|"detects codes"| node_barcode
node_screenshot -->|"dispatches work"| node_tasks
node_screenshot -->|"uses OCR models"| node_language
node_screenshot -->|"parses text"| node_transformer
node_ocr_controller -->|"dispatches result"| node_dispatcher
node_ocr_controller -->|"records extraction"| node_history
node_ocr_controller -->|"handles OCR result"| node_ocr_model
node_dispatcher -->|"uses result model"| node_ocr_model
node_window -->|"uses clipboard"| node_clipboard
node_main -.->|"creates window"| node_window
node_main -->|"wires result signals"| node_ocr_controller
node_ocr_controller -.->|"presents extraction"| node_editor
node_user -.->|"edits result"| node_editor
node_window -.->|"offers history"| node_history_ui
node_window -.->|"offers preferences"| node_preferences
node_window -.->|"offers shortcuts"| node_shortcuts
node_language -->|"delegates downloads"| node_download
node_language -->|"uses model cache"| node_cache
node_language -->|"validates language"| node_validator
node_window -->|"uses settings"| node_settings
node_tts_controller -.->|"uses speech service"| node_tts
node_tts -->|"runs pipeline"| node_tts_pipeline
node_tts_pipeline -->|"reads settings"| node_settings
node_editor -->|"shares text"| node_sharing

click node_main "https://github.com/d3m-sudo/anura/blob/development/anura/main.py"
click node_window "https://github.com/d3m-sudo/anura/blob/development/anura/window.py"
click node_welcome "https://github.com/d3m-sudo/anura/blob/development/anura/widgets/welcome_page.py"
click node_editor "https://github.com/d3m-sudo/anura/blob/development/anura/widgets/extracted_page.py"
click node_history_ui "https://github.com/d3m-sudo/anura/blob/development/anura/widgets/history_page.py"
click node_preferences "https://github.com/d3m-sudo/anura/blob/development/anura/widgets/preferences_dialog.py"
click node_shortcuts "https://github.com/d3m-sudo/anura/blob/development/anura/widgets/shortcuts_overlay.py"
click node_ocr_controller "https://github.com/d3m-sudo/anura/blob/development/anura/controllers/ocr_controller.py"
click node_dnd_controller "https://github.com/d3m-sudo/anura/blob/development/anura/controllers/dnd_controller.py"
click node_screenshot "https://github.com/d3m-sudo/anura/blob/development/anura/services/screenshot_service.py"
click node_barcode "https://github.com/d3m-sudo/anura/blob/development/anura/utils/barcode_detector.py"
click node_language "https://github.com/d3m-sudo/anura/blob/development/anura/services/language_manager.py"
click node_download "https://github.com/d3m-sudo/anura/blob/development/anura/services/language/download_manager.py"
click node_cache "https://github.com/d3m-sudo/anura/blob/development/anura/services/language/cache_manager.py"
click node_validator "https://github.com/d3m-sudo/anura/blob/development/anura/services/language/validator.py"
click node_settings "https://github.com/d3m-sudo/anura/blob/development/anura/services/settings.py"
click node_tasks "https://github.com/d3m-sudo/anura/blob/development/anura/core/atomic_task_manager.py"
click node_clipboard "https://github.com/d3m-sudo/anura/blob/development/anura/services/clipboard_service.py"
click node_dispatcher "https://github.com/d3m-sudo/anura/blob/development/anura/services/result_dispatcher.py"
click node_history "https://github.com/d3m-sudo/anura/blob/development/anura/services/history_service.py"
click node_tts_controller "https://github.com/d3m-sudo/anura/blob/development/anura/controllers/tts_controller.py"
click node_tts "https://github.com/d3m-sudo/anura/blob/development/anura/services/tts/service.py"
click node_tts_pipeline "https://github.com/d3m-sudo/anura/blob/development/anura/services/tts/pipeline_manager.py"
click node_sharing "https://github.com/d3m-sudo/anura/blob/development/anura/services/share_service.py"
click node_transformer "https://github.com/d3m-sudo/anura/blob/development/anura/transformers/magic_processor.py"
click node_ocr_model "https://github.com/d3m-sudo/anura/blob/development/anura/models/ocr.py"

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_main,node_window,node_welcome,node_editor,node_history_ui,node_preferences,node_shortcuts,node_user,node_portal toneBlue
class node_ocr_controller,node_dnd_controller,node_screenshot,node_barcode toneAmber
class node_language,node_download,node_cache,node_validator,node_settings,node_tasks toneMint
class node_clipboard,node_dispatcher,node_history,node_tts_controller,node_tts,node_tts_pipeline,node_sharing toneRose
class node_transformer,node_ocr_model toneIndigo
```

## Components

### App and UI

- [Application](https://github.com/d3m-sudo/anura/blob/development/anura/main.py): `anura/main.py`
- [Main window](https://github.com/d3m-sudo/anura/blob/development/anura/window.py): `anura/window.py`
- [Welcome page](https://github.com/d3m-sudo/anura/blob/development/anura/widgets/welcome_page.py): `anura/widgets/welcome_page.py`
- [Extracted editor](https://github.com/d3m-sudo/anura/blob/development/anura/widgets/extracted_page.py): `anura/widgets/extracted_page.py`
- [History page](https://github.com/d3m-sudo/anura/blob/development/anura/widgets/history_page.py): `anura/widgets/history_page.py`
- [Preferences UI](https://github.com/d3m-sudo/anura/blob/development/anura/widgets/preferences_dialog.py): `anura/widgets/preferences_dialog.py`
- [Shortcut overlay](https://github.com/d3m-sudo/anura/blob/development/anura/widgets/shortcuts_overlay.py): `anura/widgets/shortcuts_overlay.py`

### Capture and extraction

- [OCR controller](https://github.com/d3m-sudo/anura/blob/development/anura/controllers/ocr_controller.py): `anura/controllers/ocr_controller.py`
- [Drop controller](https://github.com/d3m-sudo/anura/blob/development/anura/controllers/dnd_controller.py): `anura/controllers/dnd_controller.py`
- [Capture and OCR](https://github.com/d3m-sudo/anura/blob/development/anura/services/screenshot_service.py): `anura/services/screenshot_service.py`
- [Barcode detection](https://github.com/d3m-sudo/anura/blob/development/anura/utils/barcode_detector.py): `anura/utils/barcode_detector.py`

### Core services

- [Language manager](https://github.com/d3m-sudo/anura/blob/development/anura/services/language_manager.py): `anura/services/language_manager.py`
- [Model downloads](https://github.com/d3m-sudo/anura/blob/development/anura/services/language/download_manager.py): `anura/services/language/download_manager.py`
- [Model cache](https://github.com/d3m-sudo/anura/blob/development/anura/services/language/cache_manager.py): `anura/services/language/cache_manager.py`
- [Language validation](https://github.com/d3m-sudo/anura/blob/development/anura/services/language/validator.py): `anura/services/language/validator.py`
- [Settings](https://github.com/d3m-sudo/anura/blob/development/anura/services/settings.py): `anura/services/settings.py`
- [Task manager](https://github.com/d3m-sudo/anura/blob/development/anura/core/atomic_task_manager.py): `anura/core/atomic_task_manager.py`

### User features

- [Clipboard](https://github.com/d3m-sudo/anura/blob/development/anura/services/clipboard_service.py): `anura/services/clipboard_service.py`
- [Result dispatcher](https://github.com/d3m-sudo/anura/blob/development/anura/services/result_dispatcher.py): `anura/services/result_dispatcher.py`
- [Local history](https://github.com/d3m-sudo/anura/blob/development/anura/services/history_service.py): `anura/services/history_service.py`
- [Speech controller](https://github.com/d3m-sudo/anura/blob/development/anura/controllers/tts_controller.py): `anura/controllers/tts_controller.py`
- [Speech service](https://github.com/d3m-sudo/anura/blob/development/anura/services/tts/service.py): `anura/services/tts/service.py`
- [Speech pipeline](https://github.com/d3m-sudo/anura/blob/development/anura/services/tts/pipeline_manager.py): `anura/services/tts/pipeline_manager.py`
- [Share service](https://github.com/d3m-sudo/anura/blob/development/anura/services/share_service.py): `anura/services/share_service.py`

### Models and processing

- [Smart parsing](https://github.com/d3m-sudo/anura/blob/development/anura/transformers/magic_processor.py): `anura/transformers/magic_processor.py`
- [OCR result model](https://github.com/d3m-sudo/anura/blob/development/anura/models/ocr.py): `anura/models/ocr.py`

### Other components

- **Desktop user**
- **Desktop screenshot portal**

## Connections

- Desktop user → Welcome page: provides image
- Desktop user → Main window: requests capture
- Main window → OCR controller: coordinates (evidence: `anura/window.py`)
- Main window → Drop controller: coordinates (evidence: `anura/window.py`)
- OCR controller → Capture and OCR: handles capture signals (evidence: `anura/controllers/ocr_controller.py`)
- Capture and OCR → Desktop screenshot portal: captures screen
- Capture and OCR → Barcode detection: detects codes (evidence: `anura/services/screenshot_service.py`)
- Capture and OCR → Task manager: dispatches work (evidence: `anura/services/screenshot_service.py`)
- Capture and OCR → Language manager: uses OCR models (evidence: `anura/services/screenshot_service.py`)
- Capture and OCR → Smart parsing: parses text (evidence: `anura/services/screenshot_service.py`)
- OCR controller → Result dispatcher: dispatches result (evidence: `anura/controllers/ocr_controller.py`)
- OCR controller → Local history: records extraction (evidence: `anura/controllers/ocr_controller.py`)
- OCR controller → OCR result model: handles OCR result (evidence: `anura/controllers/ocr_controller.py`)
- Result dispatcher → OCR result model: uses result model (evidence: `anura/services/result_dispatcher.py`)
- Main window → Clipboard: uses clipboard (evidence: `anura/window.py`)
- Application → Main window: creates window (evidence: `anura/main.py`)
- Application → OCR controller: wires result signals (evidence: `anura/main.py`)
- OCR controller → Extracted editor: presents extraction
- Desktop user → Extracted editor: edits result
- Main window → History page: offers history (evidence: `anura/window.py`)
- Main window → Preferences UI: offers preferences (evidence: `anura/window.py`)
- Main window → Shortcut overlay: offers shortcuts (evidence: `anura/window.py`)
- Language manager → Model downloads: delegates downloads (evidence: `anura/services/language_manager.py`)
- Language manager → Model cache: uses model cache (evidence: `anura/services/language_manager.py`)
- Language manager → Language validation: validates language (evidence: `anura/services/language_manager.py`)
- Main window → Settings: uses settings (evidence: `anura/window.py`)
- Speech controller → Speech service: uses speech service (evidence: `anura/controllers/tts_controller.py`)
- Speech service → Speech pipeline: runs pipeline (evidence: `anura/services/tts/service.py`)
- Speech pipeline → Settings: reads settings (evidence: `anura/services/tts/pipeline_manager.py`)
- Extracted editor → Share service: shares text (evidence: `anura/widgets/extracted_page.py`)
