# niedev/rtranslator architecture

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

- Interactive diagram: https://gitdiagram.com/niedev/rtranslator
- Repository: https://github.com/niedev/rtranslator

## Overview

RTranslator is an Android app for offline text and speech translation. Its main conversation workflow captures speech, recognizes it, sends recognized text to connected peers, translates incoming text, and speaks the translation; WalkieTalkie performs turn-based recognition and translation on one phone, while text translation provides a separate text-first mode. The README also documents model selection and downloads. The graph combines those documented capabilities with sampled service and download behavior; unsampled implementation details are represented only at supported directory paths.

Main entry points: [`app/src/main/java/nie/translator/rtranslator/voice_translation/_conversation_mode/_conversation/ConversationService.java`](https://github.com/niedev/rtranslator/blob/v3.00/app/src/main/java/nie/translator/rtranslator/voice_translation/_conversation_mode/_conversation/ConversationService.java) (Conversation service), [`app/src/main/java/nie/translator/rtranslator/voice_translation/_walkie_talkie_mode/_walkie_talkie/WalkieTalkieService.java`](https://github.com/niedev/rtranslator/blob/v3.00/app/src/main/java/nie/translator/rtranslator/voice_translation/_walkie_talkie_mode/_walkie_talkie/WalkieTalkieService.java) (WalkieTalkie service), [`app/src/main/java/nie/translator/rtranslator/voice_translation/VoiceTranslationActivity.java`](https://github.com/niedev/rtranslator/blob/v3.00/app/src/main/java/nie/translator/rtranslator/voice_translation/VoiceTranslationActivity.java) (Voice translation UI), [`app/src/main/java/nie/translator/rtranslator/downloader2/DownloadManager.java`](https://github.com/niedev/rtranslator/blob/v3.00/app/src/main/java/nie/translator/rtranslator/downloader2/DownloadManager.java) (Download manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["Translation modes"]
  node_voice_ui["Voice translation UI"]
  node_conversation_ui["Conversation UI"]
  node_walkie_ui["WalkieTalkie UI"]
  node_text_ui["Text translation UI"]
  node_conversation_service["Conversation service"]
  node_walkie_service["WalkieTalkie service"]
end

subgraph group_speech["Speech and translation"]
  node_voice_service["Voice service"]
  node_recognition["Speech recognition<br/>[Recognizer.java]"]
  node_translation["Translation engine"]
  node_tts["Speech output<br/>[TTSEngine.java]"]
end

subgraph group_network["Peer communication"]
  node_bluetooth["Bluetooth messaging"]
  node_bluetooth_core["Bluetooth transport"]
  node_recent_peers["Recent peers"]
end

subgraph group_resources["Models and resources"]
  node_model_settings["Model settings"]
  node_mozilla_settings["Mozilla models"]
  node_download_manager["Download manager"]
  node_download_service["Download service"]
end

subgraph group_state["Application state"]
  node_app_state["Global app state<br/>[Global.java]"]
  node_peer_database[("Peer database<br/>[AppDatabase.java]")]
end

node_user(("App user"))
node_peer_device(("Peer phone"))
node_external_download(("Model download source"))

node_user -->|"opens"| node_voice_ui
node_voice_ui -->|"selects mode"| node_conversation_ui
node_voice_ui -->|"selects mode"| node_walkie_ui
node_voice_ui -->|"selects mode"| node_text_ui
node_conversation_ui -->|"controls"| node_conversation_service
node_walkie_ui -->|"controls"| node_walkie_service
node_conversation_service -->|"recognizes speech"| node_recognition
node_conversation_service -->|"translates text"| node_translation
node_conversation_service -->|"sends and receives"| node_bluetooth
node_bluetooth -->|"uses transport"| node_bluetooth_core
node_bluetooth_core -->|"exchanges messages"| node_peer_device
node_peer_device -->|"sends messages"| node_bluetooth_core
node_conversation_service -->|"speaks translations"| node_tts
node_walkie_service -->|"recognizes speech"| node_recognition
node_walkie_service -->|"translates speech"| node_translation
node_walkie_service -->|"speaks translations"| node_tts
node_text_ui -->|"requests translation"| node_translation
node_voice_service -->|"initializes recorder"| node_recognition
node_voice_service -->|"hosts background work"| node_conversation_service
node_voice_service -->|"hosts background work"| node_walkie_service
node_conversation_service -->|"reads app configuration"| node_app_state
node_walkie_service -->|"gets translation models"| node_app_state
node_conversation_service -->|"updates peer history"| node_recent_peers
node_recent_peers -->|"persists peers"| node_peer_database
node_user -->|"chooses model"| node_model_settings
node_model_settings -->|"checks resources"| node_download_manager
node_user -->|"manages languages"| node_mozilla_settings
node_mozilla_settings -->|"tracks downloads"| node_download_manager
node_download_manager -->|"controls downloads"| node_download_service
node_download_service -.->|"fetches models"| node_external_download
node_download_manager -->|"provides model status"| node_app_state

click node_voice_ui "https://github.com/niedev/rtranslator/blob/v3.00/app/src/main/java/nie/translator/rtranslator/voice_translation/VoiceTranslationActivity.java"
click node_conversation_ui "https://github.com/niedev/rtranslator/blob/v3.00/app/src/main/java/nie/translator/rtranslator/voice_translation/_conversation_mode/_conversation/ConversationFragment.java"
click node_walkie_ui "https://github.com/niedev/rtranslator/blob/v3.00/app/src/main/java/nie/translator/rtranslator/voice_translation/_walkie_talkie_mode/_walkie_talkie/WalkieTalkieFragment.java"
click node_text_ui "https://github.com/niedev/rtranslator/blob/v3.00/app/src/main/java/nie/translator/rtranslator/voice_translation/_text_translation/TranslationFragment.java"
click node_conversation_service "https://github.com/niedev/rtranslator/blob/v3.00/app/src/main/java/nie/translator/rtranslator/voice_translation/_conversation_mode/_conversation/ConversationService.java"
click node_walkie_service "https://github.com/niedev/rtranslator/blob/v3.00/app/src/main/java/nie/translator/rtranslator/voice_translation/_walkie_talkie_mode/_walkie_talkie/WalkieTalkieService.java"
click node_voice_service "https://github.com/niedev/rtranslator/blob/v3.00/app/src/main/java/nie/translator/rtranslator/voice_translation/VoiceTranslationService.java"
click node_recognition "https://github.com/niedev/rtranslator/blob/v3.00/app/src/main/java/nie/translator/rtranslator/voice_translation/neural_networks/voice/Recognizer.java"
click node_translation "https://github.com/niedev/rtranslator/tree/v3.00/app/src/main/java/nie/translator/rtranslator/voice_translation/neural_networks"
click node_tts "https://github.com/niedev/rtranslator/blob/v3.00/app/src/main/java/nie/translator/rtranslator/voice_translation/TTSEngine.java"
click node_bluetooth "https://github.com/niedev/rtranslator/blob/v3.00/app/src/main/java/nie/translator/rtranslator/voice_translation/_conversation_mode/communication/ConversationBluetoothCommunicator.java"
click node_bluetooth_core "https://github.com/niedev/rtranslator/blob/v3.00/app/src/main/java/nie/translator/rtranslator/bluetooth/BluetoothCommunicator.java"
click node_recent_peers "https://github.com/niedev/rtranslator/blob/v3.00/app/src/main/java/nie/translator/rtranslator/voice_translation/_conversation_mode/communication/recent_peer/RecentPeersDataManager.java"
click node_model_settings "https://github.com/niedev/rtranslator/blob/v3.00/app/src/main/java/nie/translator/rtranslator/settings/ModelManagerFragment.java"
click node_mozilla_settings "https://github.com/niedev/rtranslator/blob/v3.00/app/src/main/java/nie/translator/rtranslator/settings/MozillaManagerFragment.java"
click node_download_manager "https://github.com/niedev/rtranslator/blob/v3.00/app/src/main/java/nie/translator/rtranslator/downloader2/DownloadManager.java"
click node_download_service "https://github.com/niedev/rtranslator/blob/v3.00/app/src/main/java/nie/translator/rtranslator/downloader2/DownloaderService.java"
click node_app_state "https://github.com/niedev/rtranslator/blob/v3.00/app/src/main/java/nie/translator/rtranslator/Global.java"
click node_peer_database "https://github.com/niedev/rtranslator/blob/v3.00/app/src/main/java/nie/translator/rtranslator/databases/general/AppDatabase.java"

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_voice_ui,node_conversation_ui,node_walkie_ui,node_text_ui,node_conversation_service,node_walkie_service,node_user toneBlue
class node_voice_service,node_recognition,node_translation,node_tts toneAmber
class node_bluetooth,node_bluetooth_core,node_recent_peers toneMint
class node_model_settings,node_mozilla_settings,node_download_manager,node_download_service toneRose
class node_app_state,node_peer_database,node_peer_device,node_external_download toneIndigo
```

## Components

### Translation modes

- [Voice translation UI](https://github.com/niedev/rtranslator/blob/v3.00/app/src/main/java/nie/translator/rtranslator/voice_translation/VoiceTranslationActivity.java): `app/src/main/java/nie/translator/rtranslator/voice_translation/VoiceTranslationActivity.java`
- [Conversation UI](https://github.com/niedev/rtranslator/blob/v3.00/app/src/main/java/nie/translator/rtranslator/voice_translation/_conversation_mode/_conversation/ConversationFragment.java): `app/src/main/java/nie/translator/rtranslator/voice_translation/_conversation_mode/_conversation/ConversationFragment.java`
- [WalkieTalkie UI](https://github.com/niedev/rtranslator/blob/v3.00/app/src/main/java/nie/translator/rtranslator/voice_translation/_walkie_talkie_mode/_walkie_talkie/WalkieTalkieFragment.java): `app/src/main/java/nie/translator/rtranslator/voice_translation/_walkie_talkie_mode/_walkie_talkie/WalkieTalkieFragment.java`
- [Text translation UI](https://github.com/niedev/rtranslator/blob/v3.00/app/src/main/java/nie/translator/rtranslator/voice_translation/_text_translation/TranslationFragment.java): `app/src/main/java/nie/translator/rtranslator/voice_translation/_text_translation/TranslationFragment.java`
- [Conversation service](https://github.com/niedev/rtranslator/blob/v3.00/app/src/main/java/nie/translator/rtranslator/voice_translation/_conversation_mode/_conversation/ConversationService.java): `app/src/main/java/nie/translator/rtranslator/voice_translation/_conversation_mode/_conversation/ConversationService.java`
- [WalkieTalkie service](https://github.com/niedev/rtranslator/blob/v3.00/app/src/main/java/nie/translator/rtranslator/voice_translation/_walkie_talkie_mode/_walkie_talkie/WalkieTalkieService.java): `app/src/main/java/nie/translator/rtranslator/voice_translation/_walkie_talkie_mode/_walkie_talkie/WalkieTalkieService.java`

### Speech and translation

- [Voice service](https://github.com/niedev/rtranslator/blob/v3.00/app/src/main/java/nie/translator/rtranslator/voice_translation/VoiceTranslationService.java): `app/src/main/java/nie/translator/rtranslator/voice_translation/VoiceTranslationService.java`
- [Speech recognition](https://github.com/niedev/rtranslator/blob/v3.00/app/src/main/java/nie/translator/rtranslator/voice_translation/neural_networks/voice/Recognizer.java): `app/src/main/java/nie/translator/rtranslator/voice_translation/neural_networks/voice/Recognizer.java`
- [Translation engine](https://github.com/niedev/rtranslator/tree/v3.00/app/src/main/java/nie/translator/rtranslator/voice_translation/neural_networks): `app/src/main/java/nie/translator/rtranslator/voice_translation/neural_networks`
- [Speech output](https://github.com/niedev/rtranslator/blob/v3.00/app/src/main/java/nie/translator/rtranslator/voice_translation/TTSEngine.java): `app/src/main/java/nie/translator/rtranslator/voice_translation/TTSEngine.java`

### Peer communication

- [Bluetooth messaging](https://github.com/niedev/rtranslator/blob/v3.00/app/src/main/java/nie/translator/rtranslator/voice_translation/_conversation_mode/communication/ConversationBluetoothCommunicator.java): `app/src/main/java/nie/translator/rtranslator/voice_translation/_conversation_mode/communication/ConversationBluetoothCommunicator.java`
- [Bluetooth transport](https://github.com/niedev/rtranslator/blob/v3.00/app/src/main/java/nie/translator/rtranslator/bluetooth/BluetoothCommunicator.java): `app/src/main/java/nie/translator/rtranslator/bluetooth/BluetoothCommunicator.java`
- [Recent peers](https://github.com/niedev/rtranslator/blob/v3.00/app/src/main/java/nie/translator/rtranslator/voice_translation/_conversation_mode/communication/recent_peer/RecentPeersDataManager.java): `app/src/main/java/nie/translator/rtranslator/voice_translation/_conversation_mode/communication/recent_peer/RecentPeersDataManager.java`

### Models and resources

- [Model settings](https://github.com/niedev/rtranslator/blob/v3.00/app/src/main/java/nie/translator/rtranslator/settings/ModelManagerFragment.java): `app/src/main/java/nie/translator/rtranslator/settings/ModelManagerFragment.java`
- [Mozilla models](https://github.com/niedev/rtranslator/blob/v3.00/app/src/main/java/nie/translator/rtranslator/settings/MozillaManagerFragment.java): `app/src/main/java/nie/translator/rtranslator/settings/MozillaManagerFragment.java`
- [Download manager](https://github.com/niedev/rtranslator/blob/v3.00/app/src/main/java/nie/translator/rtranslator/downloader2/DownloadManager.java): `app/src/main/java/nie/translator/rtranslator/downloader2/DownloadManager.java`
- [Download service](https://github.com/niedev/rtranslator/blob/v3.00/app/src/main/java/nie/translator/rtranslator/downloader2/DownloaderService.java): `app/src/main/java/nie/translator/rtranslator/downloader2/DownloaderService.java`

### Application state

- [Global app state](https://github.com/niedev/rtranslator/blob/v3.00/app/src/main/java/nie/translator/rtranslator/Global.java): `app/src/main/java/nie/translator/rtranslator/Global.java`
- [Peer database](https://github.com/niedev/rtranslator/blob/v3.00/app/src/main/java/nie/translator/rtranslator/databases/general/AppDatabase.java): `app/src/main/java/nie/translator/rtranslator/databases/general/AppDatabase.java`

### Other components

- **App user**
- **Peer phone**
- **Model download source**

## Connections

- App user → Voice translation UI: opens
- Voice translation UI → Conversation UI: selects mode
- Voice translation UI → WalkieTalkie UI: selects mode
- Voice translation UI → Text translation UI: selects mode
- Conversation UI → Conversation service: controls
- WalkieTalkie UI → WalkieTalkie service: controls
- Conversation service → Speech recognition: recognizes speech
- Conversation service → Translation engine: translates text
- Conversation service → Bluetooth messaging: sends and receives
- Bluetooth messaging → Bluetooth transport: uses transport
- Bluetooth transport → Peer phone: exchanges messages
- Peer phone → Bluetooth transport: sends messages
- Conversation service → Speech output: speaks translations
- WalkieTalkie service → Speech recognition: recognizes speech
- WalkieTalkie service → Translation engine: translates speech
- WalkieTalkie service → Speech output: speaks translations
- Text translation UI → Translation engine: requests translation
- Voice service → Speech recognition: initializes recorder
- Voice service → Conversation service: hosts background work
- Voice service → WalkieTalkie service: hosts background work
- Conversation service → Global app state: reads app configuration
- WalkieTalkie service → Global app state: gets translation models
- Conversation service → Recent peers: updates peer history
- Recent peers → Peer database: persists peers
- App user → Model settings: chooses model
- Model settings → Download manager: checks resources
- App user → Mozilla models: manages languages
- Mozilla models → Download manager: tracks downloads
- Download manager → Download service: controls downloads
- Download service → Model download source: fetches models
- Download manager → Global app state: provides model status
