# dhiraj455/ai-meeting-recorder architecture

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

- Interactive diagram: https://gitdiagram.com/dhiraj455/ai-meeting-recorder
- Repository: https://github.com/dhiraj455/ai-meeting-recorder

## Overview

TwinMind2 is an Android meeting recorder that captures sessions, transcribes audio chunks with Gemini, and produces meeting summaries and action items. The documented primary flow runs from user controls through the recording service and local session data to transcription and summary views. The README also documents retry/progress handling and session organization. Source excerpts were not provided for the app modules, so edges below rely on README statements; additional tree-visible chat, wake-word, and screen modules are shown without speculative connections.

Main entry points: [`app/src/main/java/com/example/twinmind2/recording/RecordingService.kt`](https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/recording/RecordingService.kt) (Audio recording), [`app/src/main/java/com/example/twinmind2/transcription/TranscriptionRepository.kt`](https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/transcription/TranscriptionRepository.kt) (Transcription), [`app/src/main/java/com/example/twinmind2/summary/SummaryRepository.kt`](https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/summary/SummaryRepository.kt) (Summary generation), [`app/src/main/java/com/example/twinmind2/recording/RecordingRepository.kt`](https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/recording/RecordingRepository.kt) (Recording data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_capture["Recording"]
  node_recordingvm["Recording state"]
  node_service["Audio recording"]
  node_recovery["Recording recovery"]
  node_wakeword["Wake-word service<br/>[WakeWordService.kt]"]
end

subgraph group_processing["AI processing"]
  node_transrepo["Transcription"]
  node_transapi["Gemini API client"]
  node_summaryrepo["Summary generation"]
  node_summaryworker["Summary worker<br/>[SummaryWorker.kt]"]
end

subgraph group_storage["Session data"]
  node_recordrepo["Recording data"]
  node_database[("Room database<br/>[AppDatabase.kt]")]
  node_transcriptdata["Transcript records<br/>[TranscriptDao.kt]"]
  node_summarydata["Summary records<br/>[SummaryDao.kt]"]
  node_chatrepo["Chat data<br/>[ChatRepository.kt]"]
end

subgraph group_experience["User experience"]
  node_activity["App controls<br/>[MainActivity.kt]"]
  node_recordingsui["Session views"]
  node_transcriptui["Transcript view"]
  node_summaryui["Summary view<br/>[SummaryScreen.kt]"]
  node_detailui["Recording detail"]
  node_chat["Session chat<br/>[ChatViewModel.kt]"]
end

node_user(("Meeting user"))
node_gemini["Google Gemini"]

node_user -->|"controls"| node_activity
node_activity -->|"manages state"| node_recordingvm
node_recordingvm -->|"controls recording"| node_service
node_service -->|"stores sessions"| node_recordrepo
node_recordrepo -.->|"persists data"| node_database
node_service -->|"transcribes chunks"| node_transrepo
node_transrepo -.->|"sends audio"| node_transapi
node_transapi -->|"requests transcription"| node_gemini
node_transrepo -.->|"saves transcripts"| node_transcriptdata
node_recordrepo -.->|"tracks session status"| node_summaryworker
node_summaryworker -.->|"generates summary"| node_summaryrepo
node_summaryrepo -->|"requests summary"| node_gemini
node_summaryrepo -.->|"stores summaries"| node_summarydata
node_activity -->|"shows sessions"| node_recordingsui
node_recordingsui -->|"opens session"| node_detailui
node_detailui -->|"opens transcript"| node_transcriptui
node_detailui -->|"opens summary"| node_summaryui

click node_activity "https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/MainActivity.kt"
click node_recordingvm "https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/recording/RecordingViewModel.kt"
click node_service "https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/recording/RecordingService.kt"
click node_recovery "https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/recording/RecordingRecoveryWorker.kt"
click node_recordrepo "https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/recording/RecordingRepository.kt"
click node_database "https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/data/AppDatabase.kt"
click node_transrepo "https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/transcription/TranscriptionRepository.kt"
click node_transapi "https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/transcription/TranscriptionApi.kt"
click node_transcriptdata "https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/data/dao/TranscriptDao.kt"
click node_summaryrepo "https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/summary/SummaryRepository.kt"
click node_summaryworker "https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/summary/SummaryWorker.kt"
click node_summarydata "https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/data/dao/SummaryDao.kt"
click node_recordingsui "https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/ui/components/RecordingsSection.kt"
click node_transcriptui "https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/ui/screens/TranscriptScreen.kt"
click node_summaryui "https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/ui/screens/SummaryScreen.kt"
click node_detailui "https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/ui/screens/RecordingDetailScreen.kt"
click node_chat "https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/chat/ChatViewModel.kt"
click node_chatrepo "https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/chat/ChatRepository.kt"
click node_wakeword "https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/wakeword/WakeWordService.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_recordingvm,node_service,node_recovery,node_wakeword,node_user toneBlue
class node_transrepo,node_transapi,node_summaryrepo,node_summaryworker toneAmber
class node_recordrepo,node_database,node_transcriptdata,node_summarydata,node_chatrepo toneMint
class node_activity,node_recordingsui,node_transcriptui,node_summaryui,node_detailui,node_chat toneRose
class node_gemini toneIndigo
```

## Components

### Recording

- [Recording state](https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/recording/RecordingViewModel.kt): `app/src/main/java/com/example/twinmind2/recording/RecordingViewModel.kt`
- [Audio recording](https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/recording/RecordingService.kt): `app/src/main/java/com/example/twinmind2/recording/RecordingService.kt`
- [Recording recovery](https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/recording/RecordingRecoveryWorker.kt): `app/src/main/java/com/example/twinmind2/recording/RecordingRecoveryWorker.kt`
- [Wake-word service](https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/wakeword/WakeWordService.kt): `app/src/main/java/com/example/twinmind2/wakeword/WakeWordService.kt`

### AI processing

- [Transcription](https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/transcription/TranscriptionRepository.kt): `app/src/main/java/com/example/twinmind2/transcription/TranscriptionRepository.kt`
- [Gemini API client](https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/transcription/TranscriptionApi.kt): `app/src/main/java/com/example/twinmind2/transcription/TranscriptionApi.kt`
- [Summary generation](https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/summary/SummaryRepository.kt): `app/src/main/java/com/example/twinmind2/summary/SummaryRepository.kt`
- [Summary worker](https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/summary/SummaryWorker.kt): `app/src/main/java/com/example/twinmind2/summary/SummaryWorker.kt`

### Session data

- [Recording data](https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/recording/RecordingRepository.kt): `app/src/main/java/com/example/twinmind2/recording/RecordingRepository.kt`
- [Room database](https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/data/AppDatabase.kt): `app/src/main/java/com/example/twinmind2/data/AppDatabase.kt`
- [Transcript records](https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/data/dao/TranscriptDao.kt): `app/src/main/java/com/example/twinmind2/data/dao/TranscriptDao.kt`
- [Summary records](https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/data/dao/SummaryDao.kt): `app/src/main/java/com/example/twinmind2/data/dao/SummaryDao.kt`
- [Chat data](https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/chat/ChatRepository.kt): `app/src/main/java/com/example/twinmind2/chat/ChatRepository.kt`

### User experience

- [App controls](https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/MainActivity.kt): `app/src/main/java/com/example/twinmind2/MainActivity.kt`
- [Session views](https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/ui/components/RecordingsSection.kt): `app/src/main/java/com/example/twinmind2/ui/components/RecordingsSection.kt`
- [Transcript view](https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/ui/screens/TranscriptScreen.kt): `app/src/main/java/com/example/twinmind2/ui/screens/TranscriptScreen.kt`
- [Summary view](https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/ui/screens/SummaryScreen.kt): `app/src/main/java/com/example/twinmind2/ui/screens/SummaryScreen.kt`
- [Recording detail](https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/ui/screens/RecordingDetailScreen.kt): `app/src/main/java/com/example/twinmind2/ui/screens/RecordingDetailScreen.kt`
- [Session chat](https://github.com/dhiraj455/ai-meeting-recorder/blob/master/app/src/main/java/com/example/twinmind2/chat/ChatViewModel.kt): `app/src/main/java/com/example/twinmind2/chat/ChatViewModel.kt`

### Other components

- **Meeting user**
- **Google Gemini**

## Connections

- Meeting user → App controls: controls (evidence: `README.md`)
- App controls → Recording state: manages state (evidence: `README.md`)
- Recording state → Audio recording: controls recording (evidence: `README.md`)
- Audio recording → Recording data: stores sessions (evidence: `README.md`)
- Recording data → Room database: persists data
- Audio recording → Transcription: transcribes chunks (evidence: `README.md`)
- Transcription → Gemini API client: sends audio
- Gemini API client → Google Gemini: requests transcription (evidence: `README.md`)
- Transcription → Transcript records: saves transcripts
- Recording data → Summary worker: tracks session status
- Summary worker → Summary generation: generates summary
- Summary generation → Google Gemini: requests summary (evidence: `README.md`)
- Summary generation → Summary records: stores summaries
- App controls → Session views: shows sessions (evidence: `README.md`)
- Session views → Recording detail: opens session (evidence: `README.md`)
- Recording detail → Transcript view: opens transcript (evidence: `README.md`)
- Recording detail → Summary view: opens summary (evidence: `README.md`)
