# zerodayz77/my-music-app-tempo- architecture

> Architecture diagram of the GitHub repository zerodayz77/my-music-app-tempo-, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/zerodayz77/my-music-app-tempo-
- Repository: https://github.com/zerodayz77/my-music-app-tempo-

## Overview

##### Project type and purpose
- This is a native Android mobile application (Java/Kotlin) whose purpose is to let users browse, play, control and organize local audio files (.mp3/.wav) on their device. It includes Activities for UI, Services for background playback and notifications, and a local database for playlists.

##### File structure
- Top-level directories:
- .github/workflows – CI (runs android.yml)
- app – Android Studio module
- gradle & gradlew – build tool
- app/src/main/java/com/example/tempo:
- Activities: MainActivity, BottomToolbarActivity, MusicPlayerActivity, PlaylistsActivity
- Data models/interfaces: Playable, Playlist
- Database: TempoSongPlaylistDatabase (Room/SQLite)
- Services: NotificationActionService, OnClearRecentService
- Notification creation: CreateMusicNotification
- app/src/main/res:
- xml definitions for backup, data extraction
- Test folders for unit and instrumented tests

##### Key insights from the README
- MVP completed in 2 weeks as a learning challenge
- Functional requirements: scan local audio, metadata display, playback controls (play/pause/skip/shuffle/repeat), offline support, persistent playback via Services and notifications
- Non-functional: song highlighting, share, playlists, theming, search/filter, headphone detection

## Diagram (Mermaid)

```mermaid
flowchart TD
  subgraph "Presentation Layer"
    MainActivity["MainActivity"]:::ui
    BottomToolbarActivity["BottomToolbarActivity"]:::ui
    MusicPlayerActivity["MusicPlayerActivity"]:::ui
    PlaylistsActivity["PlaylistsActivity"]:::ui
    activity_main["activity_main.xml"]:::ui
    activity_music_player["activity_music_player.xml"]:::ui
    activity_playlists["activity_playlists.xml"]:::ui
    bottom_tool_bar["bottom_tool_bar.xml"]:::ui
    appbar["appbar.xml"]:::ui
    song_list_names["song_list_names.xml"]:::ui
    bottomtoolbarmenu["bottomtoolbarmenu.xml"]:::ui
    menu["menu.xml"]:::ui
  end

  subgraph "Service Layer"
    NotificationActionService["NotificationActionService"]:::service
    OnClearRecentService["OnClearRecentService"]:::service
    MusicPlayerService["MusicPlayerService"]:::service
  end

  subgraph "Notification Manager"
    CreateMusicNotification["CreateMusicNotification"]:::service
  end

  subgraph "Data Layer"
    TempoSongPlaylistDatabase["TempoSongPlaylistDatabase"]:::data
    Playable["Playable"]:::data
    Playlist["Playlist"]:::data
  end

  subgraph "File System"
    MediaStore["MediaStore / File I/O"]:::framework
  end

  subgraph "Android Framework"
    MediaSession["MediaSession"]:::framework
    BroadcastReceiver["BroadcastReceivers"]:::framework
    AudioManager["AudioManager"]:::framework
    NotificationChannel["Notification Channels"]:::framework
  end

  MainActivity -->|scan request| MediaStore
  MediaStore -->|scan results| MainActivity
  MainActivity -->|"play/pause/skip"| MusicPlayerService
  BottomToolbarActivity -->|"controls"| MusicPlayerService
  MusicPlayerActivity -->|"playback commands"| MusicPlayerService
  PlaylistsActivity -->|"CRUD playlists"| TempoSongPlaylistDatabase
  MusicPlayerService -->|"persist playlists"| TempoSongPlaylistDatabase
  MusicPlayerService -->|"notify"| CreateMusicNotification
  CreateMusicNotification -->|"send via"| NotificationChannel
  CreateMusicNotification --> NotificationActionService
  NotificationActionService -->|"action commands"| MusicPlayerService
  BroadcastReceiver -->|"events"| MusicPlayerService
  MusicPlayerService -->|"update"| MediaSession
  MusicPlayerService -->|"audio focus"| AudioManager
  PlaylistsActivity --> Playlist
  MusicPlayerService --> Playable

  click MainActivity "https://github.com/zerodayz77/my-music-app-tempo-/blob/master/app/src/main/java/com/example/tempo/MainActivity.java"
  click BottomToolbarActivity "https://github.com/zerodayz77/my-music-app-tempo-/blob/master/app/src/main/java/com/example/tempo/BottomToolbarActivity.java"
  click MusicPlayerActivity "https://github.com/zerodayz77/my-music-app-tempo-/blob/master/app/src/main/java/com/example/tempo/MusicPlayerActivity.java"
  click PlaylistsActivity "https://github.com/zerodayz77/my-music-app-tempo-/blob/master/app/src/main/java/com/example/tempo/PlaylistsActivity.java"
  click activity_main "https://github.com/zerodayz77/my-music-app-tempo-/blob/master/app/src/main/res/layout/activity_main.xml"
  click activity_music_player "https://github.com/zerodayz77/my-music-app-tempo-/blob/master/app/src/main/res/layout/activity_music_player.xml"
  click activity_playlists "https://github.com/zerodayz77/my-music-app-tempo-/blob/master/app/src/main/res/layout/activity_playlists.xml"
  click bottom_tool_bar "https://github.com/zerodayz77/my-music-app-tempo-/blob/master/app/src/main/res/layout/bottom_tool_bar.xml"
  click appbar "https://github.com/zerodayz77/my-music-app-tempo-/blob/master/app/src/main/res/layout/appbar.xml"
  click song_list_names "https://github.com/zerodayz77/my-music-app-tempo-/blob/master/app/src/main/res/layout/song_list_names.xml"
  click bottomtoolbarmenu "https://github.com/zerodayz77/my-music-app-tempo-/blob/master/app/src/main/res/menu/bottomtoolbarmenu.xml"
  click menu "https://github.com/zerodayz77/my-music-app-tempo-/blob/master/app/src/main/res/menu/menu.xml"
  click NotificationActionService "https://github.com/zerodayz77/my-music-app-tempo-/blob/master/app/src/main/java/com/example/tempo/Services/NotificationActionService.java"
  click OnClearRecentService "https://github.com/zerodayz77/my-music-app-tempo-/blob/master/app/src/main/java/com/example/tempo/Services/OnClearRecentService.java"
  click CreateMusicNotification "https://github.com/zerodayz77/my-music-app-tempo-/blob/master/app/src/main/java/com/example/tempo/CreateMusicNotification.java"
  click TempoSongPlaylistDatabase "https://github.com/zerodayz77/my-music-app-tempo-/blob/master/app/src/main/java/com/example/tempo/TempoSongPlaylistDatabase.java"
  click Playable "https://github.com/zerodayz77/my-music-app-tempo-/blob/master/app/src/main/java/com/example/tempo/Playable.java"
  click Playlist "https://github.com/zerodayz77/my-music-app-tempo-/blob/master/app/src/main/java/com/example/tempo/Playlist.java"

  classDef ui fill:#daf1ff,stroke:#0366d6,color:#0366d6;
  classDef service fill:#dfffe0,stroke:#228b22,color:#228b22;
  classDef data fill:#ffe7c4,stroke:#ff8c00,color:#ff8c00;
  classDef framework fill:#e0e0e0,stroke:#a9a9a9,color:#555;
```
