# pordohiq/my.little.audio.player.android architecture

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

- Interactive diagram: https://gitdiagram.com/pordohiq/my.little.audio.player.android
- Repository: https://github.com/pordohiq/my.little.audio.player.android

## Overview

This native Android audio player organizes local audio in a folder-oriented resource tree, letting users browse files, manage library contents and queues, and play tracks with repeat and shuffle controls. The main app initializes shared playback state and exposes browsing and actions through its UI; an Android media service provides playback and media-library integration. The graph preserves documented folder browsing and major source-indexed subsystems. Some links are omitted where the excerpts and index do not establish who invokes whom; unsampled implementation details are not assumed.

Main entry points: [`app/src/main/java/my/little/audio/player/android/ResTree/ResTree.java`](https://github.com/pordohiq/my.little.audio.player.android/blob/master/app/src/main/java/my/little/audio/player/android/ResTree/ResTree.java) (Library tree and file operations), [`app/src/main/java/my/little/audio/player/android/queues/Queues.java`](https://github.com/pordohiq/my.little.audio.player.android/blob/master/app/src/main/java/my/little/audio/player/android/queues/Queues.java) (Queue manager), [`app/src/main/java/my/little/audio/player/android/Main.java`](https://github.com/pordohiq/my.little.audio.player.android/blob/master/app/src/main/java/my/little/audio/player/android/Main.java) (App entry), [`app/src/main/java/my/little/audio/player/android/Global.java`](https://github.com/pordohiq/my.little.audio.player.android/blob/master/app/src/main/java/my/little/audio/player/android/Global.java) (Playback coordinator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and UI"]
  node_main["App entry<br/>[Main.java]"]
  node_fileview["Library browser<br/>[FileView.java]"]
  node_fileblocks["File and queue blocks"]
  node_preferences["Preferences<br/>[Preferences.java]"]
  node_fileinfo["Audio and queue details"]
  node_actionbar["Action bar<br/>[ActionBar.java]"]
  node_signals["Event signals<br/>[Signals.java]"]
end

subgraph group_library["Audio library"]
  node_restree["Library tree and file operations<br/>[ResTree.java]"]
  node_directory["Directory model<br/>[Directory.java]"]
  node_diskelement["Library element model<br/>[DiskElement.java]"]
  node_music["Track model<br/>[Music.java]"]
end

subgraph group_playback["Playback"]
  node_global["Playback coordinator<br/>[Global.java]"]
  node_service["Media library service<br/>[AudioService.java]"]
  node_mixing["Repeat and shuffle state<br/>[MixingState.java]"]
end

subgraph group_interaction["Queues and actions"]
  node_actions["User actions<br/>[Action.java]"]
  node_queues["Queue manager<br/>[Queues.java]"]
  node_queue["Saved queue<br/>[Queue.java]"]
  node_folderqueue["Folder queue<br/>[FolderQueue.java]"]
end

node_user(("Listener"))

node_user -->|"opens"| node_main
node_main -->|"initializes"| node_global
node_main -->|"initializes"| node_restree
node_main -->|"opens"| node_preferences
node_fileview -->|"reads tree"| node_restree
node_fileview -->|"reads queues"| node_queues
node_fileview -->|"renders"| node_fileblocks
node_fileblocks -->|"invokes"| node_actions
node_actionbar -->|"dispatches"| node_actions
node_actions -->|"modifies library"| node_restree
node_actions -->|"emits events"| node_signals
node_restree -->|"builds tree"| node_directory
node_restree -->|"uses elements"| node_diskelement
node_restree -->|"creates tracks"| node_music
node_global -->|"connects controller"| node_service
node_service -->|"serves media items"| node_restree
node_global -->|"gets next track"| node_queues
node_global -->|"checks playback mode"| node_mixing
node_queues -->|"manages"| node_queue
node_queues -->|"creates"| node_folderqueue
node_queues -->|"resolves tracks"| node_restree
node_queue -->|"resolves paths"| node_restree
node_mixing -->|"emits state change"| node_signals
node_fileinfo -->|"reads track details"| node_restree
node_fileinfo -->|"reads queue details"| node_queues
node_signals -->|"refreshes view"| node_fileview

click node_main "https://github.com/pordohiq/my.little.audio.player.android/blob/master/app/src/main/java/my/little/audio/player/android/Main.java"
click node_fileview "https://github.com/pordohiq/my.little.audio.player.android/blob/master/app/src/main/java/my/little/audio/player/android/FileView/FileView.java"
click node_fileblocks "https://github.com/pordohiq/my.little.audio.player.android/tree/master/app/src/main/java/my/little/audio/player/android/FileView"
click node_preferences "https://github.com/pordohiq/my.little.audio.player.android/blob/master/app/src/main/java/my/little/audio/player/android/Preferences.java"
click node_fileinfo "https://github.com/pordohiq/my.little.audio.player.android/tree/master/app/src/main/java/my/little/audio/player/android/fileInfo"
click node_actions "https://github.com/pordohiq/my.little.audio.player.android/blob/master/app/src/main/java/my/little/audio/player/android/Action/Action.java"
click node_actionbar "https://github.com/pordohiq/my.little.audio.player.android/blob/master/app/src/main/java/my/little/audio/player/android/Action/ActionBar.java"
click node_restree "https://github.com/pordohiq/my.little.audio.player.android/blob/master/app/src/main/java/my/little/audio/player/android/ResTree/ResTree.java"
click node_directory "https://github.com/pordohiq/my.little.audio.player.android/blob/master/app/src/main/java/my/little/audio/player/android/ResTree/Directory.java"
click node_diskelement "https://github.com/pordohiq/my.little.audio.player.android/blob/master/app/src/main/java/my/little/audio/player/android/ResTree/DiskElement.java"
click node_music "https://github.com/pordohiq/my.little.audio.player.android/blob/master/app/src/main/java/my/little/audio/player/android/ResTree/Music.java"
click node_global "https://github.com/pordohiq/my.little.audio.player.android/blob/master/app/src/main/java/my/little/audio/player/android/Global.java"
click node_service "https://github.com/pordohiq/my.little.audio.player.android/blob/master/app/src/main/java/my/little/audio/player/android/AudioService.java"
click node_mixing "https://github.com/pordohiq/my.little.audio.player.android/blob/master/app/src/main/java/my/little/audio/player/android/MixingState.java"
click node_queues "https://github.com/pordohiq/my.little.audio.player.android/blob/master/app/src/main/java/my/little/audio/player/android/queues/Queues.java"
click node_queue "https://github.com/pordohiq/my.little.audio.player.android/blob/master/app/src/main/java/my/little/audio/player/android/queues/Queue.java"
click node_folderqueue "https://github.com/pordohiq/my.little.audio.player.android/blob/master/app/src/main/java/my/little/audio/player/android/queues/FolderQueue.java"
click node_signals "https://github.com/pordohiq/my.little.audio.player.android/blob/master/app/src/main/java/my/little/audio/player/android/Signals.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_fileview,node_fileblocks,node_preferences,node_fileinfo,node_actionbar,node_signals toneBlue
class node_restree,node_directory,node_diskelement,node_music toneAmber
class node_global,node_service,node_mixing toneMint
class node_actions,node_queues,node_queue,node_folderqueue toneRose
class node_user toneIndigo
```

## Components

### App and UI

- [App entry](https://github.com/pordohiq/my.little.audio.player.android/blob/master/app/src/main/java/my/little/audio/player/android/Main.java): `app/src/main/java/my/little/audio/player/android/Main.java`
- [Library browser](https://github.com/pordohiq/my.little.audio.player.android/blob/master/app/src/main/java/my/little/audio/player/android/FileView/FileView.java): `app/src/main/java/my/little/audio/player/android/FileView/FileView.java`
- [File and queue blocks](https://github.com/pordohiq/my.little.audio.player.android/tree/master/app/src/main/java/my/little/audio/player/android/FileView): `app/src/main/java/my/little/audio/player/android/FileView`
- [Preferences](https://github.com/pordohiq/my.little.audio.player.android/blob/master/app/src/main/java/my/little/audio/player/android/Preferences.java): `app/src/main/java/my/little/audio/player/android/Preferences.java`
- [Audio and queue details](https://github.com/pordohiq/my.little.audio.player.android/tree/master/app/src/main/java/my/little/audio/player/android/fileInfo): `app/src/main/java/my/little/audio/player/android/fileInfo`
- [Action bar](https://github.com/pordohiq/my.little.audio.player.android/blob/master/app/src/main/java/my/little/audio/player/android/Action/ActionBar.java): `app/src/main/java/my/little/audio/player/android/Action/ActionBar.java`
- [Event signals](https://github.com/pordohiq/my.little.audio.player.android/blob/master/app/src/main/java/my/little/audio/player/android/Signals.java): `app/src/main/java/my/little/audio/player/android/Signals.java`

### Audio library

- [Library tree and file operations](https://github.com/pordohiq/my.little.audio.player.android/blob/master/app/src/main/java/my/little/audio/player/android/ResTree/ResTree.java): `app/src/main/java/my/little/audio/player/android/ResTree/ResTree.java`
- [Directory model](https://github.com/pordohiq/my.little.audio.player.android/blob/master/app/src/main/java/my/little/audio/player/android/ResTree/Directory.java): `app/src/main/java/my/little/audio/player/android/ResTree/Directory.java`
- [Library element model](https://github.com/pordohiq/my.little.audio.player.android/blob/master/app/src/main/java/my/little/audio/player/android/ResTree/DiskElement.java): `app/src/main/java/my/little/audio/player/android/ResTree/DiskElement.java`
- [Track model](https://github.com/pordohiq/my.little.audio.player.android/blob/master/app/src/main/java/my/little/audio/player/android/ResTree/Music.java): `app/src/main/java/my/little/audio/player/android/ResTree/Music.java`

### Playback

- [Playback coordinator](https://github.com/pordohiq/my.little.audio.player.android/blob/master/app/src/main/java/my/little/audio/player/android/Global.java): `app/src/main/java/my/little/audio/player/android/Global.java`
- [Media library service](https://github.com/pordohiq/my.little.audio.player.android/blob/master/app/src/main/java/my/little/audio/player/android/AudioService.java): `app/src/main/java/my/little/audio/player/android/AudioService.java`
- [Repeat and shuffle state](https://github.com/pordohiq/my.little.audio.player.android/blob/master/app/src/main/java/my/little/audio/player/android/MixingState.java): `app/src/main/java/my/little/audio/player/android/MixingState.java`

### Queues and actions

- [User actions](https://github.com/pordohiq/my.little.audio.player.android/blob/master/app/src/main/java/my/little/audio/player/android/Action/Action.java): `app/src/main/java/my/little/audio/player/android/Action/Action.java`
- [Queue manager](https://github.com/pordohiq/my.little.audio.player.android/blob/master/app/src/main/java/my/little/audio/player/android/queues/Queues.java): `app/src/main/java/my/little/audio/player/android/queues/Queues.java`
- [Saved queue](https://github.com/pordohiq/my.little.audio.player.android/blob/master/app/src/main/java/my/little/audio/player/android/queues/Queue.java): `app/src/main/java/my/little/audio/player/android/queues/Queue.java`
- [Folder queue](https://github.com/pordohiq/my.little.audio.player.android/blob/master/app/src/main/java/my/little/audio/player/android/queues/FolderQueue.java): `app/src/main/java/my/little/audio/player/android/queues/FolderQueue.java`

### Other components

- **Listener**

## Connections

- Listener → App entry: opens (evidence: `README.md`)
- App entry → Playback coordinator: initializes (evidence: `app/src/main/java/my/little/audio/player/android/Main.java`)
- App entry → Library tree and file operations: initializes (evidence: `app/src/main/java/my/little/audio/player/android/Main.java`)
- App entry → Preferences: opens (evidence: `app/src/main/java/my/little/audio/player/android/Main.java`)
- Library browser → Library tree and file operations: reads tree (evidence: `app/src/main/java/my/little/audio/player/android/FileView/FileView.java`)
- Library browser → Queue manager: reads queues (evidence: `app/src/main/java/my/little/audio/player/android/FileView/FileView.java`)
- Library browser → File and queue blocks: renders (evidence: `app/src/main/java/my/little/audio/player/android/FileView/FileView.java`)
- File and queue blocks → User actions: invokes (evidence: `app/src/main/java/my/little/audio/player/android/FileView/MusicBlock.java`)
- Action bar → User actions: dispatches (evidence: `app/src/main/java/my/little/audio/player/android/Action/ActionBar.java`)
- User actions → Library tree and file operations: modifies library (evidence: `app/src/main/java/my/little/audio/player/android/Action/Action.java`)
- User actions → Event signals: emits events (evidence: `app/src/main/java/my/little/audio/player/android/Action/Action.java`)
- Library tree and file operations → Directory model: builds tree (evidence: `app/src/main/java/my/little/audio/player/android/ResTree/ResTree.java`)
- Library tree and file operations → Library element model: uses elements (evidence: `app/src/main/java/my/little/audio/player/android/ResTree/ResTree.java`)
- Library tree and file operations → Track model: creates tracks (evidence: `app/src/main/java/my/little/audio/player/android/ResTree/ResTree.java`)
- Playback coordinator → Media library service: connects controller (evidence: `app/src/main/java/my/little/audio/player/android/Global.java`)
- Media library service → Library tree and file operations: serves media items (evidence: `app/src/main/java/my/little/audio/player/android/AudioService.java`)
- Playback coordinator → Queue manager: gets next track (evidence: `app/src/main/java/my/little/audio/player/android/Global.java`)
- Playback coordinator → Repeat and shuffle state: checks playback mode (evidence: `app/src/main/java/my/little/audio/player/android/Global.java`)
- Queue manager → Saved queue: manages (evidence: `app/src/main/java/my/little/audio/player/android/queues/Queues.java`)
- Queue manager → Folder queue: creates (evidence: `app/src/main/java/my/little/audio/player/android/queues/Queues.java`)
- Queue manager → Library tree and file operations: resolves tracks (evidence: `app/src/main/java/my/little/audio/player/android/queues/Queues.java`)
- Saved queue → Library tree and file operations: resolves paths (evidence: `app/src/main/java/my/little/audio/player/android/queues/Queue.java`)
- Repeat and shuffle state → Event signals: emits state change (evidence: `app/src/main/java/my/little/audio/player/android/MixingState.java`)
- Audio and queue details → Library tree and file operations: reads track details (evidence: `app/src/main/java/my/little/audio/player/android/fileInfo/fileInfoAudio.java`)
- Audio and queue details → Queue manager: reads queue details (evidence: `app/src/main/java/my/little/audio/player/android/fileInfo/fileInfoQueue.java`)
- Event signals → Library browser: refreshes view (evidence: `app/src/main/java/my/little/audio/player/android/FileView/FileView.java`)
