# benchtadeo30/mvpplay architecture

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

- Interactive diagram: https://gitdiagram.com/benchtadeo30/mvpplay
- Repository: https://github.com/benchtadeo30/mvpplay

## Overview

MVPPlay is an Android music and podcast player with a local library, playlists, search, playback controls, lyrics and themed presentation. The main flow is browsing or searching the library, selecting a song or episode, and controlling playback through the player screens. The graph includes the core indexed modules and major domain areas visible in the tree. README content is absent, and unsampled modules are represented only where their names and relationships are supported by the source index; edges are limited to shown references or calls.

Main entry points: [`MVPPlay/app/src/main/java/com/appdev/mvpplay/MusicLibrary.java`](https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/MusicLibrary.java) (Music catalog), [`MVPPlay/app/src/main/java/com/appdev/mvpplay/PlayerConnection.java`](https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/PlayerConnection.java) (Player connection), [`MVPPlay/app/src/main/java/com/appdev/mvpplay/PlaylistActivity.java`](https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/PlaylistActivity.java) (Playlist screen), [`MVPPlay/app/src/main/java/com/appdev/mvpplay/SettingsActivity.java`](https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/SettingsActivity.java) (Settings screen)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["App screens"]
  node_main["Home screen<br/>[MainActivity.java]"]
  node_libraryscreen["Library screen"]
  node_search["Search screen"]
  node_playlistactivity["Playlist screen"]
  node_nowplaying["Now Playing"]
  node_settings["Settings screen"]
  node_base["Screen base<br/>[BaseActivity.java]"]
  node_nav["Bottom navigation<br/>[BottomNav.java]"]
  node_anim["UI animation<br/>[Anim.java]"]
end

subgraph group_catalog["Library and playlists"]
  node_library["Music catalog<br/>[MusicLibrary.java]"]
  node_playlists["Playlist model<br/>[Playlist.java]"]
  node_playlistdialogs["Playlist dialogs"]
  node_searchdata["Playlist catalog"]
end

subgraph group_playback["Playback"]
  node_connection["Player connection"]
  node_service["Playback service"]
end

subgraph group_data["Local data"]
  node_settingsdata["App settings<br/>[AppSettings.java]"]
  node_customsongs[("Custom songs")]
  node_customplaylists[("Custom playlists")]
  node_favorites[("Favorites")]
  node_podcasts[("Custom podcasts")]
end

node_user(("Listener"))

node_user -->|"browses"| node_main
node_main -->|"loads catalog"| node_library
node_main -->|"starts playback"| node_connection
node_main -->|"opens dialogs"| node_playlistdialogs
node_libraryscreen -->|"loads catalog"| node_library
node_search -->|"searches songs"| node_library
node_playlistactivity -->|"starts queue"| node_connection
node_playlistactivity -->|"opens player"| node_nowplaying
node_playlistactivity -->|"removes songs"| node_customplaylists
node_playlistactivity -->|"deletes songs"| node_customsongs
node_nowplaying -->|"controls playback"| node_connection
node_connection -->|"connects session"| node_service
node_library -->|"loads additions"| node_customsongs
node_library -->|"applies sorting"| node_settingsdata
node_library -.->|"filters hidden songs"| node_favorites
node_playlistdialogs -->|"creates playlists"| node_customplaylists
node_settings -->|"configures settings"| node_settingsdata
node_settings -->|"manages playlists"| node_customplaylists
node_settings -->|"manages favorites"| node_favorites
node_settings -->|"manages podcasts"| node_podcasts
node_base -.->|"applies theme"| node_settingsdata
node_nav -->|"controls mini player"| node_connection

click node_main "https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/MainActivity.java"
click node_libraryscreen "https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/LibraryActivity.java"
click node_search "https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/SearchActivity.java"
click node_playlistactivity "https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/PlaylistActivity.java"
click node_nowplaying "https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/NowPlayingActivity.java"
click node_settings "https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/SettingsActivity.java"
click node_base "https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/BaseActivity.java"
click node_nav "https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/BottomNav.java"
click node_anim "https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/Anim.java"
click node_library "https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/MusicLibrary.java"
click node_playlists "https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/Playlist.java"
click node_playlistdialogs "https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/PlaylistDialogs.java"
click node_searchdata "https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/PlaylistLibrary.java"
click node_connection "https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/PlayerConnection.java"
click node_service "https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/PlaybackService.java"
click node_settingsdata "https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/AppSettings.java"
click node_customsongs "https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/CustomSongStore.java"
click node_customplaylists "https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/CustomPlaylistStore.java"
click node_favorites "https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/FavoritesStore.java"
click node_podcasts "https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/CustomPodcastStore.java"

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_main,node_libraryscreen,node_search,node_playlistactivity,node_nowplaying,node_settings,node_base,node_nav,node_anim toneBlue
class node_library,node_playlists,node_playlistdialogs,node_searchdata toneAmber
class node_connection,node_service toneMint
class node_settingsdata,node_customsongs,node_customplaylists,node_favorites,node_podcasts toneRose
class node_user toneIndigo
```

## Components

### App screens

- [Home screen](https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/MainActivity.java): `MVPPlay/app/src/main/java/com/appdev/mvpplay/MainActivity.java`
- [Library screen](https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/LibraryActivity.java): `MVPPlay/app/src/main/java/com/appdev/mvpplay/LibraryActivity.java`
- [Search screen](https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/SearchActivity.java): `MVPPlay/app/src/main/java/com/appdev/mvpplay/SearchActivity.java`
- [Playlist screen](https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/PlaylistActivity.java): `MVPPlay/app/src/main/java/com/appdev/mvpplay/PlaylistActivity.java`
- [Now Playing](https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/NowPlayingActivity.java): `MVPPlay/app/src/main/java/com/appdev/mvpplay/NowPlayingActivity.java`
- [Settings screen](https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/SettingsActivity.java): `MVPPlay/app/src/main/java/com/appdev/mvpplay/SettingsActivity.java`
- [Screen base](https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/BaseActivity.java): `MVPPlay/app/src/main/java/com/appdev/mvpplay/BaseActivity.java`
- [Bottom navigation](https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/BottomNav.java): `MVPPlay/app/src/main/java/com/appdev/mvpplay/BottomNav.java`
- [UI animation](https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/Anim.java): `MVPPlay/app/src/main/java/com/appdev/mvpplay/Anim.java`

### Library and playlists

- [Music catalog](https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/MusicLibrary.java): `MVPPlay/app/src/main/java/com/appdev/mvpplay/MusicLibrary.java`
- [Playlist model](https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/Playlist.java): `MVPPlay/app/src/main/java/com/appdev/mvpplay/Playlist.java`
- [Playlist dialogs](https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/PlaylistDialogs.java): `MVPPlay/app/src/main/java/com/appdev/mvpplay/PlaylistDialogs.java`
- [Playlist catalog](https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/PlaylistLibrary.java): `MVPPlay/app/src/main/java/com/appdev/mvpplay/PlaylistLibrary.java`

### Playback

- [Player connection](https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/PlayerConnection.java): `MVPPlay/app/src/main/java/com/appdev/mvpplay/PlayerConnection.java`
- [Playback service](https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/PlaybackService.java): `MVPPlay/app/src/main/java/com/appdev/mvpplay/PlaybackService.java`

### Local data

- [App settings](https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/AppSettings.java): `MVPPlay/app/src/main/java/com/appdev/mvpplay/AppSettings.java`
- [Custom songs](https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/CustomSongStore.java): `MVPPlay/app/src/main/java/com/appdev/mvpplay/CustomSongStore.java`
- [Custom playlists](https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/CustomPlaylistStore.java): `MVPPlay/app/src/main/java/com/appdev/mvpplay/CustomPlaylistStore.java`
- [Favorites](https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/FavoritesStore.java): `MVPPlay/app/src/main/java/com/appdev/mvpplay/FavoritesStore.java`
- [Custom podcasts](https://github.com/benchtadeo30/mvpplay/blob/main/MVPPlay/app/src/main/java/com/appdev/mvpplay/CustomPodcastStore.java): `MVPPlay/app/src/main/java/com/appdev/mvpplay/CustomPodcastStore.java`

### Other components

- **Listener**

## Connections

- Listener → Home screen: browses
- Home screen → Music catalog: loads catalog (evidence: `MVPPlay/app/src/main/java/com/appdev/mvpplay/MainActivity.java`)
- Home screen → Player connection: starts playback (evidence: `MVPPlay/app/src/main/java/com/appdev/mvpplay/MainActivity.java`)
- Home screen → Playlist dialogs: opens dialogs (evidence: `MVPPlay/app/src/main/java/com/appdev/mvpplay/MainActivity.java`)
- Library screen → Music catalog: loads catalog (evidence: `MVPPlay/app/src/main/java/com/appdev/mvpplay/LibraryActivity.java`)
- Search screen → Music catalog: searches songs (evidence: `MVPPlay/app/src/main/java/com/appdev/mvpplay/SearchActivity.java`)
- Playlist screen → Player connection: starts queue (evidence: `MVPPlay/app/src/main/java/com/appdev/mvpplay/PlaylistActivity.java`)
- Playlist screen → Now Playing: opens player (evidence: `MVPPlay/app/src/main/java/com/appdev/mvpplay/PlaylistActivity.java`)
- Playlist screen → Custom playlists: removes songs (evidence: `MVPPlay/app/src/main/java/com/appdev/mvpplay/PlaylistActivity.java`)
- Playlist screen → Custom songs: deletes songs (evidence: `MVPPlay/app/src/main/java/com/appdev/mvpplay/PlaylistActivity.java`)
- Now Playing → Player connection: controls playback (evidence: `MVPPlay/app/src/main/java/com/appdev/mvpplay/NowPlayingActivity.java`)
- Player connection → Playback service: connects session (evidence: `MVPPlay/app/src/main/java/com/appdev/mvpplay/PlayerConnection.java`)
- Music catalog → Custom songs: loads additions (evidence: `MVPPlay/app/src/main/java/com/appdev/mvpplay/MusicLibrary.java`)
- Music catalog → App settings: applies sorting (evidence: `MVPPlay/app/src/main/java/com/appdev/mvpplay/MusicLibrary.java`)
- Music catalog → Favorites: filters hidden songs
- Playlist dialogs → Custom playlists: creates playlists (evidence: `MVPPlay/app/src/main/java/com/appdev/mvpplay/PlaylistDialogs.java`)
- Settings screen → App settings: configures settings (evidence: `MVPPlay/app/src/main/java/com/appdev/mvpplay/SettingsActivity.java`)
- Settings screen → Custom playlists: manages playlists (evidence: `MVPPlay/app/src/main/java/com/appdev/mvpplay/SettingsActivity.java`)
- Settings screen → Favorites: manages favorites (evidence: `MVPPlay/app/src/main/java/com/appdev/mvpplay/SettingsActivity.java`)
- Settings screen → Custom podcasts: manages podcasts (evidence: `MVPPlay/app/src/main/java/com/appdev/mvpplay/SettingsActivity.java`)
- Screen base → App settings: applies theme
- Bottom navigation → Player connection: controls mini player (evidence: `MVPPlay/app/src/main/java/com/appdev/mvpplay/BottomNav.java`)
