# yigder/prism architecture

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

- Interactive diagram: https://gitdiagram.com/yigder/prism
- Repository: https://github.com/yigder/prism

## Overview

Prism is an Android music player for phones and TVs, centered on browsing or searching for music and playing it, with optional account sync and a broad set of listening features. The map preserves documented branches for lyrics, mixes, downloads, local files, history imports, and device connections. Several implementation details are unsampled; edges are limited to relationships stated in the README or visible in excerpts, so the map is not a complete runtime call graph.

Main entry points: [`app/src/main/java/com/prism/music/MainActivity.kt`](https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/MainActivity.kt) (Phone app), [`app/src/main/java/com/prism/music/playback/PlaybackService.kt`](https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/playback/PlaybackService.kt) (Playback service), [`app/src/main/java/com/prism/music/data/innertube/InnerTube.kt`](https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/data/innertube/InnerTube.kt) (YouTube Music access), [`app/src/main/java/com/prism/music/data/LibraryRepository.kt`](https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/data/LibraryRepository.kt) (Library repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App experience"]
  node_phone_ui["Phone app<br/>[MainActivity.kt]"]
  node_tv_ui["TV app<br/>[TvActivity.kt]"]
  node_settings[("Preferences<br/>[Settings.kt]")]
  node_language["App language<br/>[AppLanguage.kt]"]
end

subgraph group_playback["Playback and sound"]
  node_playback_service["Playback service<br/>[PlaybackService.kt]"]
  node_audio_effects["Audio effects<br/>[AudioEffects.kt]"]
  node_sing["Sing mode<br/>[Sing.kt]"]
  node_downloads["Offline downloads<br/>[Downloads.kt]"]
  node_diagnostics["Playback diagnostics"]
end

subgraph group_catalog["Music and discovery"]
  node_lyrics["Lyrics<br/>[Lyrics.kt]"]
  node_search["Search screen<br/>[SearchScreen.kt]"]
  node_innertube["YouTube Music access<br/>[InnerTube.kt]"]
  node_json["Service parsing<br/>[Json.kt]"]
  node_podcasts["Podcast feeds<br/>[RssPodcasts.kt]"]
  node_local_music["Local music<br/>[LocalMusic.kt]"]
end

subgraph group_personal["Personal library"]
  node_library["Library repository"]
  node_database[("Music database<br/>[Database.kt]")]
  node_recommendations["On-device mixes<br/>[ForYou.kt]"]
  node_history_import["History import<br/>[YouTubeLive.kt]"]
end

subgraph group_connect["Devices and sharing"]
  node_cast["Cast and speakers<br/>[Cast.kt]"]
end

node_listener(("Listener"))
node_external_music{{"YouTube Music"}}
node_remote_devices{{"TVs and speakers"}}
node_other_services{{"Other history services"}}

node_listener -->|"browses and selects"| node_phone_ui
node_listener -->|"browses and selects"| node_tv_ui
node_phone_ui -.->|"starts listening"| node_playback_service
node_tv_ui -->|"controls playback"| node_playback_service
node_playback_service -->|"plays music"| node_external_music
node_playback_service -.->|"applies sound effects"| node_audio_effects
node_playback_service -.->|"supports vocal removal"| node_sing
node_playback_service -.->|"records playback health"| node_diagnostics
node_phone_ui -->|"opens search"| node_search
node_search -.->|"finds music"| node_innertube
node_innertube -.->|"requests catalog data"| node_external_music
node_innertube -->|"uses service parsing"| node_json
node_phone_ui -->|"shows synchronized lyrics"| node_lyrics
node_phone_ui -->|"offers on-device mixes"| node_recommendations
node_phone_ui -->|"offers podcasts"| node_podcasts
node_phone_ui -->|"plays own files"| node_local_music
node_phone_ui -->|"manages saved music"| node_library
node_library -.->|"stores library data"| node_database
node_library -->|"syncs account library"| node_external_music
node_phone_ui -->|"manages offline music"| node_downloads
node_phone_ui -->|"imports listening history"| node_history_import
node_history_import -->|"imports service exports"| node_other_services
node_playback_service -->|"sends current playback"| node_cast
node_cast -->|"streams to devices"| node_remote_devices
node_phone_ui -.->|"configures listening"| node_settings
node_phone_ui -->|"uses app language"| node_language

click node_phone_ui "https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/MainActivity.kt"
click node_tv_ui "https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/TvActivity.kt"
click node_settings "https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/data/prefs/Settings.kt"
click node_language "https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/AppLanguage.kt"
click node_playback_service "https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/playback/PlaybackService.kt"
click node_audio_effects "https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/playback/AudioEffects.kt"
click node_sing "https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/playback/sing/Sing.kt"
click node_downloads "https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/download/Downloads.kt"
click node_diagnostics "https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/playback/AudioDiagnostics.kt"
click node_lyrics "https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/data/lyrics/Lyrics.kt"
click node_search "https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/ui/screens/SearchScreen.kt"
click node_innertube "https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/data/innertube/InnerTube.kt"
click node_json "https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/data/innertube/Json.kt"
click node_podcasts "https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/data/podcast/RssPodcasts.kt"
click node_local_music "https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/data/local/LocalMusic.kt"
click node_library "https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/data/LibraryRepository.kt"
click node_database "https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/data/db/Database.kt"
click node_recommendations "https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/data/foryou/ForYou.kt"
click node_history_import "https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/data/imports/YouTubeLive.kt"
click node_cast "https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/connect/Cast.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_phone_ui,node_tv_ui,node_settings,node_language toneBlue
class node_playback_service,node_audio_effects,node_sing,node_downloads,node_diagnostics toneAmber
class node_lyrics,node_search,node_innertube,node_json,node_podcasts,node_local_music toneMint
class node_library,node_database,node_recommendations,node_history_import toneRose
class node_cast,node_listener,node_external_music,node_remote_devices,node_other_services toneIndigo
```

## Components

### App experience

- [Phone app](https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/MainActivity.kt): `app/src/main/java/com/prism/music/MainActivity.kt`
- [TV app](https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/TvActivity.kt): `app/src/main/java/com/prism/music/TvActivity.kt`
- [Preferences](https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/data/prefs/Settings.kt): `app/src/main/java/com/prism/music/data/prefs/Settings.kt`
- [App language](https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/AppLanguage.kt): `app/src/main/java/com/prism/music/AppLanguage.kt`

### Playback and sound

- [Playback service](https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/playback/PlaybackService.kt): `app/src/main/java/com/prism/music/playback/PlaybackService.kt`
- [Audio effects](https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/playback/AudioEffects.kt): `app/src/main/java/com/prism/music/playback/AudioEffects.kt`
- [Sing mode](https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/playback/sing/Sing.kt): `app/src/main/java/com/prism/music/playback/sing/Sing.kt`
- [Offline downloads](https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/download/Downloads.kt): `app/src/main/java/com/prism/music/download/Downloads.kt`
- [Playback diagnostics](https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/playback/AudioDiagnostics.kt): `app/src/main/java/com/prism/music/playback/AudioDiagnostics.kt`

### Music and discovery

- [Lyrics](https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/data/lyrics/Lyrics.kt): `app/src/main/java/com/prism/music/data/lyrics/Lyrics.kt`
- [Search screen](https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/ui/screens/SearchScreen.kt): `app/src/main/java/com/prism/music/ui/screens/SearchScreen.kt`
- [YouTube Music access](https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/data/innertube/InnerTube.kt): `app/src/main/java/com/prism/music/data/innertube/InnerTube.kt`
- [Service parsing](https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/data/innertube/Json.kt): `app/src/main/java/com/prism/music/data/innertube/Json.kt`
- [Podcast feeds](https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/data/podcast/RssPodcasts.kt): `app/src/main/java/com/prism/music/data/podcast/RssPodcasts.kt`
- [Local music](https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/data/local/LocalMusic.kt): `app/src/main/java/com/prism/music/data/local/LocalMusic.kt`

### Personal library

- [Library repository](https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/data/LibraryRepository.kt): `app/src/main/java/com/prism/music/data/LibraryRepository.kt`
- [Music database](https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/data/db/Database.kt): `app/src/main/java/com/prism/music/data/db/Database.kt`
- [On-device mixes](https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/data/foryou/ForYou.kt): `app/src/main/java/com/prism/music/data/foryou/ForYou.kt`
- [History import](https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/data/imports/YouTubeLive.kt): `app/src/main/java/com/prism/music/data/imports/YouTubeLive.kt`

### Devices and sharing

- [Cast and speakers](https://github.com/yigder/prism/blob/main/app/src/main/java/com/prism/music/connect/Cast.kt): `app/src/main/java/com/prism/music/connect/Cast.kt`

### Other components

- **Listener**
- **YouTube Music**
- **TVs and speakers**
- **Other history services**

## Connections

- Listener → Phone app: browses and selects
- Listener → TV app: browses and selects
- Phone app → Playback service: starts listening (evidence: `app/src/main/java/com/prism/music/playback/PlaybackService.kt`)
- TV app → Playback service: controls playback (evidence: `app/src/main/java/com/prism/music/TvActivity.kt`)
- Playback service → YouTube Music: plays music
- Playback service → Audio effects: applies sound effects (evidence: `app/src/main/java/com/prism/music/playback/PlaybackService.kt`)
- Playback service → Sing mode: supports vocal removal (evidence: `app/src/main/java/com/prism/music/playback/PlaybackService.kt`)
- Playback service → Playback diagnostics: records playback health (evidence: `app/src/main/java/com/prism/music/playback/PlaybackService.kt`)
- Phone app → Search screen: opens search (evidence: `app/src/main/java/com/prism/music/MainActivity.kt`)
- Search screen → YouTube Music access: finds music
- YouTube Music access → YouTube Music: requests catalog data
- YouTube Music access → Service parsing: uses service parsing (evidence: `app/src/main/java/com/prism/music/data/innertube/InnerTube.kt`)
- Phone app → Lyrics: shows synchronized lyrics
- Phone app → On-device mixes: offers on-device mixes
- Phone app → Podcast feeds: offers podcasts
- Phone app → Local music: plays own files
- Phone app → Library repository: manages saved music
- Library repository → Music database: stores library data
- Library repository → YouTube Music: syncs account library (evidence: `app/src/main/java/com/prism/music/data/LibraryRepository.kt`)
- Phone app → Offline downloads: manages offline music
- Phone app → History import: imports listening history
- History import → Other history services: imports service exports
- Playback service → Cast and speakers: sends current playback (evidence: `app/src/main/java/com/prism/music/playback/PlaybackService.kt`)
- Cast and speakers → TVs and speakers: streams to devices
- Phone app → Preferences: configures listening (evidence: `app/src/main/java/com/prism/music/MainActivity.kt`)
- Phone app → App language: uses app language (evidence: `app/src/main/java/com/prism/music/MainActivity.kt`)
