🎨 Themes & Appearance

MidiEditor AI ships with seven built-in themes that restyle the entire application — toolbars, lists, scroll­bars, dialogs, the piano roll, velocity editor, and every custom-painted widget. Pick the look that suits your workflow and time of day.

MidiEditor AI theme overview showing Dark, AMOLED, Sakura, Light and Material Dark themes side by side

All themes applied to the same MIDI file — pick your vibe.

⚙️ Appearance Settings

Open Edit → Settings… (or press Ctrl+,) and switch to the Appearance tab. The panel is wrapped in a scroll area so all settings are reachable at any window size. From top to bottom you can:

Appearance settings panel showing theme selector, color preset, marker toggles, and collapsible channel/track color sections

Settings → Appearance — Theme, color preset, timeline marker toggles, and collapsible color pickers.

🔄 Theme changes require a restart. When you select a new theme from the dropdown, a confirmation dialog appears. Click Restart to apply immediately — the app saves your work, restarts, and re-opens the Appearance settings so you’re right back where you left off.

Theme change restart confirmation dialog

The restart confirmation popup — Cancel keeps your current theme.

🎨 Theme Gallery

Each theme defines a complete colour palette — backgrounds, accents, borders, text, and all custom-painted editor areas. Hover over the swatches below to see the hex values.

🌙 Dark dark

#0d1117
#161b22
#1c2129
#58a6ff
#79c0ff
#30363d

Deep blue-black inspired by GitHub’s dark mode. Easy on the eyes for late-night editing sessions.

☀️ Light light

#ffffff
#f6f8fa
#e8eaed
#0969da
#0550ae
#d0d7de

Clean white palette for well-lit environments. High contrast, classic look.

🌸 Sakura light

#fff5f8
#ffe8ef
#f0c0d0
#db7093
#c9506b
#f5d0dc

Light cherry blossom aesthetic with soft pink accents. Piano keys are tinted lavender blush.

🌑 AMOLED dark

#000000
#0a0a0a
#111111
#e67e22
#f39c12
#1a1a1a

Pure black backgrounds with warm orange accents. Maximum contrast, ideal for OLED screens.

💎 Material Dark dark

#1e1d23
#252430
#2a2935
#04b97f
#37efba
#35343d

Charcoal purple-gray base with teal accents. Inspired by Material Design dark themes.

🖥️ System (Auto)

Dark
or
Light
auto
detect
OS

Follows your Windows dark/light mode setting. Switches automatically between Dark and Light.

🏛️ Classic

native
system
widget
accent
window
border

Original system-native MidiEditor look. No QSS applied — uses your OS window style.

Theme Comparison

ThemeBackgroundAccentTypeTitle BarBest For
Dark#0d1117#58a6ff blue DarkDarkLate-night editing
Light#ffffff#0969da blue LightLightDaytime / well-lit rooms
Sakura#fff5f8#db7093 pink LightLightCherry blossom vibes
AMOLED#000000#e67e22 orange DarkDarkOLED screens / max contrast
Material Dark#1e1d23#04b97f teal DarkDarkMaterial Design fans
SystemFollows OS setting AutoAutoSet it and forget it
ClassicNative OS widgets NativeNativeOriginal MidiEditor look

🎨 Note Bar Color Presets

In the same Appearance panel you can choose from 10 color presets that instantly restyle the channel and track colors in the piano roll. The selected preset is remembered across sessions.

Default
Rainbow
Neon
Fire
Ocean
Pastel
Sakura
AMOLED
Emerald
Punk

📍 Timeline Markers

The Timeline Markers feature overlays visual indicators for Program Change, Control Change, and Text/Marker events directly on the piano roll. Each marker type can be toggled independently in Settings → Appearance.

Piano roll with timeline markers showing Program Change and Control Change events as dashed lines and labelled badges

Timeline markers in action — Program Change and Control Change events displayed as dashed lines and badges below the ruler.

💡 Tip: Timeline markers make it easy to spot instrument switches and volume/pan automation at a glance. Combine with Color by Track to match the note colours.


🎵 MIDI Visualizer

The MIDI Visualizer is a real-time 16-channel equalizer bar display embedded in the toolbar. Each bar represents one MIDI channel and animates based on note velocity during playback — green-to-blue colour interpolation with smooth decay.

Animated GIF showing the MIDI Visualizer bars bouncing during playback

The MIDI Visualizer in action — one bar per channel, animated at ~30 fps.

FeatureDetails
Channels16 bars (one per MIDI channel), only active channels show activity
ColorsGreen (low velocity) → Blue (high velocity) interpolation
AnimationSmooth decay at ~30 fps, thread-safe atomic reads
ToggleEnable/disable in Settings → Layout → Customize Toolbar
Dark modeIcon auto-inverts for dark themes

🔄 How Theme Switching Works

When you change the theme:

  1. A confirmation dialog asks if you want to restart now or cancel.
  2. If you confirm, the app saves your current file and records the new theme choice.
  3. A new MidiEditor AI process launches with the --open-settings flag.
  4. The old process exits cleanly.
  5. The new instance starts with the updated theme and re-opens the Appearance tab so you can continue customizing.

💡 Why restart? Qt caches icons and some widget metrics at startup. A full restart ensures every icon, toolbar, and custom-painted widget reflects the new theme perfectly — no stale colours or mismatched icons.

💡 Tips