# martinmimigames/tiny-music-player architecture

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

- Interactive diagram: https://gitdiagram.com/martinmimigames/tiny-music-player
- Repository: https://github.com/martinmimigames/tiny-music-player

## Overview

Tiny Music Player is an Android audio/video player controlled through a playback notification. A user selects a file in the app or opens/shares one to it; Launcher forwards the intent to the playback Service, which creates and starts AudioPlayer and publishes notification controls. Playback can also be controlled by notification actions and hardware media buttons. The excerpts show these runtime relationships; the external Android services are represented as actors, not repository modules.

Main entry points: [`app/src/main/java/com/martinmimigames/tinymusicplayer/Service.java`](https://github.com/martinmimigames/tiny-music-player/blob/main/app/src/main/java/com/martinmimigames/tinymusicplayer/Service.java) (Playback service), [`app/src/main/java/com/martinmimigames/tinymusicplayer/AudioPlayer.java`](https://github.com/martinmimigames/tiny-music-player/blob/main/app/src/main/java/com/martinmimigames/tinymusicplayer/AudioPlayer.java) (Audio player), [`app/src/main/java/com/martinmimigames/tinymusicplayer/Launcher.java`](https://github.com/martinmimigames/tiny-music-player/blob/main/app/src/main/java/com/martinmimigames/tinymusicplayer/Launcher.java) (Launcher), [`app/src/main/java/com/martinmimigames/tinymusicplayer/Notifications.java`](https://github.com/martinmimigames/tiny-music-player/blob/main/app/src/main/java/com/martinmimigames/tinymusicplayer/Notifications.java) (Notification controls)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App Entry"]
  node_launcher["Launcher<br/>[Launcher.java]"]
end

subgraph group_playback["Playback"]
  node_service["Playback service<br/>[Service.java]"]
  node_audio_player["Audio player<br/>[AudioPlayer.java]"]
  node_exceptions["Playback errors<br/>[Exceptions.java]"]
end

subgraph group_controls["Playback Controls"]
  node_notifications["Notification controls<br/>[Notifications.java]"]
  node_hardware_listener["Media button listener<br/>[HWListener.java]"]
end

node_user(("User"))
node_file_picker["Android file picker"]
node_media_player["Android MediaPlayer"]
node_notification_system["Android notifications"]
node_media_buttons(("Hardware media buttons"))

node_user -->|"selects or shares"| node_launcher
node_launcher -->|"requests audio"| node_file_picker
node_launcher -->|"forwards intent"| node_service
node_service -->|"creates and starts"| node_audio_player
node_audio_player -->|"prepares and controls"| node_media_player
node_audio_player -->|"updates state"| node_service
node_service -->|"reports playback errors"| node_exceptions
node_audio_player -->|"reports playback errors"| node_exceptions
node_service -->|"creates and updates"| node_notifications
node_notifications -->|"posts and removes"| node_notification_system
node_service -->|"initializes and updates"| node_hardware_listener
node_media_buttons -->|"sends media events"| node_hardware_listener
node_hardware_listener -->|"starts control intent"| node_service
node_notifications -->|"sends control intents"| node_service

click node_launcher "https://github.com/martinmimigames/tiny-music-player/blob/main/app/src/main/java/com/martinmimigames/tinymusicplayer/Launcher.java"
click node_service "https://github.com/martinmimigames/tiny-music-player/blob/main/app/src/main/java/com/martinmimigames/tinymusicplayer/Service.java"
click node_audio_player "https://github.com/martinmimigames/tiny-music-player/blob/main/app/src/main/java/com/martinmimigames/tinymusicplayer/AudioPlayer.java"
click node_exceptions "https://github.com/martinmimigames/tiny-music-player/blob/main/app/src/main/java/com/martinmimigames/tinymusicplayer/Exceptions.java"
click node_notifications "https://github.com/martinmimigames/tiny-music-player/blob/main/app/src/main/java/com/martinmimigames/tinymusicplayer/Notifications.java"
click node_hardware_listener "https://github.com/martinmimigames/tiny-music-player/blob/main/app/src/main/java/com/martinmimigames/tinymusicplayer/HWListener.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_launcher,node_user toneBlue
class node_service,node_audio_player,node_exceptions toneAmber
class node_notifications,node_hardware_listener toneMint
class node_file_picker,node_media_player,node_notification_system,node_media_buttons toneIndigo
```

## Components

### App Entry

- [Launcher](https://github.com/martinmimigames/tiny-music-player/blob/main/app/src/main/java/com/martinmimigames/tinymusicplayer/Launcher.java): `app/src/main/java/com/martinmimigames/tinymusicplayer/Launcher.java`

### Playback

- [Playback service](https://github.com/martinmimigames/tiny-music-player/blob/main/app/src/main/java/com/martinmimigames/tinymusicplayer/Service.java): `app/src/main/java/com/martinmimigames/tinymusicplayer/Service.java`
- [Audio player](https://github.com/martinmimigames/tiny-music-player/blob/main/app/src/main/java/com/martinmimigames/tinymusicplayer/AudioPlayer.java): `app/src/main/java/com/martinmimigames/tinymusicplayer/AudioPlayer.java`
- [Playback errors](https://github.com/martinmimigames/tiny-music-player/blob/main/app/src/main/java/com/martinmimigames/tinymusicplayer/Exceptions.java): `app/src/main/java/com/martinmimigames/tinymusicplayer/Exceptions.java`

### Playback Controls

- [Notification controls](https://github.com/martinmimigames/tiny-music-player/blob/main/app/src/main/java/com/martinmimigames/tinymusicplayer/Notifications.java): `app/src/main/java/com/martinmimigames/tinymusicplayer/Notifications.java`
- [Media button listener](https://github.com/martinmimigames/tiny-music-player/blob/main/app/src/main/java/com/martinmimigames/tinymusicplayer/HWListener.java): `app/src/main/java/com/martinmimigames/tinymusicplayer/HWListener.java`

### Other components

- **User**
- **Android file picker**
- **Android MediaPlayer**
- **Android notifications**
- **Hardware media buttons**

## Connections

- User → Launcher: selects or shares (evidence: `README.md`)
- Launcher → Android file picker: requests audio (evidence: `app/src/main/java/com/martinmimigames/tinymusicplayer/Launcher.java`)
- Launcher → Playback service: forwards intent (evidence: `app/src/main/java/com/martinmimigames/tinymusicplayer/Launcher.java`)
- Playback service → Audio player: creates and starts (evidence: `app/src/main/java/com/martinmimigames/tinymusicplayer/Service.java`)
- Audio player → Android MediaPlayer: prepares and controls (evidence: `app/src/main/java/com/martinmimigames/tinymusicplayer/AudioPlayer.java`)
- Audio player → Playback service: updates state (evidence: `app/src/main/java/com/martinmimigames/tinymusicplayer/AudioPlayer.java`)
- Playback service → Playback errors: reports playback errors (evidence: `app/src/main/java/com/martinmimigames/tinymusicplayer/Service.java`)
- Audio player → Playback errors: reports playback errors (evidence: `app/src/main/java/com/martinmimigames/tinymusicplayer/AudioPlayer.java`)
- Playback service → Notification controls: creates and updates (evidence: `app/src/main/java/com/martinmimigames/tinymusicplayer/Service.java`)
- Notification controls → Android notifications: posts and removes (evidence: `app/src/main/java/com/martinmimigames/tinymusicplayer/Notifications.java`)
- Playback service → Media button listener: initializes and updates (evidence: `app/src/main/java/com/martinmimigames/tinymusicplayer/Service.java`)
- Hardware media buttons → Media button listener: sends media events (evidence: `app/src/main/java/com/martinmimigames/tinymusicplayer/HWListener.java`)
- Media button listener → Playback service: starts control intent (evidence: `app/src/main/java/com/martinmimigames/tinymusicplayer/HWListener.java`)
- Notification controls → Playback service: sends control intents (evidence: `app/src/main/java/com/martinmimigames/tinymusicplayer/Notifications.java`)
