# mateusrodcosta/lontramusic architecture

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

- Interactive diagram: https://gitdiagram.com/mateusrodcosta/lontramusic
- Repository: https://github.com/mateusrodcosta/lontramusic

## Overview

Lontra Music is an offline Android music player. Its main user journey is browsing the indexed music library, selecting tracks, and controlling playback; the app also provides lyrics, playlist import/export/sync, configurable preferences, and a home-screen widget. The source index and excerpts support the initialization and playback-service links shown here. Several feature modules are present in the tree but unsampled, so their internal wiring is not inferred.

Main entry points: [`app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/MainViewModel.kt`](https://github.com/mateusrodcosta/lontramusic/blob/dev/app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/MainViewModel.kt) (Main view model), [`app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/data/PlayerManager.kt`](https://github.com/mateusrodcosta/lontramusic/blob/dev/app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/data/PlayerManager.kt) (Player manager), [`app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/ui/views/playlist/PlaylistIoScreen.kt`](https://github.com/mateusrodcosta/lontramusic/blob/dev/app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/ui/views/playlist/PlaylistIoScreen.kt) (Playlist import/export), [`app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/UiManager.kt`](https://github.com/mateusrodcosta/lontramusic/blob/dev/app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/UiManager.kt) (UI manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App coordination"]
  node_activity["Main activity<br/>[MainActivity.kt]"]
  node_viewmodel["Main view model<br/>[MainViewModel.kt]"]
  node_ui_manager["UI manager<br/>[UiManager.kt]"]
  node_global_data["Shared app state<br/>[GlobalData.kt]"]
end

subgraph group_library["Library and playlists"]
  node_library_index[("Music library index<br/>[LibraryIndex.kt]")]
  node_track_fetcher["Track fetching<br/>[TrackFetcher.kt]"]
  node_playlist_manager[("Playlist management<br/>[Playlist.kt]")]
  node_playlist_io["Playlist import/export"]
end

subgraph group_playback["Playback and lyrics"]
  node_player_manager["Player manager<br/>[PlayerManager.kt]"]
  node_playback_service["Playback service<br/>[PlaybackService.kt]"]
  node_lyrics["Lyrics handling<br/>[Lyrics.kt]"]
end

subgraph group_experience["Screens and settings"]
  node_library_screen["Library browsing<br/>[LibraryScreen.kt]"]
  node_player_screen["Player screen<br/>[PlayerScreen.kt]"]
  node_preferences_screen["Preferences screen"]
  node_preferences["Preferences model<br/>[Preferences.kt]"]
  node_widget["Home-screen widget"]
end

node_android_user(("Android user"))

node_viewmodel -->|"creates"| node_player_manager
node_viewmodel -->|"creates"| node_ui_manager
node_player_manager -->|"connects to"| node_playback_service
node_playlist_io -->|"adds playlists"| node_playlist_manager

click node_activity "https://github.com/mateusrodcosta/lontramusic/blob/dev/app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/MainActivity.kt"
click node_viewmodel "https://github.com/mateusrodcosta/lontramusic/blob/dev/app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/MainViewModel.kt"
click node_ui_manager "https://github.com/mateusrodcosta/lontramusic/blob/dev/app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/UiManager.kt"
click node_global_data "https://github.com/mateusrodcosta/lontramusic/blob/dev/app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/globals/GlobalData.kt"
click node_library_index "https://github.com/mateusrodcosta/lontramusic/blob/dev/app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/data/LibraryIndex.kt"
click node_track_fetcher "https://github.com/mateusrodcosta/lontramusic/blob/dev/app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/data/TrackFetcher.kt"
click node_playlist_manager "https://github.com/mateusrodcosta/lontramusic/blob/dev/app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/data/Playlist.kt"
click node_playlist_io "https://github.com/mateusrodcosta/lontramusic/blob/dev/app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/ui/views/playlist/PlaylistIoScreen.kt"
click node_library_screen "https://github.com/mateusrodcosta/lontramusic/blob/dev/app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/ui/views/library/LibraryScreen.kt"
click node_player_screen "https://github.com/mateusrodcosta/lontramusic/blob/dev/app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/ui/views/player/PlayerScreen.kt"
click node_preferences_screen "https://github.com/mateusrodcosta/lontramusic/blob/dev/app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/ui/views/preferences/PreferencesScreen.kt"
click node_preferences "https://github.com/mateusrodcosta/lontramusic/blob/dev/app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/data/Preferences.kt"
click node_player_manager "https://github.com/mateusrodcosta/lontramusic/blob/dev/app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/data/PlayerManager.kt"
click node_playback_service "https://github.com/mateusrodcosta/lontramusic/blob/dev/app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/PlaybackService.kt"
click node_lyrics "https://github.com/mateusrodcosta/lontramusic/blob/dev/app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/data/Lyrics.kt"
click node_widget "https://github.com/mateusrodcosta/lontramusic/blob/dev/app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/MainAppWidgetReceiver.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_viewmodel,node_ui_manager,node_global_data,node_android_user toneBlue
class node_library_index,node_track_fetcher,node_playlist_manager,node_playlist_io toneAmber
class node_player_manager,node_playback_service,node_lyrics toneMint
class node_library_screen,node_player_screen,node_preferences_screen,node_preferences,node_widget toneRose
```

## Components

### App coordination

- [Main activity](https://github.com/mateusrodcosta/lontramusic/blob/dev/app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/MainActivity.kt): `app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/MainActivity.kt`
- [Main view model](https://github.com/mateusrodcosta/lontramusic/blob/dev/app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/MainViewModel.kt): `app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/MainViewModel.kt`
- [UI manager](https://github.com/mateusrodcosta/lontramusic/blob/dev/app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/UiManager.kt): `app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/UiManager.kt`
- [Shared app state](https://github.com/mateusrodcosta/lontramusic/blob/dev/app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/globals/GlobalData.kt): `app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/globals/GlobalData.kt`

### Library and playlists

- [Music library index](https://github.com/mateusrodcosta/lontramusic/blob/dev/app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/data/LibraryIndex.kt): `app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/data/LibraryIndex.kt`
- [Track fetching](https://github.com/mateusrodcosta/lontramusic/blob/dev/app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/data/TrackFetcher.kt): `app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/data/TrackFetcher.kt`
- [Playlist management](https://github.com/mateusrodcosta/lontramusic/blob/dev/app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/data/Playlist.kt): `app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/data/Playlist.kt`
- [Playlist import/export](https://github.com/mateusrodcosta/lontramusic/blob/dev/app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/ui/views/playlist/PlaylistIoScreen.kt): `app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/ui/views/playlist/PlaylistIoScreen.kt`

### Playback and lyrics

- [Player manager](https://github.com/mateusrodcosta/lontramusic/blob/dev/app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/data/PlayerManager.kt): `app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/data/PlayerManager.kt`
- [Playback service](https://github.com/mateusrodcosta/lontramusic/blob/dev/app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/PlaybackService.kt): `app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/PlaybackService.kt`
- [Lyrics handling](https://github.com/mateusrodcosta/lontramusic/blob/dev/app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/data/Lyrics.kt): `app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/data/Lyrics.kt`

### Screens and settings

- [Library browsing](https://github.com/mateusrodcosta/lontramusic/blob/dev/app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/ui/views/library/LibraryScreen.kt): `app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/ui/views/library/LibraryScreen.kt`
- [Player screen](https://github.com/mateusrodcosta/lontramusic/blob/dev/app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/ui/views/player/PlayerScreen.kt): `app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/ui/views/player/PlayerScreen.kt`
- [Preferences screen](https://github.com/mateusrodcosta/lontramusic/blob/dev/app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/ui/views/preferences/PreferencesScreen.kt): `app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/ui/views/preferences/PreferencesScreen.kt`
- [Preferences model](https://github.com/mateusrodcosta/lontramusic/blob/dev/app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/data/Preferences.kt): `app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/data/Preferences.kt`
- [Home-screen widget](https://github.com/mateusrodcosta/lontramusic/blob/dev/app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/MainAppWidgetReceiver.kt): `app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/MainAppWidgetReceiver.kt`

### Other components

- **Android user**

## Connections

- Main view model → Player manager: creates (evidence: `app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/MainViewModel.kt`)
- Main view model → UI manager: creates (evidence: `app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/MainViewModel.kt`)
- Player manager → Playback service: connects to (evidence: `app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/data/PlayerManager.kt`)
- Playlist import/export → Playlist management: adds playlists (evidence: `app/src/main/kotlin/com/mateusrodcosta/apps/lontramusic/ui/views/playlist/PlaylistIoScreen.kt`)
