# vfsfitvnm/vimusic architecture

> Architecture diagram of the GitHub repository vfsfitvnm/vimusic, 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/vfsfitvnm/vimusic
- Repository: https://github.com/vfsfitvnm/vimusic

## Overview

ViMusic is an Android YouTube Music streaming app. Users discover music through home, search, and detail screens, then play it through a background player; the app also manages a local music library, playlists, lyrics, and preferences. The graph preserves documented capabilities, including Android Auto, queue reordering, timers, and offline caching. Source excerpts confirm key app, routing, database, and playback relationships; some feature links are documented only in the README or are unverified because their implementation was not sampled.

Main entry points: [`app/src/main/kotlin/it/vfsfitvnm/vimusic/service/PlayerService.kt`](https://github.com/vfsfitvnm/vimusic/blob/master/app/src/main/kotlin/it/vfsfitvnm/vimusic/service/PlayerService.kt) (Playback service), [`app/src/main/kotlin/it/vfsfitvnm/vimusic/MainActivity.kt`](https://github.com/vfsfitvnm/vimusic/blob/master/app/src/main/kotlin/it/vfsfitvnm/vimusic/MainActivity.kt) (App activity), [`app/src/main/kotlin/it/vfsfitvnm/vimusic/Database.kt`](https://github.com/vfsfitvnm/vimusic/blob/master/app/src/main/kotlin/it/vfsfitvnm/vimusic/Database.kt) (Music database), [`innertube/src/main/kotlin/it/vfsfitvnm/innertube/Innertube.kt`](https://github.com/vfsfitvnm/vimusic/blob/master/innertube/src/main/kotlin/it/vfsfitvnm/innertube/Innertube.kt) (Music API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["App interface"]
  node_activity["App activity<br/>[MainActivity.kt]"]
  node_routes["Screen routes<br/>[Routes.kt]"]
  node_home["Home discovery"]
  node_search["Search"]
  node_artist["Artist browsing<br/>[ArtistScreen.kt]"]
  node_player_ui["Player interface<br/>[Player.kt]"]
end

subgraph group_playback["Playback"]
  node_player["Playback service<br/>[PlayerService.kt]"]
end

subgraph group_library["Library and state"]
  node_database[("Music database<br/>[Database.kt]")]
  node_models["Music records<br/>[Song.kt]"]
  node_settings["Library settings"]
end

subgraph group_online["Online music"]
  node_innertube["Music API client<br/>[Innertube.kt]"]
  node_search_api["Search requests<br/>[SearchPage.kt]"]
  node_lyrics["Lyrics provider<br/>[KuGou.kt]"]
end

subgraph group_integration["Platform integration"]
  node_browser["Media browser"]
end

node_user(("Listener"))
node_youtube{{"YouTube Music"}}
node_android_auto(("Android Auto"))

node_user -->|"uses"| node_activity
node_activity -->|"binds"| node_player
node_activity -->|"hosts"| node_home
node_activity -->|"shows"| node_player_ui
node_routes -->|"routes to"| node_artist
node_user -->|"searches"| node_search
node_user -.->|"navigates"| node_routes
node_search -.->|"requests results"| node_search_api
node_search_api -->|"posts requests"| node_innertube
node_innertube -->|"queries"| node_youtube
node_home -.->|"loads discovery"| node_innertube
node_player -->|"resolves streams"| node_innertube
node_player -->|"reads and writes"| node_database
node_database -->|"stores records"| node_models
node_player_ui -.->|"controls playback"| node_player
node_player -->|"serves media"| node_browser
node_android_auto -->|"browses library"| node_browser
node_settings -->|"manages storage"| node_database
node_player -.->|"fetches lyrics"| node_lyrics
node_user -.->|"manages playlists"| node_database
node_user -.->|"reorders queue"| node_player
node_player -.->|"caches audio"| node_player

click node_activity "https://github.com/vfsfitvnm/vimusic/blob/master/app/src/main/kotlin/it/vfsfitvnm/vimusic/MainActivity.kt"
click node_routes "https://github.com/vfsfitvnm/vimusic/blob/master/app/src/main/kotlin/it/vfsfitvnm/vimusic/ui/screens/Routes.kt"
click node_home "https://github.com/vfsfitvnm/vimusic/tree/master/app/src/main/kotlin/it/vfsfitvnm/vimusic/ui/screens/home"
click node_search "https://github.com/vfsfitvnm/vimusic/tree/master/app/src/main/kotlin/it/vfsfitvnm/vimusic/ui/screens/search"
click node_artist "https://github.com/vfsfitvnm/vimusic/blob/master/app/src/main/kotlin/it/vfsfitvnm/vimusic/ui/screens/artist/ArtistScreen.kt"
click node_player_ui "https://github.com/vfsfitvnm/vimusic/blob/master/app/src/main/kotlin/it/vfsfitvnm/vimusic/ui/screens/player/Player.kt"
click node_player "https://github.com/vfsfitvnm/vimusic/blob/master/app/src/main/kotlin/it/vfsfitvnm/vimusic/service/PlayerService.kt"
click node_browser "https://github.com/vfsfitvnm/vimusic/blob/master/app/src/main/kotlin/it/vfsfitvnm/vimusic/service/PlayerMediaBrowserService.kt"
click node_database "https://github.com/vfsfitvnm/vimusic/blob/master/app/src/main/kotlin/it/vfsfitvnm/vimusic/Database.kt"
click node_models "https://github.com/vfsfitvnm/vimusic/blob/master/app/src/main/kotlin/it/vfsfitvnm/vimusic/models/Song.kt"
click node_settings "https://github.com/vfsfitvnm/vimusic/blob/master/app/src/main/kotlin/it/vfsfitvnm/vimusic/ui/screens/settings/DatabaseSettings.kt"
click node_innertube "https://github.com/vfsfitvnm/vimusic/blob/master/innertube/src/main/kotlin/it/vfsfitvnm/innertube/Innertube.kt"
click node_search_api "https://github.com/vfsfitvnm/vimusic/blob/master/innertube/src/main/kotlin/it/vfsfitvnm/innertube/requests/SearchPage.kt"
click node_lyrics "https://github.com/vfsfitvnm/vimusic/blob/master/kugou/src/main/kotlin/it/vfsfitvnm/kugou/KuGou.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_routes,node_home,node_search,node_artist,node_player_ui toneBlue
class node_player toneAmber
class node_database,node_models,node_settings toneMint
class node_innertube,node_search_api,node_lyrics toneRose
class node_browser,node_user,node_youtube,node_android_auto toneIndigo
```

## Components

### App interface

- [App activity](https://github.com/vfsfitvnm/vimusic/blob/master/app/src/main/kotlin/it/vfsfitvnm/vimusic/MainActivity.kt): `app/src/main/kotlin/it/vfsfitvnm/vimusic/MainActivity.kt`
- [Screen routes](https://github.com/vfsfitvnm/vimusic/blob/master/app/src/main/kotlin/it/vfsfitvnm/vimusic/ui/screens/Routes.kt): `app/src/main/kotlin/it/vfsfitvnm/vimusic/ui/screens/Routes.kt`
- [Home discovery](https://github.com/vfsfitvnm/vimusic/tree/master/app/src/main/kotlin/it/vfsfitvnm/vimusic/ui/screens/home): `app/src/main/kotlin/it/vfsfitvnm/vimusic/ui/screens/home`
- [Search](https://github.com/vfsfitvnm/vimusic/tree/master/app/src/main/kotlin/it/vfsfitvnm/vimusic/ui/screens/search): `app/src/main/kotlin/it/vfsfitvnm/vimusic/ui/screens/search`
- [Artist browsing](https://github.com/vfsfitvnm/vimusic/blob/master/app/src/main/kotlin/it/vfsfitvnm/vimusic/ui/screens/artist/ArtistScreen.kt): `app/src/main/kotlin/it/vfsfitvnm/vimusic/ui/screens/artist/ArtistScreen.kt`
- [Player interface](https://github.com/vfsfitvnm/vimusic/blob/master/app/src/main/kotlin/it/vfsfitvnm/vimusic/ui/screens/player/Player.kt): `app/src/main/kotlin/it/vfsfitvnm/vimusic/ui/screens/player/Player.kt`

### Playback

- [Playback service](https://github.com/vfsfitvnm/vimusic/blob/master/app/src/main/kotlin/it/vfsfitvnm/vimusic/service/PlayerService.kt): `app/src/main/kotlin/it/vfsfitvnm/vimusic/service/PlayerService.kt`

### Library and state

- [Music database](https://github.com/vfsfitvnm/vimusic/blob/master/app/src/main/kotlin/it/vfsfitvnm/vimusic/Database.kt): `app/src/main/kotlin/it/vfsfitvnm/vimusic/Database.kt`
- [Music records](https://github.com/vfsfitvnm/vimusic/blob/master/app/src/main/kotlin/it/vfsfitvnm/vimusic/models/Song.kt): `app/src/main/kotlin/it/vfsfitvnm/vimusic/models/Song.kt`
- [Library settings](https://github.com/vfsfitvnm/vimusic/blob/master/app/src/main/kotlin/it/vfsfitvnm/vimusic/ui/screens/settings/DatabaseSettings.kt): `app/src/main/kotlin/it/vfsfitvnm/vimusic/ui/screens/settings/DatabaseSettings.kt`

### Online music

- [Music API client](https://github.com/vfsfitvnm/vimusic/blob/master/innertube/src/main/kotlin/it/vfsfitvnm/innertube/Innertube.kt): `innertube/src/main/kotlin/it/vfsfitvnm/innertube/Innertube.kt`
- [Search requests](https://github.com/vfsfitvnm/vimusic/blob/master/innertube/src/main/kotlin/it/vfsfitvnm/innertube/requests/SearchPage.kt): `innertube/src/main/kotlin/it/vfsfitvnm/innertube/requests/SearchPage.kt`
- [Lyrics provider](https://github.com/vfsfitvnm/vimusic/blob/master/kugou/src/main/kotlin/it/vfsfitvnm/kugou/KuGou.kt): `kugou/src/main/kotlin/it/vfsfitvnm/kugou/KuGou.kt`

### Platform integration

- [Media browser](https://github.com/vfsfitvnm/vimusic/blob/master/app/src/main/kotlin/it/vfsfitvnm/vimusic/service/PlayerMediaBrowserService.kt): `app/src/main/kotlin/it/vfsfitvnm/vimusic/service/PlayerMediaBrowserService.kt`

### Other components

- **Listener**
- **YouTube Music**
- **Android Auto**

## Connections

- Listener → App activity: uses (evidence: `README.md`)
- App activity → Playback service: binds (evidence: `app/src/main/kotlin/it/vfsfitvnm/vimusic/MainActivity.kt`)
- App activity → Home discovery: hosts (evidence: `app/src/main/kotlin/it/vfsfitvnm/vimusic/MainActivity.kt`)
- App activity → Player interface: shows (evidence: `app/src/main/kotlin/it/vfsfitvnm/vimusic/MainActivity.kt`)
- Screen routes → Artist browsing: routes to (evidence: `app/src/main/kotlin/it/vfsfitvnm/vimusic/ui/screens/Routes.kt`)
- Listener → Search: searches (evidence: `README.md`)
- Listener → Screen routes: navigates
- Search → Search requests: requests results
- Search requests → Music API client: posts requests (evidence: `innertube/src/main/kotlin/it/vfsfitvnm/innertube/requests/SearchPage.kt`)
- Music API client → YouTube Music: queries (evidence: `innertube/src/main/kotlin/it/vfsfitvnm/innertube/Innertube.kt`)
- Home discovery → Music API client: loads discovery
- Playback service → Music API client: resolves streams (evidence: `app/src/main/kotlin/it/vfsfitvnm/vimusic/service/PlayerService.kt`)
- Playback service → Music database: reads and writes (evidence: `app/src/main/kotlin/it/vfsfitvnm/vimusic/service/PlayerService.kt`)
- Music database → Music records: stores records (evidence: `app/src/main/kotlin/it/vfsfitvnm/vimusic/Database.kt`)
- Player interface → Playback service: controls playback
- Playback service → Media browser: serves media (evidence: `app/src/main/kotlin/it/vfsfitvnm/vimusic/service/PlayerMediaBrowserService.kt`)
- Android Auto → Media browser: browses library (evidence: `app/src/main/kotlin/it/vfsfitvnm/vimusic/service/PlayerMediaBrowserService.kt`)
- Library settings → Music database: manages storage (evidence: `app/src/main/kotlin/it/vfsfitvnm/vimusic/ui/screens/settings/DatabaseSettings.kt`)
- Playback service → Lyrics provider: fetches lyrics
- Listener → Music database: manages playlists (evidence: `README.md`)
- Listener → Playback service: reorders queue (evidence: `README.md`)
- Playback service → Playback service: caches audio (evidence: `README.md`)
