# moh-salih/livetextify-repo architecture

> Architecture diagram of the GitHub repository moh-salih/livetextify-repo, 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/moh-salih/livetextify-repo
- Repository: https://github.com/moh-salih/livetextify-repo

## Overview

LiveTextify is a Qt/QML desktop-and-Android application for live audio transcription, with local Whisper transcription and a separate Llama text-generation capability. The primary workflow starts in the UI, captures audio, processes it through the transcriber and Whisper engine, and exposes results back to the UI. Model management supports configuring, downloading, selecting, and deleting model files. The source excerpts show application wiring and engine behavior; internal transcriber processing and several UI/model-manager details were not excerpted, so uncertain links are omitted or dashed.

Main entry points: [`src/main.cpp`](https://github.com/moh-salih/livetextify-repo/blob/main/src/main.cpp) (Application wiring), [`qml`](https://github.com/moh-salih/livetextify-repo/tree/main/qml) (QML interface), [`src/livetextify/transcription/transcriber.cpp`](https://github.com/moh-salih/livetextify-repo/blob/main/src/livetextify/transcription/transcriber.cpp) (Transcriber), [`src/livetextify/modelmanagers/basemodelmanager.cpp`](https://github.com/moh-salih/livetextify-repo/blob/main/src/livetextify/modelmanagers/basemodelmanager.cpp) (Model manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_qml["QML interface"]
  node_entry["Application wiring<br/>[main.cpp]"]
  node_android["Android bridge<br/>[androidbridge.cpp]"]
end

subgraph group_audio["Audio transcription"]
  node_recorder["Audio recorder<br/>[audiorecorder.cpp]"]
  node_window["Window processor"]
  node_transcriber["Transcriber<br/>[transcriber.cpp]"]
  node_settings["Transcription settings"]
  node_whisper["Whisper engine"]
end

subgraph group_models["Model management"]
  node_whispermanager["Whisper models"]
  node_llamamanager["Llama models"]
  node_managerbase["Model manager"]
  node_modelview["Model list view"]
  node_downloader["File downloader<br/>[filedownloader.cpp]"]
end

subgraph group_llm["Text generation"]
  node_llmcontroller["LLM controller<br/>[llmcontroller.cpp]"]
  node_llama["Llama engine<br/>[llamaengine.cpp]"]
end

node_user(("User"))
node_filesystem[("Local model files")]

node_user -.->|"uses"| node_qml
node_qml -.->|"controls"| node_recorder
node_qml -.->|"manages models"| node_whispermanager
node_qml -.->|"manages models"| node_llamamanager
node_qml -.->|"requests generation"| node_llmcontroller
node_entry -->|"loads"| node_qml
node_entry -->|"initializes"| node_android
node_entry -->|"creates"| node_recorder
node_entry -->|"creates"| node_transcriber
node_entry -->|"sets engine"| node_whisper
node_entry -->|"creates"| node_llmcontroller
node_entry -->|"sets engine"| node_llama
node_entry -->|"creates"| node_whispermanager
node_entry -->|"creates"| node_llamamanager
node_recorder -->|"sends audio"| node_transcriber
node_whispermanager -->|"sets model path"| node_transcriber
node_llamamanager -->|"sets model path"| node_llmcontroller
node_transcriber -.->|"processes windows"| node_window
node_transcriber -.->|"runs transcription"| node_whisper
node_transcriber -.->|"applies settings"| node_settings
node_whispermanager -->|"inherits"| node_managerbase
node_llamamanager -->|"inherits"| node_managerbase
node_managerbase -.->|"updates list"| node_modelview
node_managerbase -.->|"downloads via"| node_downloader
node_managerbase -.->|"stores models"| node_filesystem
node_llmcontroller -->|"dispatches generation"| node_llama

click node_qml "https://github.com/moh-salih/livetextify-repo/tree/main/qml"
click node_entry "https://github.com/moh-salih/livetextify-repo/blob/main/src/main.cpp"
click node_android "https://github.com/moh-salih/livetextify-repo/blob/main/src/livetextify/mobile/androidbridge.cpp"
click node_recorder "https://github.com/moh-salih/livetextify-repo/blob/main/src/livetextify/audio/audiorecorder.cpp"
click node_window "https://github.com/moh-salih/livetextify-repo/blob/main/src/livetextify/audio/audiowindowprocessor.cpp"
click node_transcriber "https://github.com/moh-salih/livetextify-repo/blob/main/src/livetextify/transcription/transcriber.cpp"
click node_settings "https://github.com/moh-salih/livetextify-repo/blob/main/src/livetextify/transcription/settings/transcriptionsettings.cpp"
click node_whisper "https://github.com/moh-salih/livetextify-repo/blob/main/src/livetextify/transcription/whisper/whispertranscriptionengine.cpp"
click node_whispermanager "https://github.com/moh-salih/livetextify-repo/blob/main/src/livetextify/modelmanagers/whispermodelmanager.cpp"
click node_llamamanager "https://github.com/moh-salih/livetextify-repo/blob/main/src/livetextify/modelmanagers/llamamodelmanager.cpp"
click node_managerbase "https://github.com/moh-salih/livetextify-repo/blob/main/src/livetextify/modelmanagers/basemodelmanager.cpp"
click node_modelview "https://github.com/moh-salih/livetextify-repo/blob/main/src/livetextify/modelviews/basemodelviewmodel.cpp"
click node_downloader "https://github.com/moh-salih/livetextify-repo/blob/main/src/livetextify/downloader/filedownloader.cpp"
click node_llmcontroller "https://github.com/moh-salih/livetextify-repo/blob/main/src/livetextify/llm/llmcontroller.cpp"
click node_llama "https://github.com/moh-salih/livetextify-repo/blob/main/src/livetextify/llm/llama/llamaengine.cpp"

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_qml,node_entry,node_android,node_user toneBlue
class node_recorder,node_window,node_transcriber,node_settings,node_whisper,node_filesystem toneAmber
class node_whispermanager,node_llamamanager,node_managerbase,node_modelview,node_downloader toneMint
class node_llmcontroller,node_llama toneRose
```

## Components

### Application

- [QML interface](https://github.com/moh-salih/livetextify-repo/tree/main/qml): `qml`
- [Application wiring](https://github.com/moh-salih/livetextify-repo/blob/main/src/main.cpp): `src/main.cpp`
- [Android bridge](https://github.com/moh-salih/livetextify-repo/blob/main/src/livetextify/mobile/androidbridge.cpp): `src/livetextify/mobile/androidbridge.cpp`

### Audio transcription

- [Audio recorder](https://github.com/moh-salih/livetextify-repo/blob/main/src/livetextify/audio/audiorecorder.cpp): `src/livetextify/audio/audiorecorder.cpp`
- [Window processor](https://github.com/moh-salih/livetextify-repo/blob/main/src/livetextify/audio/audiowindowprocessor.cpp): `src/livetextify/audio/audiowindowprocessor.cpp`
- [Transcriber](https://github.com/moh-salih/livetextify-repo/blob/main/src/livetextify/transcription/transcriber.cpp): `src/livetextify/transcription/transcriber.cpp`
- [Transcription settings](https://github.com/moh-salih/livetextify-repo/blob/main/src/livetextify/transcription/settings/transcriptionsettings.cpp): `src/livetextify/transcription/settings/transcriptionsettings.cpp`
- [Whisper engine](https://github.com/moh-salih/livetextify-repo/blob/main/src/livetextify/transcription/whisper/whispertranscriptionengine.cpp): `src/livetextify/transcription/whisper/whispertranscriptionengine.cpp`

### Model management

- [Whisper models](https://github.com/moh-salih/livetextify-repo/blob/main/src/livetextify/modelmanagers/whispermodelmanager.cpp): `src/livetextify/modelmanagers/whispermodelmanager.cpp`
- [Llama models](https://github.com/moh-salih/livetextify-repo/blob/main/src/livetextify/modelmanagers/llamamodelmanager.cpp): `src/livetextify/modelmanagers/llamamodelmanager.cpp`
- [Model manager](https://github.com/moh-salih/livetextify-repo/blob/main/src/livetextify/modelmanagers/basemodelmanager.cpp): `src/livetextify/modelmanagers/basemodelmanager.cpp`
- [Model list view](https://github.com/moh-salih/livetextify-repo/blob/main/src/livetextify/modelviews/basemodelviewmodel.cpp): `src/livetextify/modelviews/basemodelviewmodel.cpp`
- [File downloader](https://github.com/moh-salih/livetextify-repo/blob/main/src/livetextify/downloader/filedownloader.cpp): `src/livetextify/downloader/filedownloader.cpp`

### Text generation

- [LLM controller](https://github.com/moh-salih/livetextify-repo/blob/main/src/livetextify/llm/llmcontroller.cpp): `src/livetextify/llm/llmcontroller.cpp`
- [Llama engine](https://github.com/moh-salih/livetextify-repo/blob/main/src/livetextify/llm/llama/llamaengine.cpp): `src/livetextify/llm/llama/llamaengine.cpp`

### Other components

- **User**
- **Local model files**

## Connections

- User → QML interface: uses
- QML interface → Audio recorder: controls
- QML interface → Whisper models: manages models
- QML interface → Llama models: manages models
- QML interface → LLM controller: requests generation
- Application wiring → QML interface: loads (evidence: `src/main.cpp`)
- Application wiring → Android bridge: initializes (evidence: `src/main.cpp`)
- Application wiring → Audio recorder: creates (evidence: `src/main.cpp`)
- Application wiring → Transcriber: creates (evidence: `src/main.cpp`)
- Application wiring → Whisper engine: sets engine (evidence: `src/main.cpp`)
- Application wiring → LLM controller: creates (evidence: `src/main.cpp`)
- Application wiring → Llama engine: sets engine (evidence: `src/main.cpp`)
- Application wiring → Whisper models: creates (evidence: `src/main.cpp`)
- Application wiring → Llama models: creates (evidence: `src/main.cpp`)
- Audio recorder → Transcriber: sends audio
- Whisper models → Transcriber: sets model path
- Llama models → LLM controller: sets model path
- Transcriber → Window processor: processes windows
- Transcriber → Whisper engine: runs transcription
- Transcriber → Transcription settings: applies settings
- Whisper models → Model manager: inherits
- Llama models → Model manager: inherits
- Model manager → Model list view: updates list
- Model manager → File downloader: downloads via
- Model manager → Local model files: stores models
- LLM controller → Llama engine: dispatches generation (evidence: `src/livetextify/llm/llmcontroller.cpp`)
