# devlwte/snoufly architecture

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

- Interactive diagram: https://gitdiagram.com/devlwte/snoufly
- Repository: https://github.com/devlwte/snoufly

## Overview

1. **Repository shape**
   - This is a **single-module Android app** (`app/`) written in **Kotlin** using **Jetpack Compose** and **Media3**. There is no backend or multi-module split visible in the tree; the architecture is centered on the app process, local storage, and Android system media APIs.

2. **App entry and UI shell**
   - `MainActivity` is the entry point and likely hosts the Compose root, theme, and navigation graph.
   - `Navigation.kt` defines the app’s screen routing, consistent with a **single-activity, multi-screen Compose** design.

3. **Primary presentation layer**
   - UI is organized into reusable components in `ui/components` and screens in `ui/screens`.
   - Main screens include **Library**, **Favorites**, **Now Playing**, **Equalizer**, and **Settings**. Supporting UI includes **MiniPlayer**, **LyricsView**, **RecentlyPlayedCarousel**, **SongItem**, and an **EditSongDialog** for metadata changes.

4. **State management boundary**
   - The app uses **MVVM** with two major ViewModel areas:
     - `MainViewModel` for library/navigation/UI state.
     - `PlaybackViewModel` for playback session state and controller access.
   - `MainViewModelFactory` indicates dependency injection via factory rather than a full DI framework.

5. **Playback subsystem**
   - `playback/MusicService.kt` is the core media service and appears to be the long-lived **MediaSessionService** wrapping **ExoPlayer / Media3**.
   - This service is the boundary between the app UI and Android’s background playback system; playback continues independently of the activity lifecycle.
   - The README indicates playback features such as gapless playback, speed/pitch control, and equalizer integration, so the service is the central execution point for those audio features.

6. **Playback data flow**
   - User actions in the UI go to `PlaybackViewModel`.
   - The ViewModel exposes state and a `MediaController`-style control path to the UI, while the service owns the actual player instance.
   - This is a one-way control model: **UI → ViewModel → Service/Player**, with playback state flowing back into UI as observable state.

7. **Library and metadata layer**
   - `data/MusicRepository.kt` is the likely source of truth for scanning and exposing the music library, probably backed by **MediaStore** as described in the README.
   - `Song.kt` and `CustomMetadata.kt` separate the physical media item from app-level overrides such as edited title/artist/album.
   - `MainViewModel` likely combines repository data with settings and search/filter state to build the visible library model.

8. **Persistence and user settings**
   - `SettingsManager.kt` indicates reactive settings storage, most likely **Jetpack DataStore**.
   - This layer persists app preferences such as scan filters, playback settings, equalizer-related choices, and custom metadata references.
   - The architecture favors **local, reactive persistence** rather than direct file mutation.

9. **Lyrics subsystem**
   - `LrcParser.kt`, `LyricLine.kt`, and `ui/components/LyricsView.kt` form a dedicated lyrics pipeline.
   - The app supports synchronized `.lrc` files, and the README mentions **persistable URI permissions**, meaning the lyrics source is treated as a user-selected content URI that must survive restarts.
   - This is a separate data path from the music library: lyrics are attached to songs but stored and loaded independently.

10. **Backup and restore**
   - `data/BackupManager.kt` is a self-contained export/import boundary.
   - The README says backups include favorites, custom tags, and EQ presets, so the backup layer aggregates data from multiple local stores and serializes it to **JSON** for portability.

11. **Feature-specific screens**
   - `EqualizerScreen`, `FavoritesScreen`, `LibraryScreen`, `NowPlayingScreen`, and `SettingsScreen` are the top-level user journeys.
   - These screens likely consume ViewModel state and dispatch intents/actions upward, keeping them mostly stateless renderers.

12. **Project infrastructure**
   - The presence of `AndroidManifest.xml`, backup XML rules, and standard resource folders shows this is a conventional Android app with system integration for backup/data-extraction and launcher assets.
   - Test coverage exists in both `androidTest` and `test`, but no separate backend, worker service, or database layer appears in the tree.

13. **Important architectural boundaries to diagram**
   - **UI boundary:** Compose screens/components render state and emit user actions.
   - **State boundary:** ViewModels aggregate flows and mediate between UI and data/service layers.
   - **Playback boundary:** `MusicService` owns the actual audio engine and session.
   - **Persistence boundary:** `SettingsManager`, `BackupManager`, and metadata/lyrics handling keep user data local and reactive.
   - **Android system boundary:** `MediaStore`, `DataStore`, Media3 session APIs, and persistable URI permissions are the main external platform integrations.

14. **Overall flow**
   - The most accurate diagram would show a local-only Android music player where **library data** comes from MediaStore into the repository, **UI state** is assembled in ViewModels, **playback** is delegated to a persistent Media3 service, and **user preferences/overrides** are stored locally through DataStore-style persistence and JSON backup/restore.

Main entry points: [`app/src/main/java/com/kyrn/snoufly/ui/Navigation.kt`](https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/ui/Navigation.kt) (Navigation), [`app/src/main/java/com/kyrn/snoufly/ui/MainViewModel.kt`](https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/ui/MainViewModel.kt) (MainViewModel), [`app/src/main/java/com/kyrn/snoufly/playback/PlaybackViewModel.kt`](https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/playback/PlaybackViewModel.kt) (PlaybackViewModel), [`app/src/main/java/com/kyrn/snoufly/data/SettingsManager.kt`](https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/data/SettingsManager.kt) (SettingsManager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_group_app["App shell"]
  node_n_main_activity["MainActivity<br/>entry activity<br/>[MainActivity.kt]"]
  node_n_navigation["Navigation<br/>compose routing<br/>[Navigation.kt]"]
end

subgraph group_group_state["State"]
  node_n_main_vm["MainViewModel<br/>ui state<br/>[MainViewModel.kt]"]
  node_n_main_vm_factory["VM Factory<br/>construction"]
  node_n_playback_vm["PlaybackViewModel<br/>playback state"]
end

subgraph group_group_data["Data"]
  node_n_music_repo[("MusicRepository<br/>library source<br/>[MusicRepository.kt]")]
  node_n_song["Song<br/>media model<br/>[Song.kt]"]
  node_n_custom_metadata["CustomMetadata<br/>override model<br/>[CustomMetadata.kt]"]
  node_n_settings[("SettingsManager<br/>preferences<br/>[SettingsManager.kt]")]
  node_n_backup["BackupManager<br/>backup import/export<br/>[BackupManager.kt]"]
  node_n_lrc_parser["LrcParser<br/>lyrics parser<br/>[LrcParser.kt]"]
  node_n_lyric_line["LyricLine<br/>lyrics model<br/>[LyricLine.kt]"]
end

subgraph group_group_playback["Playback"]
  node_n_music_service["MusicService<br/>media service<br/>[MusicService.kt]"]
end

subgraph group_group_ui["UI"]
  node_n_mini_player["MiniPlayer<br/>now-playing UI<br/>[MiniPlayer.kt]"]
  node_n_lyrics_view["LyricsView<br/>lyrics UI<br/>[LyricsView.kt]"]
  node_n_song_item["SongItem<br/>library UI<br/>[SongItem.kt]"]
  node_n_recent_carousel["Recent Carousel<br/>library UI"]
  node_n_edit_dialog["EditSongDialog<br/>metadata UI<br/>[EditSongDialog.kt]"]
  node_n_library_screen["LibraryScreen<br/>[LibraryScreen.kt]"]
  node_n_favorites_screen["FavoritesScreen<br/>[FavoritesScreen.kt]"]
  node_n_now_playing_screen["NowPlayingScreen"]
  node_n_equalizer_screen["EqualizerScreen<br/>[EqualizerScreen.kt]"]
  node_n_settings_screen["SettingsScreen<br/>[SettingsScreen.kt]"]
end

node_n_main_activity -->|"hosts"| node_n_navigation
node_n_navigation -->|"routes"| node_n_library_screen
node_n_navigation -->|"routes"| node_n_favorites_screen
node_n_navigation -->|"routes"| node_n_now_playing_screen
node_n_navigation -->|"routes"| node_n_equalizer_screen
node_n_navigation -->|"routes"| node_n_settings_screen
node_n_main_activity -->|"creates"| node_n_main_vm_factory
node_n_main_vm_factory -->|"instantiates"| node_n_main_vm
node_n_main_vm -->|"reads"| node_n_music_repo
node_n_main_vm -->|"observes"| node_n_settings
node_n_main_vm -.->|"coordinates"| node_n_backup
node_n_main_vm -->|"applies"| node_n_custom_metadata
node_n_playback_vm -->|"controls"| node_n_music_service
node_n_playback_vm -->|"observes"| node_n_settings
node_n_music_repo -->|"emits"| node_n_song
node_n_music_repo -->|"joins"| node_n_custom_metadata
node_n_music_repo -.->|"filters by"| node_n_settings
node_n_backup -->|"exports"| node_n_settings
node_n_backup -->|"exports"| node_n_custom_metadata
node_n_backup -.->|"exports"| node_n_song
node_n_lrc_parser -->|"produces"| node_n_lyric_line
node_n_lrc_parser -->|"feeds"| node_n_lyrics_view
node_n_library_screen -->|"uses"| node_n_song_item
node_n_library_screen -->|"uses"| node_n_recent_carousel
node_n_library_screen -.->|"opens"| node_n_edit_dialog
node_n_favorites_screen -->|"uses"| node_n_song_item
node_n_now_playing_screen -->|"embeds"| node_n_mini_player
node_n_now_playing_screen -->|"shows"| node_n_lyrics_view
node_n_settings_screen -->|"controls"| node_n_settings
node_n_equalizer_screen -->|"uses"| node_n_playback_vm
node_n_mini_player -->|"binds"| node_n_playback_vm
node_n_song_item -->|"starts"| node_n_playback_vm

click node_n_main_activity "https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/MainActivity.kt"
click node_n_navigation "https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/ui/Navigation.kt"
click node_n_main_vm "https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/ui/MainViewModel.kt"
click node_n_main_vm_factory "https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/ui/MainViewModelFactory.kt"
click node_n_playback_vm "https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/playback/PlaybackViewModel.kt"
click node_n_music_repo "https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/data/MusicRepository.kt"
click node_n_song "https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/data/Song.kt"
click node_n_custom_metadata "https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/data/CustomMetadata.kt"
click node_n_settings "https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/data/SettingsManager.kt"
click node_n_backup "https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/data/BackupManager.kt"
click node_n_lrc_parser "https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/data/LrcParser.kt"
click node_n_lyric_line "https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/data/LyricLine.kt"
click node_n_music_service "https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/playback/MusicService.kt"
click node_n_mini_player "https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/ui/components/MiniPlayer.kt"
click node_n_lyrics_view "https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/ui/components/LyricsView.kt"
click node_n_song_item "https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/ui/components/SongItem.kt"
click node_n_recent_carousel "https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/ui/components/RecentlyPlayedCarousel.kt"
click node_n_edit_dialog "https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/ui/components/EditSongDialog.kt"
click node_n_library_screen "https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/ui/screens/LibraryScreen.kt"
click node_n_favorites_screen "https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/ui/screens/FavoritesScreen.kt"
click node_n_now_playing_screen "https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/ui/screens/NowPlayingScreen.kt"
click node_n_equalizer_screen "https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/ui/screens/EqualizerScreen.kt"
click node_n_settings_screen "https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/ui/screens/SettingsScreen.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_n_main_activity,node_n_navigation toneBlue
class node_n_main_vm,node_n_main_vm_factory,node_n_playback_vm toneAmber
class node_n_music_repo,node_n_song,node_n_custom_metadata,node_n_settings,node_n_backup,node_n_lrc_parser,node_n_lyric_line toneMint
class node_n_music_service toneRose
class node_n_mini_player,node_n_lyrics_view,node_n_song_item,node_n_recent_carousel,node_n_edit_dialog,node_n_library_screen,node_n_favorites_screen,node_n_now_playing_screen,node_n_equalizer_screen,node_n_settings_screen toneIndigo
```

## Components

### App shell

Activity, navigation, and top-level Compose UI.

- [MainActivity](https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/MainActivity.kt): entry activity · Single-activity entry point hosting the Compose app. · `app/src/main/java/com/kyrn/snoufly/MainActivity.kt`
- [Navigation](https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/ui/Navigation.kt): compose routing · Screen routing and app flow orchestration. · `app/src/main/java/com/kyrn/snoufly/ui/Navigation.kt`

### State

ViewModels that mediate UI, library, and playback state.

- [MainViewModel](https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/ui/MainViewModel.kt): ui state · Aggregates library, filters, and screen-level state. · `app/src/main/java/com/kyrn/snoufly/ui/MainViewModel.kt`
- [VM Factory](https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/ui/MainViewModelFactory.kt): construction · Creates the main ViewModel with app dependencies. · `app/src/main/java/com/kyrn/snoufly/ui/MainViewModelFactory.kt`
- [PlaybackViewModel](https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/playback/PlaybackViewModel.kt): playback state · Bridges UI actions to the playback session and exposes player state. · `app/src/main/java/com/kyrn/snoufly/playback/PlaybackViewModel.kt`

### Data

Local library, metadata, lyrics, settings, and backup flows.

- [MusicRepository](https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/data/MusicRepository.kt): library source · Scans and exposes the music library from local device storage. · `app/src/main/java/com/kyrn/snoufly/data/MusicRepository.kt`
- [Song](https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/data/Song.kt): media model · Core song model for library items and playback selection. · `app/src/main/java/com/kyrn/snoufly/data/Song.kt`
- [CustomMetadata](https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/data/CustomMetadata.kt): override model · App-managed metadata overrides such as edited tags. · `app/src/main/java/com/kyrn/snoufly/data/CustomMetadata.kt`
- [SettingsManager](https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/data/SettingsManager.kt): preferences · Reactive local settings and playback preference storage. · `app/src/main/java/com/kyrn/snoufly/data/SettingsManager.kt`
- [BackupManager](https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/data/BackupManager.kt): backup import/export · Serializes and restores favorites, presets, and custom data. · `app/src/main/java/com/kyrn/snoufly/data/BackupManager.kt`
- [LrcParser](https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/data/LrcParser.kt): lyrics parser · Parses synchronized LRC lyric files. · `app/src/main/java/com/kyrn/snoufly/data/LrcParser.kt`
- [LyricLine](https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/data/LyricLine.kt): lyrics model · Represents a timed lyric line. · `app/src/main/java/com/kyrn/snoufly/data/LyricLine.kt`

### Playback

Media3 service and playback control boundary.

- [MusicService](https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/playback/MusicService.kt): media service · Long-lived Media3 session service owning the audio engine. · `app/src/main/java/com/kyrn/snoufly/playback/MusicService.kt`

### UI

Reusable components and feature screens.

- [MiniPlayer](https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/ui/components/MiniPlayer.kt): now-playing UI · Compact playback controls surfaced across the app. · `app/src/main/java/com/kyrn/snoufly/ui/components/MiniPlayer.kt`
- [LyricsView](https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/ui/components/LyricsView.kt): lyrics UI · Renders synchronized lyric lines for the active song. · `app/src/main/java/com/kyrn/snoufly/ui/components/LyricsView.kt`
- [SongItem](https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/ui/components/SongItem.kt): library UI · Reusable row/tile for songs in lists and search results. · `app/src/main/java/com/kyrn/snoufly/ui/components/SongItem.kt`
- [Recent Carousel](https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/ui/components/RecentlyPlayedCarousel.kt): library UI · Shows recently played content in a horizontal strip. · `app/src/main/java/com/kyrn/snoufly/ui/components/RecentlyPlayedCarousel.kt`
- [EditSongDialog](https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/ui/components/EditSongDialog.kt): metadata UI · Dialog for editing song metadata and overrides. · `app/src/main/java/com/kyrn/snoufly/ui/components/EditSongDialog.kt`
- [LibraryScreen](https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/ui/screens/LibraryScreen.kt): screen · Primary library browsing and search experience. · `app/src/main/java/com/kyrn/snoufly/ui/screens/LibraryScreen.kt`
- [FavoritesScreen](https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/ui/screens/FavoritesScreen.kt): screen · Favorites-focused browsing and playback entry point. · `app/src/main/java/com/kyrn/snoufly/ui/screens/FavoritesScreen.kt`
- [NowPlayingScreen](https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/ui/screens/NowPlayingScreen.kt): screen · Expanded playback controls and track details. · `app/src/main/java/com/kyrn/snoufly/ui/screens/NowPlayingScreen.kt`
- [EqualizerScreen](https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/ui/screens/EqualizerScreen.kt): screen · Audio tuning and equalizer controls. · `app/src/main/java/com/kyrn/snoufly/ui/screens/EqualizerScreen.kt`
- [SettingsScreen](https://github.com/devlwte/snoufly/blob/master/app/src/main/java/com/kyrn/snoufly/ui/screens/SettingsScreen.kt): screen · App preferences and configuration surface. · `app/src/main/java/com/kyrn/snoufly/ui/screens/SettingsScreen.kt`

## Connections

- MainActivity → Navigation: hosts · Main activity sets up the Compose navigation shell.
- Navigation → LibraryScreen: routes · Navigation selects the library screen.
- Navigation → FavoritesScreen: routes · Navigation selects the favorites screen.
- Navigation → NowPlayingScreen: routes · Navigation selects the now playing screen.
- Navigation → EqualizerScreen: routes · Navigation selects the equalizer screen.
- Navigation → SettingsScreen: routes · Navigation selects the settings screen.
- MainActivity → VM Factory: creates · Activity initializes the main ViewModel through its factory.
- VM Factory → MainViewModel: instantiates · Factory provides dependencies to the main ViewModel.
- MainViewModel → MusicRepository: reads · Main state pulls library data from the repository.
- MainViewModel → SettingsManager: observes · Main state combines user preferences with library state.
- MainViewModel → BackupManager: coordinates · Main state can trigger export/import workflows.
- MainViewModel → CustomMetadata: applies · Main state merges edited metadata into visible library items.
- PlaybackViewModel → MusicService: controls · Playback ViewModel sends transport and session commands to the service.
- PlaybackViewModel → SettingsManager: observes · Playback state reflects persisted playback preferences.
- MusicRepository → Song: emits · Repository exposes songs as the core library entity.
- MusicRepository → CustomMetadata: joins · Repository merges stored overrides into library items.
- MusicRepository → SettingsManager: filters by · Repository behavior is shaped by local scan and preference settings.
- BackupManager → SettingsManager: exports · Backup includes preferences and app state.
- BackupManager → CustomMetadata: exports · Backup includes custom metadata and user edits.
- BackupManager → Song: exports · Backup references library-derived favorites and related song data.
- LrcParser → LyricLine: produces · Parser converts LRC content into timed lyric lines.
- LrcParser → LyricsView: feeds · Parsed lyrics are rendered in the lyrics component.
- LibraryScreen → SongItem: uses · Library screen renders songs via reusable items.
- LibraryScreen → Recent Carousel: uses · Library screen shows recent listening context.
- LibraryScreen → EditSongDialog: opens · Library screen can launch metadata editing.
- FavoritesScreen → SongItem: uses · Favorites screen reuses the song item component.
- NowPlayingScreen → MiniPlayer: embeds · Now playing surface includes compact player controls.
- NowPlayingScreen → LyricsView: shows · Now playing screen can render synchronized lyrics.
- SettingsScreen → SettingsManager: controls · Settings screen writes to the preference store.
- EqualizerScreen → PlaybackViewModel: uses · Equalizer settings flow through playback state and commands.
- MiniPlayer → PlaybackViewModel: binds · Mini player reflects and controls current playback state.
- SongItem → PlaybackViewModel: starts · Song items initiate playback actions through the playback ViewModel.
