Framework Control
Framework Control is a lightweight control surface for Framework laptops, exposing a minimal local HTTP API and a modern web UI to monitor telemetry and tweak core platform settings. Developed by Kemal Ozturk (GitHub: ozturkkl), it provides fan control (auto/manual/curve), power management, charging controls, and LED Matrix support for Framework Laptop 13 and 16 models12.
The project uses a Windows background service (Rust + Tokio) that communicates with Framework's official framework_tool CLI, with a Svelte web UI for the frontend2.
Framework 16 users require BIOS 3.07 or later for proper EC/fan control behavior. Install the latest BIOS before using this tool.
Features
Fan Control
| Mode | Description |
|---|---|
| Auto | Platform-managed fan control |
| Manual | Fixed duty percentage slider (0–100%) |
| Curve | Custom temperature-to-duty curve with hysteresis and rate limiting |
The curve editor includes visual drag-and-drop point editing, live RPM overlay with real-time crosshair showing current temperature and fan duty, a guided calibration wizard for accurate RPM-to-duty% mapping, and sensor selection (APU/CPU)2.
As of v0.5.3, per-fan manual/curve overrides are available for multi-fan laptops (e.g., Framework 16), with separate spin-down rate limits and live per-fan RPM overlays on the curve editor. The /api/thermal endpoint now returns fans: [{ name, rpm }] instead of a flat rpms array3.
Power Management
| Platform | Method | Capabilities |
|---|---|---|
| Windows (AMD) | RyzenADJ | TDP and thermal limit control |
| Linux | Native kernel interfaces | AMD P-State EPP, cpufreq governor |
| All platforms | framework_tool CLI | Energy preferences, frequency limits |
Separate AC/battery profiles are supported, with background reapply and live power readout2.
Battery & Charging
- Charge limit control (0–100%)
- Charge rate limiting
- SoC threshold settings
- Live power readouts
LED Matrix Support (Framework 16)
Exposes HTTP API endpoints for rendering images, animations, and GIFs to the LED Matrix input modules2.
Telemetry Endpoints
| Endpoint | Data |
|---|---|
/api/health | Service health status |
/api/thermal | Current temperatures and fan speed |
/api/thermal/history | Historical thermal data |
/api/power | Current power state |
/api/versions | BIOS, EC, and firmware versions |
/api/system | System information |
Architecture
| Component | Technology |
|---|---|
| Backend Service | Rust (Tokio + Poem + poem-openapi) |
| Frontend UI | Svelte + Vite |
| Hardware Interface | framework_tool CLI via subprocess |
| Communication | Local HTTP REST API |
| Configuration | JSON (C:\ProgramData\FrameworkControl\config.json) |
The service runs as a background daemon on Windows, providing a stable interface that persists across sessions2.
Installation
- Open the web app at https://ozturkkl.github.io/framework-control/1
- Download and install the background service from the web app
- Launch via Start Menu/Desktop shortcuts or visit
http://localhost:<port>(check installer output for port)2
Linux Packages
As of v0.5.4, the service is available via distribution packages4:
| Distribution | Package |
|---|---|
| Arch Linux | AUR stable (framework-control) or beta (framework-control-beta) |
| NixOS | nixpkgs: framework-control (see install docs in repo) |
Requirements
- Windows 10/11 or Linux
- Framework Laptop 13 or 16
- BIOS 3.07+ (Framework 16)
framework_toolin PATH or bundled with service
Development Status
The project is actively maintained with regular releases. The latest stable release is v0.5.3 (June 7, 2026), with v0.5.4 in pre-release as of July 2026534.
v0.5.3 (June 2026) introduced multi-fan control, an improved uninstall flow (Windows MSI cleanup of shortcuts/config/logs + Linux uninstall-linux.sh), and removed the periodic framework_tool --versions liveness check that was spawning a process every 5 seconds even when no UI was connected3.
v0.5.4 (pre-release, July 2026) added a framework_tool version selector in Settings (download, validate, and switch to a specific release tag), reduced background CLI process spawning and WinRing0 driver churn with longer cache TTLs, and introduced AUR stable/beta packages plus NixOS install documentation4.
| Metric | Value |
|---|---|
| Stars | 118 |
| Forks | 4 |
| Releases | 16 |
| Latest stable | v0.5.3 (June 2026) |
| Pre-release | v0.5.4 (July 2026) |
Related Projects
| Project | Description |
|---|---|
| Framework Deck | All-in-one desktop companion with telemetry and LED matrix |
| YAFI | GTK4/Adwaita GUI for Framework EC |
| fw-fanctrl | Fan control daemon for Linux |
| Framework Tool TUI | Terminal-based dashboard for Framework hardware |