# roflsockie/ogi-tts-android architecture

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

- Interactive diagram: https://gitdiagram.com/roflsockie/ogi-tts-android
- Repository: https://github.com/roflsockie/ogi-tts-android

## Overview

OGI TTS is an Android text-to-speech app. The documented workflow is to enter or import text, detect its language, filter and select a suitable voice, preview speech, then export and manage or share saved audio. The README also describes gender indicators, readiness/status information, and a Material3 interface. Source excerpts do not include the app implementation, so component paths identify the available MainActivity entry point; edges reflect documented behavior rather than inspected calls.

Main entry points: [`app/src/main/java/com/example/ogitts/MainActivity.kt`](https://github.com/roflsockie/ogi-tts-android/blob/main/app/src/main/java/com/example/ogitts/MainActivity.kt) (App interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_text_voice["Text and voice"]
  node_main_activity["App interface<br/>[MainActivity.kt]"]
  node_text_input["Text and import<br/>[MainActivity.kt]"]
  node_language_detection["Language detection<br/>[MainActivity.kt]"]
  node_voice_filter["Voice filtering<br/>[MainActivity.kt]"]
  node_voice_selection["Voice selection<br/>[MainActivity.kt]"]
end

subgraph group_speech["Speech output"]
  node_tts["Android TTS"]
  node_playback["Speech preview<br/>[MainActivity.kt]"]
end

subgraph group_audio_files["Audio files"]
  node_audio_export["Audio export<br/>[MainActivity.kt]"]
  node_saved_audio["Saved audio<br/>[MainActivity.kt]"]
  node_sharing["Audio sharing<br/>[MainActivity.kt]"]
end

node_user(("User"))
node_other_apps(("Other apps"))

node_user -->|"uses"| node_main_activity
node_main_activity -->|"accepts text"| node_text_input
node_text_input -->|"analyzes text"| node_language_detection
node_language_detection -->|"filters voices"| node_voice_filter
node_voice_filter -->|"selects voice"| node_voice_selection
node_voice_selection -->|"speaks with"| node_tts
node_main_activity -->|"previews speech"| node_playback
node_playback -->|"uses"| node_tts
node_main_activity -->|"exports audio"| node_audio_export
node_audio_export -->|"saves audio"| node_saved_audio
node_main_activity -->|"manages files"| node_saved_audio
node_saved_audio -->|"shares audio"| node_sharing
node_sharing -->|"shares with"| node_other_apps

click node_main_activity "https://github.com/roflsockie/ogi-tts-android/blob/main/app/src/main/java/com/example/ogitts/MainActivity.kt"
click node_text_input "https://github.com/roflsockie/ogi-tts-android/blob/main/app/src/main/java/com/example/ogitts/MainActivity.kt"
click node_language_detection "https://github.com/roflsockie/ogi-tts-android/blob/main/app/src/main/java/com/example/ogitts/MainActivity.kt"
click node_voice_filter "https://github.com/roflsockie/ogi-tts-android/blob/main/app/src/main/java/com/example/ogitts/MainActivity.kt"
click node_voice_selection "https://github.com/roflsockie/ogi-tts-android/blob/main/app/src/main/java/com/example/ogitts/MainActivity.kt"
click node_playback "https://github.com/roflsockie/ogi-tts-android/blob/main/app/src/main/java/com/example/ogitts/MainActivity.kt"
click node_audio_export "https://github.com/roflsockie/ogi-tts-android/blob/main/app/src/main/java/com/example/ogitts/MainActivity.kt"
click node_saved_audio "https://github.com/roflsockie/ogi-tts-android/blob/main/app/src/main/java/com/example/ogitts/MainActivity.kt"
click node_sharing "https://github.com/roflsockie/ogi-tts-android/blob/main/app/src/main/java/com/example/ogitts/MainActivity.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_main_activity,node_text_input,node_language_detection,node_voice_filter,node_voice_selection,node_user toneBlue
class node_tts,node_playback toneAmber
class node_audio_export,node_saved_audio,node_sharing toneMint
class node_other_apps toneIndigo
```

## Components

### Text and voice

- [App interface](https://github.com/roflsockie/ogi-tts-android/blob/main/app/src/main/java/com/example/ogitts/MainActivity.kt): `app/src/main/java/com/example/ogitts/MainActivity.kt`
- [Text and import](https://github.com/roflsockie/ogi-tts-android/blob/main/app/src/main/java/com/example/ogitts/MainActivity.kt): `app/src/main/java/com/example/ogitts/MainActivity.kt`
- [Language detection](https://github.com/roflsockie/ogi-tts-android/blob/main/app/src/main/java/com/example/ogitts/MainActivity.kt): `app/src/main/java/com/example/ogitts/MainActivity.kt`
- [Voice filtering](https://github.com/roflsockie/ogi-tts-android/blob/main/app/src/main/java/com/example/ogitts/MainActivity.kt): `app/src/main/java/com/example/ogitts/MainActivity.kt`
- [Voice selection](https://github.com/roflsockie/ogi-tts-android/blob/main/app/src/main/java/com/example/ogitts/MainActivity.kt): `app/src/main/java/com/example/ogitts/MainActivity.kt`

### Speech output

- **Android TTS**
- [Speech preview](https://github.com/roflsockie/ogi-tts-android/blob/main/app/src/main/java/com/example/ogitts/MainActivity.kt): `app/src/main/java/com/example/ogitts/MainActivity.kt`

### Audio files

- [Audio export](https://github.com/roflsockie/ogi-tts-android/blob/main/app/src/main/java/com/example/ogitts/MainActivity.kt): `app/src/main/java/com/example/ogitts/MainActivity.kt`
- [Saved audio](https://github.com/roflsockie/ogi-tts-android/blob/main/app/src/main/java/com/example/ogitts/MainActivity.kt): `app/src/main/java/com/example/ogitts/MainActivity.kt`
- [Audio sharing](https://github.com/roflsockie/ogi-tts-android/blob/main/app/src/main/java/com/example/ogitts/MainActivity.kt): `app/src/main/java/com/example/ogitts/MainActivity.kt`

### Other components

- **User**
- **Other apps**

## Connections

- User → App interface: uses (evidence: `README.md`)
- App interface → Text and import: accepts text (evidence: `README.md`)
- Text and import → Language detection: analyzes text (evidence: `README.md`)
- Language detection → Voice filtering: filters voices (evidence: `README.md`)
- Voice filtering → Voice selection: selects voice (evidence: `README.md`)
- Voice selection → Android TTS: speaks with (evidence: `README.md`)
- App interface → Speech preview: previews speech (evidence: `README.md`)
- Speech preview → Android TTS: uses (evidence: `README.md`)
- App interface → Audio export: exports audio (evidence: `README.md`)
- Audio export → Saved audio: saves audio (evidence: `README.md`)
- App interface → Saved audio: manages files (evidence: `README.md`)
- Saved audio → Audio sharing: shares audio (evidence: `README.md`)
- Audio sharing → Other apps: shares with (evidence: `README.md`)
