How chickend233/midikey-player works
MidiKeyPlayer is a Windows desktop MIDI-to-keyboard-and-mouse player with score editing, live MIDI input, playlist playback, and optional synchronization. The main workflow is: open a MIDI file, choose tracks and a keymap, optionally edit the score, then schedule mapped notes and send input to the foreground application. The graph also shows preview/export, playlist persistence, settings, updates, and sync. Several relationships come from README descriptions or the SOURCE INDEX; unsampled synchronization wiring is left unverified.
Main entry points: MainWindow.axaml.cs Main Window · PlaylistWindow.axaml.cs Playlist Window · PlaybackEngine.cs Playback Engine · SyncSession.cs Sync Session
Components 28
Desktop App
- Main Window
MidiKeyPlayer/MainWindow.axaml.cs - Playlist Window
MidiKeyPlayer/PlaylistWindow.axaml.cs - Playback Overlay
MidiKeyPlayer/OverlayWindow.axaml.cs - Settings UI
MidiKeyPlayer/SettingsWindow.Keymap.cs
MIDI and Editing
- MIDI Loader
MidiKeyPlayer/Midi/MidiLoader.cs - Track Roles
MidiKeyPlayer/Midi/GmInstrument.cs - Piano Roll
MidiKeyPlayer/Controls/PianoRoll.cs - Score Editing
MidiKeyPlayer/Engine/ScoreEditor.cs - MIDI Export
MidiKeyPlayer/Engine/MidiExporter.cs - MIDI Preview
MidiKeyPlayer/Engine/MidiPreview.cs
Playback and Input
- Keymap Profiles
MidiKeyPlayer/Engine/KeymapProfile.cs - Note Mapper
MidiKeyPlayer/Engine/NoteMapper.cs - Playback Engine
MidiKeyPlayer/Engine/PlaybackEngine.cs - Input Timing
MidiKeyPlayer/Engine/InputTiming.cs - Input Sender
MidiKeyPlayer/Input/InputSender.cs - Live Playback
MidiKeyPlayer/Engine/LivePlayback.cs - MIDI Device Input
MidiKeyPlayer/Midi/MidiInputService.cs - Global Hotkeys
MidiKeyPlayer/Input/GlobalHotkeys.cs
State and Sync
- Playlist Model
MidiKeyPlayer/Engine/PlaylistModel.cs - Playlist Store
MidiKeyPlayer/Persist/PlaylistStore.cs - App Configuration
MidiKeyPlayer/Persist/AppConfig.cs - Auto Update
MidiKeyPlayer/Engine/AutoUpdate.cs - Sync Session
MidiKeyPlayer/Engine/SyncSession.cs - Sync Relay
MidiKeyPlayer/Engine/SyncRelay.cs - Sync Clock
MidiKeyPlayer/Engine/SyncClock.cs
Other components
- User
- Relay Service
cloudflare/src/index.js - Foreground App
Connections 30
- User → Main Window: opens and controls
- Main Window → MIDI Loader: loads MIDI
MidiKeyPlayer/MainWindow.axaml.cs - MIDI Loader → Track Roles: identifies tracks
MidiKeyPlayer/Midi/MidiLoader.cs - Main Window → Piano Roll: edits score
MidiKeyPlayer/MainWindow.axaml.cs - Piano Roll → Score Editing: edits notes
- Main Window → MIDI Export: exports score
MidiKeyPlayer/MainWindow.axaml.cs - Main Window → MIDI Preview: previews MIDI
MidiKeyPlayer/MainWindow.axaml.cs - Main Window → Keymap Profiles: selects mapping
MidiKeyPlayer/MainWindow.axaml.cs - Main Window → Note Mapper: maps notes
MidiKeyPlayer/MainWindow.axaml.cs - Main Window → Playback Engine: starts playback
MidiKeyPlayer/MainWindow.axaml.cs - Playback Engine → Input Timing: schedules timing
MidiKeyPlayer/Engine/PlaybackEngine.cs - Playback Engine → Input Sender: sends input
MidiKeyPlayer/Engine/PlaybackEngine.cs - Input Sender → Foreground App: injects key events
- Main Window → MIDI Device Input: configures live input
MidiKeyPlayer/MainWindow.axaml.cs - MIDI Device Input → Live Playback: delivers note events
MidiKeyPlayer/Engine/LivePlayback.cs - Live Playback → Input Sender: sends mapped input
MidiKeyPlayer/Engine/LivePlayback.cs - Main Window → Global Hotkeys: registers controls
MidiKeyPlayer/MainWindow.axaml.cs - Main Window → Playlist Window: opens manager
- Playlist Window → Playlist Model: edits entries
MidiKeyPlayer/PlaylistWindow.axaml.cs - Playlist Window → Playlist Store: reads and writes
MidiKeyPlayer/PlaylistWindow.axaml.cs - Main Window → Playlist Store: loads playlists
MidiKeyPlayer/MainWindow.axaml.cs - Main Window → Playback Overlay: shows playback status
- Main Window → Settings UI: opens settings
- Main Window → App Configuration: loads and saves
MidiKeyPlayer/MainWindow.axaml.cs - Settings UI → Keymap Profiles: configures profiles
MidiKeyPlayer/SettingsWindow.Keymap.cs - Main Window → Auto Update: checks updates
MidiKeyPlayer/MainWindow.axaml.cs - Main Window → Sync Session: coordinates sync
- Sync Session → Sync Relay: uses relay
MidiKeyPlayer/Engine/SyncSession.cs - Sync Session → Sync Clock: uses clock
MidiKeyPlayer/Engine/SyncSession.cs - Sync Relay → Relay Service: may communicate