# samgum/aegisub-android architecture

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

- Interactive diagram: https://gitdiagram.com/samgum/aegisub-android
- Repository: https://github.com/samgum/aegisub-android

## Overview

Aegisub Android is a mobile subtitle-editing application. The main workflow is to open or create a subtitle project, edit its script and styles, and use video/audio preview tools for timing and typesetting; project content, snapshots, bookmarks, and preferences are persisted separately. The graph includes documented format, editing, undo, karaoke, and media capabilities, but several implementation paths were not sampled, so their connections are omitted or marked unverified.

Main entry points: [`feature/editor/src/main/kotlin/io/github/samgum/aegisub/feature/editor/EditorScreen.kt`](https://github.com/samgum/aegisub-android/blob/main/feature/editor/src/main/kotlin/io/github/samgum/aegisub/feature/editor/EditorScreen.kt) (Subtitle editor), [`feature/preview/src/main/kotlin/io/github/samgum/aegisub/feature/preview/PreviewViewModel.kt`](https://github.com/samgum/aegisub-android/blob/main/feature/preview/src/main/kotlin/io/github/samgum/aegisub/feature/preview/PreviewViewModel.kt) (Preview state), [`core/data/src/main/kotlin/io/github/samgum/aegisub/data/repository/ProjectRepository.kt`](https://github.com/samgum/aegisub-android/blob/main/core/data/src/main/kotlin/io/github/samgum/aegisub/data/repository/ProjectRepository.kt) (Project repository), [`app/src/main/kotlin/io/github/samgum/aegisub/navigation/AppNavigation.kt`](https://github.com/samgum/aegisub-android/blob/main/app/src/main/kotlin/io/github/samgum/aegisub/navigation/AppNavigation.kt) (App navigation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_activity["App entry<br/>[MainActivity.kt]"]
  node_navigation["App navigation<br/>[AppNavigation.kt]"]
  node_home["Project home<br/>[HomeScreen.kt]"]
  node_settings["Preferences UI<br/>[SettingsScreen.kt]"]
  node_settingsvm["Preferences state"]
end

subgraph group_edit["Subtitle Editing"]
  node_editor["Subtitle editor<br/>[EditorScreen.kt]"]
  node_editorvm["Editing state<br/>[EditorViewModel.kt]"]
  node_styleeditor["Style editor"]
  node_format["Format codecs"]
  node_script["ASS script model<br/>[AssScript.kt]"]
  node_lineops["Line operations<br/>[LineOps.kt]"]
  node_undo["Undo engine<br/>[UndoStack.kt]"]
end

subgraph group_media["Preview and Timing"]
  node_preview["Media preview<br/>[PreviewScreen.kt]"]
  node_previewvm["Preview state"]
  node_player["Video player"]
  node_waveform["Waveform extraction"]
end

subgraph group_data["Project Data"]
  node_projectrepo["Project repository"]
  node_session["Shared project session"]
  node_database[("Subtitle database")]
  node_projectdao["Project records<br/>[ProjectDao.kt]"]
  node_snapshots["History snapshots"]
  node_bookmarks["Timing bookmarks"]
  node_settingsrepo[("Preference storage")]
end

node_user(("Subtitle editor"))

node_user -->|"opens"| node_activity
node_activity -->|"starts"| node_navigation
node_navigation -.->|"routes to"| node_home
node_navigation -.->|"routes to"| node_editor
node_navigation -.->|"routes to"| node_preview
node_home -.->|"manages projects"| node_projectrepo
node_settings -->|"reads state"| node_settingsvm
node_settingsvm -.->|"updates preferences"| node_settingsrepo
node_editor -->|"imports and exports"| node_format
node_editor -->|"edits script"| node_script
node_editor -.->|"dispatches edits"| node_editorvm
node_editor -.->|"opens styles"| node_styleeditor
node_editorvm -.->|"shares project state"| node_session
node_session -->|"loads project"| node_projectrepo
node_editor -.->|"uses operations"| node_lineops
node_editor -.->|"supports undo"| node_undo
node_preview -->|"dispatches controls"| node_previewvm
node_preview -->|"renders player"| node_player
node_preview -->|"renders audio views"| node_waveform
node_previewvm -->|"opens shared state"| node_session
node_previewvm -->|"reads media URI"| node_projectrepo
node_previewvm -->|"controls playback"| node_player
node_previewvm -->|"loads waveform"| node_waveform
node_previewvm -->|"records bookmarks"| node_bookmarks
node_projectrepo -->|"reads and writes"| node_projectdao
node_database -->|"provides DAO"| node_projectdao
node_projectrepo -.->|"persists project data"| node_database
node_snapshots -.->|"stores history"| node_database
node_bookmarks -.->|"stores bookmarks"| node_database
node_settingsrepo -.->|"persists preferences"| node_user

click node_activity "https://github.com/samgum/aegisub-android/blob/main/app/src/main/kotlin/io/github/samgum/aegisub/MainActivity.kt"
click node_navigation "https://github.com/samgum/aegisub-android/blob/main/app/src/main/kotlin/io/github/samgum/aegisub/navigation/AppNavigation.kt"
click node_home "https://github.com/samgum/aegisub-android/blob/main/app/src/main/kotlin/io/github/samgum/aegisub/ui/home/HomeScreen.kt"
click node_settings "https://github.com/samgum/aegisub-android/blob/main/app/src/main/kotlin/io/github/samgum/aegisub/ui/settings/SettingsScreen.kt"
click node_settingsvm "https://github.com/samgum/aegisub-android/blob/main/app/src/main/kotlin/io/github/samgum/aegisub/ui/settings/SettingsViewModel.kt"
click node_editor "https://github.com/samgum/aegisub-android/blob/main/feature/editor/src/main/kotlin/io/github/samgum/aegisub/feature/editor/EditorScreen.kt"
click node_editorvm "https://github.com/samgum/aegisub-android/blob/main/feature/editor/src/main/kotlin/io/github/samgum/aegisub/feature/editor/EditorViewModel.kt"
click node_styleeditor "https://github.com/samgum/aegisub-android/blob/main/feature/editor/src/main/kotlin/io/github/samgum/aegisub/feature/editor/styles/StyleEditorScreen.kt"
click node_format "https://github.com/samgum/aegisub-android/tree/main/core/domain/src/main/kotlin/io/github/samgum/aegisub/domain/format"
click node_script "https://github.com/samgum/aegisub-android/blob/main/core/domain/src/main/kotlin/io/github/samgum/aegisub/domain/model/AssScript.kt"
click node_lineops "https://github.com/samgum/aegisub-android/blob/main/core/domain/src/main/kotlin/io/github/samgum/aegisub/domain/edit/LineOps.kt"
click node_undo "https://github.com/samgum/aegisub-android/blob/main/core/domain/src/main/kotlin/io/github/samgum/aegisub/domain/undo/UndoStack.kt"
click node_preview "https://github.com/samgum/aegisub-android/blob/main/feature/preview/src/main/kotlin/io/github/samgum/aegisub/feature/preview/PreviewScreen.kt"
click node_previewvm "https://github.com/samgum/aegisub-android/blob/main/feature/preview/src/main/kotlin/io/github/samgum/aegisub/feature/preview/PreviewViewModel.kt"
click node_player "https://github.com/samgum/aegisub-android/blob/main/feature/preview/src/main/kotlin/io/github/samgum/aegisub/feature/preview/Media3VideoPlayer.kt"
click node_waveform "https://github.com/samgum/aegisub-android/blob/main/feature/preview/src/main/kotlin/io/github/samgum/aegisub/feature/preview/audio/WaveformExtractor.kt"
click node_projectrepo "https://github.com/samgum/aegisub-android/blob/main/core/data/src/main/kotlin/io/github/samgum/aegisub/data/repository/ProjectRepository.kt"
click node_session "https://github.com/samgum/aegisub-android/blob/main/core/data/src/main/kotlin/io/github/samgum/aegisub/data/session/ProjectSessionManager.kt"
click node_database "https://github.com/samgum/aegisub-android/blob/main/core/data/src/main/kotlin/io/github/samgum/aegisub/data/local/SubtitleDatabase.kt"
click node_projectdao "https://github.com/samgum/aegisub-android/blob/main/core/data/src/main/kotlin/io/github/samgum/aegisub/data/local/ProjectDao.kt"
click node_snapshots "https://github.com/samgum/aegisub-android/blob/main/core/data/src/main/kotlin/io/github/samgum/aegisub/data/repository/SnapshotRepository.kt"
click node_bookmarks "https://github.com/samgum/aegisub-android/blob/main/core/data/src/main/kotlin/io/github/samgum/aegisub/data/repository/BookmarkRepository.kt"
click node_settingsrepo "https://github.com/samgum/aegisub-android/blob/main/core/data/src/main/kotlin/io/github/samgum/aegisub/data/settings/SettingsRepository.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_activity,node_navigation,node_home,node_settings,node_settingsvm toneBlue
class node_editor,node_editorvm,node_styleeditor,node_format,node_script,node_lineops,node_undo toneAmber
class node_preview,node_previewvm,node_player,node_waveform toneMint
class node_projectrepo,node_session,node_database,node_projectdao,node_snapshots,node_bookmarks,node_settingsrepo toneRose
class node_user toneIndigo
```

## Components

### Application

- [App entry](https://github.com/samgum/aegisub-android/blob/main/app/src/main/kotlin/io/github/samgum/aegisub/MainActivity.kt): `app/src/main/kotlin/io/github/samgum/aegisub/MainActivity.kt`
- [App navigation](https://github.com/samgum/aegisub-android/blob/main/app/src/main/kotlin/io/github/samgum/aegisub/navigation/AppNavigation.kt): `app/src/main/kotlin/io/github/samgum/aegisub/navigation/AppNavigation.kt`
- [Project home](https://github.com/samgum/aegisub-android/blob/main/app/src/main/kotlin/io/github/samgum/aegisub/ui/home/HomeScreen.kt): `app/src/main/kotlin/io/github/samgum/aegisub/ui/home/HomeScreen.kt`
- [Preferences UI](https://github.com/samgum/aegisub-android/blob/main/app/src/main/kotlin/io/github/samgum/aegisub/ui/settings/SettingsScreen.kt): `app/src/main/kotlin/io/github/samgum/aegisub/ui/settings/SettingsScreen.kt`
- [Preferences state](https://github.com/samgum/aegisub-android/blob/main/app/src/main/kotlin/io/github/samgum/aegisub/ui/settings/SettingsViewModel.kt): `app/src/main/kotlin/io/github/samgum/aegisub/ui/settings/SettingsViewModel.kt`

### Subtitle Editing

- [Subtitle editor](https://github.com/samgum/aegisub-android/blob/main/feature/editor/src/main/kotlin/io/github/samgum/aegisub/feature/editor/EditorScreen.kt): `feature/editor/src/main/kotlin/io/github/samgum/aegisub/feature/editor/EditorScreen.kt`
- [Editing state](https://github.com/samgum/aegisub-android/blob/main/feature/editor/src/main/kotlin/io/github/samgum/aegisub/feature/editor/EditorViewModel.kt): `feature/editor/src/main/kotlin/io/github/samgum/aegisub/feature/editor/EditorViewModel.kt`
- [Style editor](https://github.com/samgum/aegisub-android/blob/main/feature/editor/src/main/kotlin/io/github/samgum/aegisub/feature/editor/styles/StyleEditorScreen.kt): `feature/editor/src/main/kotlin/io/github/samgum/aegisub/feature/editor/styles/StyleEditorScreen.kt`
- [Format codecs](https://github.com/samgum/aegisub-android/tree/main/core/domain/src/main/kotlin/io/github/samgum/aegisub/domain/format): `core/domain/src/main/kotlin/io/github/samgum/aegisub/domain/format`
- [ASS script model](https://github.com/samgum/aegisub-android/blob/main/core/domain/src/main/kotlin/io/github/samgum/aegisub/domain/model/AssScript.kt): `core/domain/src/main/kotlin/io/github/samgum/aegisub/domain/model/AssScript.kt`
- [Line operations](https://github.com/samgum/aegisub-android/blob/main/core/domain/src/main/kotlin/io/github/samgum/aegisub/domain/edit/LineOps.kt): `core/domain/src/main/kotlin/io/github/samgum/aegisub/domain/edit/LineOps.kt`
- [Undo engine](https://github.com/samgum/aegisub-android/blob/main/core/domain/src/main/kotlin/io/github/samgum/aegisub/domain/undo/UndoStack.kt): `core/domain/src/main/kotlin/io/github/samgum/aegisub/domain/undo/UndoStack.kt`

### Preview and Timing

- [Media preview](https://github.com/samgum/aegisub-android/blob/main/feature/preview/src/main/kotlin/io/github/samgum/aegisub/feature/preview/PreviewScreen.kt): `feature/preview/src/main/kotlin/io/github/samgum/aegisub/feature/preview/PreviewScreen.kt`
- [Preview state](https://github.com/samgum/aegisub-android/blob/main/feature/preview/src/main/kotlin/io/github/samgum/aegisub/feature/preview/PreviewViewModel.kt): `feature/preview/src/main/kotlin/io/github/samgum/aegisub/feature/preview/PreviewViewModel.kt`
- [Video player](https://github.com/samgum/aegisub-android/blob/main/feature/preview/src/main/kotlin/io/github/samgum/aegisub/feature/preview/Media3VideoPlayer.kt): `feature/preview/src/main/kotlin/io/github/samgum/aegisub/feature/preview/Media3VideoPlayer.kt`
- [Waveform extraction](https://github.com/samgum/aegisub-android/blob/main/feature/preview/src/main/kotlin/io/github/samgum/aegisub/feature/preview/audio/WaveformExtractor.kt): `feature/preview/src/main/kotlin/io/github/samgum/aegisub/feature/preview/audio/WaveformExtractor.kt`

### Project Data

- [Project repository](https://github.com/samgum/aegisub-android/blob/main/core/data/src/main/kotlin/io/github/samgum/aegisub/data/repository/ProjectRepository.kt): `core/data/src/main/kotlin/io/github/samgum/aegisub/data/repository/ProjectRepository.kt`
- [Shared project session](https://github.com/samgum/aegisub-android/blob/main/core/data/src/main/kotlin/io/github/samgum/aegisub/data/session/ProjectSessionManager.kt): `core/data/src/main/kotlin/io/github/samgum/aegisub/data/session/ProjectSessionManager.kt`
- [Subtitle database](https://github.com/samgum/aegisub-android/blob/main/core/data/src/main/kotlin/io/github/samgum/aegisub/data/local/SubtitleDatabase.kt): `core/data/src/main/kotlin/io/github/samgum/aegisub/data/local/SubtitleDatabase.kt`
- [Project records](https://github.com/samgum/aegisub-android/blob/main/core/data/src/main/kotlin/io/github/samgum/aegisub/data/local/ProjectDao.kt): `core/data/src/main/kotlin/io/github/samgum/aegisub/data/local/ProjectDao.kt`
- [History snapshots](https://github.com/samgum/aegisub-android/blob/main/core/data/src/main/kotlin/io/github/samgum/aegisub/data/repository/SnapshotRepository.kt): `core/data/src/main/kotlin/io/github/samgum/aegisub/data/repository/SnapshotRepository.kt`
- [Timing bookmarks](https://github.com/samgum/aegisub-android/blob/main/core/data/src/main/kotlin/io/github/samgum/aegisub/data/repository/BookmarkRepository.kt): `core/data/src/main/kotlin/io/github/samgum/aegisub/data/repository/BookmarkRepository.kt`
- [Preference storage](https://github.com/samgum/aegisub-android/blob/main/core/data/src/main/kotlin/io/github/samgum/aegisub/data/settings/SettingsRepository.kt): `core/data/src/main/kotlin/io/github/samgum/aegisub/data/settings/SettingsRepository.kt`

### Other components

- **Subtitle editor**

## Connections

- Subtitle editor → App entry: opens (evidence: `README.md`)
- App entry → App navigation: starts (evidence: `app/src/main/kotlin/io/github/samgum/aegisub/MainActivity.kt`)
- App navigation → Project home: routes to (evidence: `app/src/main/kotlin/io/github/samgum/aegisub/navigation/AppNavigation.kt`)
- App navigation → Subtitle editor: routes to
- App navigation → Media preview: routes to
- Project home → Project repository: manages projects
- Preferences UI → Preferences state: reads state (evidence: `app/src/main/kotlin/io/github/samgum/aegisub/ui/settings/SettingsScreen.kt`)
- Preferences state → Preference storage: updates preferences (evidence: `app/src/main/kotlin/io/github/samgum/aegisub/ui/settings/SettingsViewModel.kt`)
- Subtitle editor → Format codecs: imports and exports (evidence: `feature/editor/src/main/kotlin/io/github/samgum/aegisub/feature/editor/EditorScreen.kt`)
- Subtitle editor → ASS script model: edits script (evidence: `feature/editor/src/main/kotlin/io/github/samgum/aegisub/feature/editor/EditorScreen.kt`)
- Subtitle editor → Editing state: dispatches edits (evidence: `feature/editor/src/main/kotlin/io/github/samgum/aegisub/feature/editor/EditorScreen.kt`)
- Subtitle editor → Style editor: opens styles
- Editing state → Shared project session: shares project state
- Shared project session → Project repository: loads project (evidence: `core/data/src/main/kotlin/io/github/samgum/aegisub/data/session/ProjectSessionManager.kt`)
- Subtitle editor → Line operations: uses operations
- Subtitle editor → Undo engine: supports undo
- Media preview → Preview state: dispatches controls (evidence: `feature/preview/src/main/kotlin/io/github/samgum/aegisub/feature/preview/PreviewScreen.kt`)
- Media preview → Video player: renders player (evidence: `feature/preview/src/main/kotlin/io/github/samgum/aegisub/feature/preview/PreviewScreen.kt`)
- Media preview → Waveform extraction: renders audio views (evidence: `feature/preview/src/main/kotlin/io/github/samgum/aegisub/feature/preview/PreviewScreen.kt`)
- Preview state → Shared project session: opens shared state (evidence: `feature/preview/src/main/kotlin/io/github/samgum/aegisub/feature/preview/PreviewViewModel.kt`)
- Preview state → Project repository: reads media URI (evidence: `feature/preview/src/main/kotlin/io/github/samgum/aegisub/feature/preview/PreviewViewModel.kt`)
- Preview state → Video player: controls playback (evidence: `feature/preview/src/main/kotlin/io/github/samgum/aegisub/feature/preview/PreviewViewModel.kt`)
- Preview state → Waveform extraction: loads waveform (evidence: `feature/preview/src/main/kotlin/io/github/samgum/aegisub/feature/preview/PreviewViewModel.kt`)
- Preview state → Timing bookmarks: records bookmarks (evidence: `feature/preview/src/main/kotlin/io/github/samgum/aegisub/feature/preview/PreviewViewModel.kt`)
- Project repository → Project records: reads and writes (evidence: `core/data/src/main/kotlin/io/github/samgum/aegisub/data/repository/ProjectRepository.kt`)
- Subtitle database → Project records: provides DAO (evidence: `core/data/src/main/kotlin/io/github/samgum/aegisub/data/local/SubtitleDatabase.kt`)
- Project repository → Subtitle database: persists project data
- History snapshots → Subtitle database: stores history
- Timing bookmarks → Subtitle database: stores bookmarks
- Preference storage → Subtitle editor: persists preferences
