Framework Deck
Framework Deck is an open-source, all-in-one desktop companion application for Framework laptops, developed by community member ToySnail (GitHub: enkode). It evolved from the earlier Input Architect project — a keyboard and macropad configurator — into a unified tool that combines keyboard customization with real-time hardware telemetry, fan control, power management, battery health monitoring, and LED matrix editing1.
Built with Tauri 2, the application uses a lightweight native window rather than Electron, resulting in an approximately 2 MB installer1.
Features
Live Oscilloscope Dashboard
Real-time multi-channel waveform display showing sensor data for APU, CPU-EC, DDR, EC, dGPU, GPU-AMB, GPU-VR, VRAM temperatures, and both fan RPM channels. The time window is configurable (1 m / 5 m / 10 m / 30 m) with hover-to-inspect exact values1.
Keyboard & Macropad Configurator
Full VIA key remapping with support for 6 layers and over 100 QMK keycodes, including layer switching (MO/TG/TO). Per-key RGB lighting control is available when using the nucleardog firmware. Additional features include shift+click range select, Ctrl+click multi-select, key group presets (WASD, FPS, MOBA, etc.), config snapshots with export/import as JSON, multi-device switching, and auto-reconnect after sleep/wake1.
Fan Control
Three modes are available: AUTO, MANUAL (with a duty % slider and live RPM readout), and CURVE. Separate profiles for AC and battery power1.
Power Management
TDP slider from 5 W to 145 W in 5 W steps with live readout. Thermal limit control and AC/battery profile switching1.
Battery Health
Displays state of charge with a segmented bar, battery health percentage (current max vs. design capacity), live voltage, current, remaining mAh, and cycle count. A charge limit control allows capping the battery at 80% or 95% to extend lifespan1.
LED Matrix Editor (Framework 16)
Click or drag to paint individual LEDs on the 306-LED display panel. Includes pattern presets (CLEAR, FILL, CHECKER, BORDER, CROSS, WAVE) and a module slot inventory showing what is installed in each physical slot1.
System Information
Displays CPU, GPU, mainboard, memory, OS, BIOS version, EC firmware build, power state capabilities, and current TDP1.
Settings & Accessibility
Four color themes (REEL, PHOS, AMBR, FW), independent text size and UI zoom sliders, high contrast mode, reduced motion option, temperature unit switching (°C/°F), and configurable warning thresholds1.
Supported Hardware
Telemetry
| Device | Supported |
|---|---|
| Framework Laptop 13 (AMD) | Yes |
| Framework Laptop 13 (Intel) | Yes |
| Framework Laptop 16 (AMD Ryzen 7040) | Yes |
| Framework Laptop 16 (Ryzen AI 300) | Yes |
Keyboard Configurator
| Module | Per-Key RGB |
|---|---|
| Framework 16 ANSI Keyboard (0x0012) | With nucleardog firmware |
| Framework 16 RGB Macropad (0x0013) | With nucleardog firmware |
Download & Installation
| Platform | Package |
|---|---|
| Windows 11/10 | .exe installer (NSIS) or .msi |
| Linux (any distro) | .AppImage — make executable and run |
| Debian / Ubuntu | .deb |
| Fedora / RHEL | .rpm |
Downloads are available from the GitHub releases page1.
For telemetry features (oscilloscope, fan control, power management, battery health, system info), the framework-control service by ozturkkl is required. The keyboard configurator works standalone via WebHID with no backend needed1.
Roadmap
| Feature | Status |
|---|---|
| Light mode theme | Planned |
| Floating desktop widget | Planned |
| System tray mode | Planned |
| Fan curve visual editor | Planned |
| Alert thresholds | Planned |
| LED Matrix animations | Planned |
| CSV/JSON telemetry export | Planned |
Source Code
Framework Deck is MIT licensed and open to issues, pull requests, and hardware testing reports1.
It builds on several open-source projects:
- ozturkkl/framework-control — Rust telemetry backend
- nucleardog QMK firmware — per-key RGB firmware for Framework 16
- FrameworkComputer — QMK firmware, VIA definitions, EC documentation, inputmodule-rs