MainFrameWork
One control panel for your entire Framework system — keyboard, LED matrix, and system telemetry, unified.
Stop juggling QMK Configurator, the browser-based LED matrix tool, and Task Manager in three different tabs. MainFrameWork puts remapping, matrix drawing, hardware monitoring, and profile automation in one native desktop app.
Pre-release · GPLv3 Community Edition · Windows, built for Framework systems
Framework gave you a machine you can take apart. It didn't give you one app to run it.
Remap a key and you're in QMK Configurator. Draw on the LED matrix and you're in a browser tab talking to WebSerial. Check your fan curve and you're digging through vendor tools that half-support the hardware. None of it talks to the other.
MainFrameWork is the one app that actually knows what's plugged in.
It knows what's plugged in before you ask.
Open MainFrameWork and the Dashboard is already reading your CPU, GPU, and RAM, and has already enumerated every Framework module on the bus by vendor/product ID — LED Matrix, Keyboard, HDMI expansion card, whatever you've got racked in. Plug something in mid-session and the next scan picks it up. No restart.
Community Edition. Free, open source, no catch.
This is what's actually running right now, not a roadmap slide.
Live hardware readout
Real-time CPU/GPU load, RAM, and every connected Framework module (LED Matrix, Keyboard, expansion cards) with vendor/product IDs — no third-party monitor needed.
Visual keymap editor
A real keyboard on screen, four layers deep. Click a key, assign Basic, Media, Macro, or Layer actions — no flashing firmware, no config file to hand-edit.
Matrix Studio
Pixel-editor for the LED Matrix input module — pen/eraser, pattern presets, brightness, day/night toggle, independent Left/Right panel control.
Frame-based Animator
Build multi-frame animations for the matrix directly in-app — add frames, scrub playback, upload straight to the hardware.
Profiles with auto-switch
Up to 3 saved profiles (keymap + fan curve + lighting), each bindable to a process — .exe launches, your profile follows.
Widget palette for the matrix
Clock, Battery, CPU Load, and Audio EQ widgets, drag-built onto the matrix layout. Live preview is next up.
Hot-swap detection
Plug in an expansion card mid-session and MainFrameWork picks it up on the next scan — no restart.
Portable, GPLv3, no telemetry
One portable .exe. Community Edition is fully open source under GPLv3 — read every line, build it yourself, keep it forever.
Input Studio: click a key, not a config file.
A full visual keyboard, four layers deep, for the Main Keyboard, Numpad, and RGB Macropad independently. Click any key and the Key Assignment panel opens — Basic keycodes, Media controls, Macro, or Layer switching. Standard QMK keycodes on Community Edition; Lua/JS scripting is a Pro upgrade.
Matrix Studio: the LED matrix deserves better than a browser tab.
Draw, animate, and widget-ize your 9x34 LED Matrix modules — left and right panels, independently addressable.
Canvas — pen, eraser, patterns, brightness
Animator — multi-frame, scrub, upload to matrix
Your rig knows when you've launched Steam.
Bundle a keymap, fan curve, and lighting pattern into a profile, then bind it to a process. Launch steam.exe and your Gaming profile activates. Switch to code.exe and Focus takes over. Community Edition ships 3 local profiles; Pro removes the cap.
Fan curves and battery limits aren't wired up yet. Here's why.
Direct EC (embedded controller) access — fan curves, battery charge limits, thermal sensors — needs a kernel-level driver that Windows doesn't expose by default. That's the honest blocker, and MainFrameWork's own System Health panel says so outright: Pro Features Locked, CrosEC Kernel Driver required, Coming Soon.
Until that driver ships, MainFrameWork runs in what it calls Portal Mode — full Input Studio and Matrix Studio, no EC access. That's not a downgrade hack; it's the actual current state, and we'd rather tell you that than ship a fake fan slider.
For when Portal Mode isn't enough.
Pro is real, scoped, and visible in-app right now — it's just not switched on yet. Here's what unlocks when it is.
Unlimited Profiles
No 3-profile cap.
Cloud Sync
Profiles follow you between machines.
Lua/JS Macro Scripting
Real logic and loops, not just keycodes.
GameSense
Health/ammo on the matrix for CS2, Dota, and more.
EC Hardware Access
Fan curves, battery limits, sensors — once the CrosEC driver ships.
Auto-Profile Switching
Already visible in Community as manual profiles; Pro automates it fully.
Community Edition stays free and GPLv3 forever, no matter what Pro costs when it ships.