# kiptunor/pianofromabove-android architecture

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

- Interactive diagram: https://gitdiagram.com/kiptunor/pianofromabove-android
- Repository: https://github.com/kiptunor/pianofromabove-android

## Overview

NVirsual Piano From Above is a cross-platform MIDI piano-roll visualizer. The main runtime initializes settings and audio, then starts the visualizer loop; users select a MIDI and soundfonts, control playback, and see notes rendered against a keyboard and timing grid. The code also supports configurable themes, colors, background imagery, file lists/history, and video export. The graph reflects sampled calls and README capabilities; UI-to-playback interactions and several unsampled feature implementations are not directly shown, so those links are marked unverified or omitted.

Main entry points: [`src/render/ui.cpp`](https://github.com/kiptunor/pianofromabove-android/blob/main/src/render/ui.cpp) (Controls and Themes), [`src/main.cpp`](https://github.com/kiptunor/pianofromabove-android/blob/main/src/main.cpp) (Application Entry), [`src/audio/playback.cpp`](https://github.com/kiptunor/pianofromabove-android/blob/main/src/audio/playback.cpp) (Audio Playback), [`src/visualizer_handler.cpp`](https://github.com/kiptunor/pianofromabove-android/blob/main/src/visualizer_handler.cpp) (Visualizer Loop)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime and UI"]
  node_entry["Application Entry<br/>[main.cpp]"]
  node_visualizer["Visualizer Loop"]
  node_ui["Controls and Themes<br/>[ui.cpp]"]
  node_imgui["Dear ImGui<br/>[imgui.h]"]
  node_file_dialog["File Dialog"]
  node_log["Logging<br/>[logger.cpp]"]
end

subgraph group_midi["MIDI and Playback"]
  node_playback["Audio Playback<br/>[playback.cpp]"]
  node_bass["BASS MIDI Audio<br/>[bassmidi.h]"]
  node_midi_list["MIDI Parsing and Notes<br/>[list.cpp]"]
  node_audio_fx["Audio Effects<br/>[audio_effects.cpp]"]
end

subgraph group_visual["Visualization"]
  node_renderer["Piano Roll Renderer<br/>[render.cpp]"]
  node_note_buffer["Note Buffer<br/>[note_buffer.cpp]"]
end

subgraph group_settings["Settings and Files"]
  node_config["Configuration<br/>[config.cpp]"]
  node_midi_provider["MIDI List Provider<br/>[midi_list.cpp]"]
  node_soundfont_provider["Soundfont Provider<br/>[soundfont_list.cpp]"]
  node_color_presets["Channel Color Presets<br/>[channel_colors.cpp]"]
  node_dialog_state["File Dialog State"]
  node_file_helpers["File Helpers<br/>[file_helpers.cpp]"]
end

subgraph group_export["Video Export"]
  node_exporter["Video Exporter<br/>[exporter.cpp]"]
end

node_user(("User"))

node_user -.->|"operates"| node_ui
node_entry -->|"loads"| node_config
node_entry -->|"loads"| node_midi_provider
node_entry -->|"loads"| node_soundfont_provider
node_entry -->|"starts"| node_visualizer
node_entry -->|"initializes audio"| node_playback
node_playback -->|"parses MIDI"| node_midi_list
node_playback -->|"creates streams"| node_bass
node_playback -.->|"applies effects"| node_audio_fx
node_visualizer -->|"updates state"| node_playback
node_visualizer -->|"draws frame"| node_renderer
node_visualizer -->|"buffers notes"| node_note_buffer
node_visualizer -->|"captures audio"| node_exporter
node_ui -.->|"builds controls"| node_imgui
node_ui -.->|"controls playback"| node_playback
node_ui -.->|"opens picker"| node_file_dialog
node_ui -.->|"edits settings"| node_config
node_ui -.->|"selects presets"| node_color_presets
node_ui -.->|"requests export"| node_exporter
node_dialog_state -->|"uses paths"| node_file_helpers
node_entry -->|"configures logging"| node_log

click node_entry "https://github.com/kiptunor/pianofromabove-android/blob/main/src/main.cpp"
click node_visualizer "https://github.com/kiptunor/pianofromabove-android/blob/main/src/visualizer_handler.cpp"
click node_ui "https://github.com/kiptunor/pianofromabove-android/blob/main/src/render/ui.cpp"
click node_imgui "https://github.com/kiptunor/pianofromabove-android/blob/main/extern/imgui/imgui.h"
click node_playback "https://github.com/kiptunor/pianofromabove-android/blob/main/src/audio/playback.cpp"
click node_bass "https://github.com/kiptunor/pianofromabove-android/blob/main/extern/bass_libs/bassmidi.h"
click node_midi_list "https://github.com/kiptunor/pianofromabove-android/blob/main/src/nv_midi/list.cpp"
click node_audio_fx "https://github.com/kiptunor/pianofromabove-android/blob/main/src/audio/audio_effects.cpp"
click node_renderer "https://github.com/kiptunor/pianofromabove-android/blob/main/src/render/render.cpp"
click node_note_buffer "https://github.com/kiptunor/pianofromabove-android/blob/main/src/render/note_buffer.cpp"
click node_config "https://github.com/kiptunor/pianofromabove-android/blob/main/src/config/config.cpp"
click node_midi_provider "https://github.com/kiptunor/pianofromabove-android/blob/main/src/config/midi_list.cpp"
click node_soundfont_provider "https://github.com/kiptunor/pianofromabove-android/blob/main/src/config/soundfont_list.cpp"
click node_color_presets "https://github.com/kiptunor/pianofromabove-android/blob/main/src/config/channel_colors.cpp"
click node_dialog_state "https://github.com/kiptunor/pianofromabove-android/blob/main/src/config/file_dialog_state.cpp"
click node_file_helpers "https://github.com/kiptunor/pianofromabove-android/blob/main/src/file_helpers.cpp"
click node_file_dialog "https://github.com/kiptunor/pianofromabove-android/blob/main/extern/imgui/extra/file_dlg/ImGuiFileDialog.cpp"
click node_exporter "https://github.com/kiptunor/pianofromabove-android/blob/main/src/video/exporter.cpp"
click node_log "https://github.com/kiptunor/pianofromabove-android/blob/main/src/logger.cpp"

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_entry,node_visualizer,node_ui,node_imgui,node_file_dialog,node_log,node_user toneBlue
class node_playback,node_bass,node_midi_list,node_audio_fx toneAmber
class node_renderer,node_note_buffer toneMint
class node_config,node_midi_provider,node_soundfont_provider,node_color_presets,node_dialog_state,node_file_helpers toneRose
class node_exporter toneIndigo
```

## Components

### Runtime and UI

- [Application Entry](https://github.com/kiptunor/pianofromabove-android/blob/main/src/main.cpp): `src/main.cpp`
- [Visualizer Loop](https://github.com/kiptunor/pianofromabove-android/blob/main/src/visualizer_handler.cpp): `src/visualizer_handler.cpp`
- [Controls and Themes](https://github.com/kiptunor/pianofromabove-android/blob/main/src/render/ui.cpp): `src/render/ui.cpp`
- [Dear ImGui](https://github.com/kiptunor/pianofromabove-android/blob/main/extern/imgui/imgui.h): `extern/imgui/imgui.h`
- [File Dialog](https://github.com/kiptunor/pianofromabove-android/blob/main/extern/imgui/extra/file_dlg/ImGuiFileDialog.cpp): `extern/imgui/extra/file_dlg/ImGuiFileDialog.cpp`
- [Logging](https://github.com/kiptunor/pianofromabove-android/blob/main/src/logger.cpp): `src/logger.cpp`

### MIDI and Playback

- [Audio Playback](https://github.com/kiptunor/pianofromabove-android/blob/main/src/audio/playback.cpp): `src/audio/playback.cpp`
- [BASS MIDI Audio](https://github.com/kiptunor/pianofromabove-android/blob/main/extern/bass_libs/bassmidi.h): `extern/bass_libs/bassmidi.h`
- [MIDI Parsing and Notes](https://github.com/kiptunor/pianofromabove-android/blob/main/src/nv_midi/list.cpp): `src/nv_midi/list.cpp`
- [Audio Effects](https://github.com/kiptunor/pianofromabove-android/blob/main/src/audio/audio_effects.cpp): `src/audio/audio_effects.cpp`

### Visualization

- [Piano Roll Renderer](https://github.com/kiptunor/pianofromabove-android/blob/main/src/render/render.cpp): `src/render/render.cpp`
- [Note Buffer](https://github.com/kiptunor/pianofromabove-android/blob/main/src/render/note_buffer.cpp): `src/render/note_buffer.cpp`

### Settings and Files

- [Configuration](https://github.com/kiptunor/pianofromabove-android/blob/main/src/config/config.cpp): `src/config/config.cpp`
- [MIDI List Provider](https://github.com/kiptunor/pianofromabove-android/blob/main/src/config/midi_list.cpp): `src/config/midi_list.cpp`
- [Soundfont Provider](https://github.com/kiptunor/pianofromabove-android/blob/main/src/config/soundfont_list.cpp): `src/config/soundfont_list.cpp`
- [Channel Color Presets](https://github.com/kiptunor/pianofromabove-android/blob/main/src/config/channel_colors.cpp): `src/config/channel_colors.cpp`
- [File Dialog State](https://github.com/kiptunor/pianofromabove-android/blob/main/src/config/file_dialog_state.cpp): `src/config/file_dialog_state.cpp`
- [File Helpers](https://github.com/kiptunor/pianofromabove-android/blob/main/src/file_helpers.cpp): `src/file_helpers.cpp`

### Video Export

- [Video Exporter](https://github.com/kiptunor/pianofromabove-android/blob/main/src/video/exporter.cpp): `src/video/exporter.cpp`

### Other components

- **User**

## Connections

- User → Controls and Themes: operates
- Application Entry → Configuration: loads (evidence: `src/main.cpp`)
- Application Entry → MIDI List Provider: loads (evidence: `src/main.cpp`)
- Application Entry → Soundfont Provider: loads (evidence: `src/main.cpp`)
- Application Entry → Visualizer Loop: starts (evidence: `src/main.cpp`)
- Application Entry → Audio Playback: initializes audio (evidence: `src/main.cpp`)
- Audio Playback → MIDI Parsing and Notes: parses MIDI (evidence: `src/audio/playback.cpp`)
- Audio Playback → BASS MIDI Audio: creates streams (evidence: `src/audio/playback.cpp`)
- Audio Playback → Audio Effects: applies effects
- Visualizer Loop → Audio Playback: updates state (evidence: `src/visualizer_handler.cpp`)
- Visualizer Loop → Piano Roll Renderer: draws frame (evidence: `src/visualizer_handler.cpp`)
- Visualizer Loop → Note Buffer: buffers notes (evidence: `src/visualizer_handler.cpp`)
- Visualizer Loop → Video Exporter: captures audio (evidence: `src/visualizer_handler.cpp`)
- Controls and Themes → Dear ImGui: builds controls
- Controls and Themes → Audio Playback: controls playback
- Controls and Themes → File Dialog: opens picker
- Controls and Themes → Configuration: edits settings
- Controls and Themes → Channel Color Presets: selects presets
- Controls and Themes → Video Exporter: requests export
- File Dialog State → File Helpers: uses paths (evidence: `src/config/file_dialog_state.cpp`)
- Application Entry → Logging: configures logging (evidence: `src/main.cpp`)
