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.
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
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. Latest version is v0.5.2 (March 15, 2026)3.
| Metric | Value |
|---|---|
| Stars | 118 |
| Forks | 4 |
| Releases | 14 |
| Last release | v0.5.2 (March 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 |