-
-
Notifications
You must be signed in to change notification settings - Fork 6
Home
ZenTune (formerly UXTU4Linux) is a power management tool for AMD Ryzen APUs and desktop CPUs on Linux and macOS. It lets you set CPU power limits, temperature limits, current limits, clock targets and Curve Optimiser offsets from a terminal, without touching the BIOS.
The interface is a tabbed terminal app (built on Textual): Home, Premade, Custom, Adaptive, Auto, Info, Status and Settings. Switch tabs with the number keys or the mouse.
It runs a background daemon as root. The daemon is the only thing that actually writes to the CPU. The terminal UI runs as your normal user and talks to the daemon over a socket, so you never have to run the whole application as root.
| Hardware | Status |
|---|---|
| AMD Ryzen APUs (Zen 1 through Zen 5+) | Supported |
| AMD Ryzen Desktop CPUs (AM4 / AM5) | Supported |
| Framework Laptop 13 / 16 (Ryzen 7040 / AI 300) | Supported with dedicated presets |
| Intel | Not supported |
| Platform | Status |
|---|---|
| Linux, with or without systemd | Fully supported, including Adaptive Mode |
| macOS (Hackintosh, AMD CPU) | Supported: tuning, presets and automations. Adaptive Mode is Linux-only for now |
System requirements:
- Python 3.10 or newer
- On Linux:
ryzen_smukernel module, version 0.1.7 or newer, only when Secure Boot is enabled. Most systems use PCI direct access instead - On macOS: DirectHW kext loaded (or the kext-free IOPCIBridge fallback with the
debug=0x144boot-arg), and root access. See macOS Installation
- Four built-in preset levels per CPU family: Eco, Balance, Performance, Extreme
- Custom Preset Editor with around 65 tunable parameters on APUs (34 on desktop CPUs), each with a short description in the editor
- Adaptive Mode that tunes power, Curve Optimiser and iGPU clocks live from temperature and load, with its own savable presets (Linux only). See Adaptive Mode
- System settings inside presets: power profile, ASUS performance mode / GPU Eco / GPU MUX, CCD affinity
- NVIDIA dGPU clock limit and core/memory offsets
- Automations: switch presets automatically on AC/battery changes and on resume from suspend
- Reapply loop that re-applies the active preset on a configurable timer
- Home dashboard with live CPU temperature, power, clock and usage graphs
- Info tab with detected CPU/board data, plus a Status tab showing daemon state and the last SMU apply output
- Built-in updater (stable or beta) that keeps your config and custom presets across updates
- Linux Installation: full setup walkthrough for Linux, including ryzen_smu build instructions per distro
- macOS Installation: setup walkthrough for macOS, including DirectHW and the IOPCIBridge fallback
- Linux Troubleshooting: fixes for the common problems on Linux
- macOS Troubleshooting: fixes for the common problems on macOS
- Premade Presets: the four built-in presets and how they're picked for your CPU
- Custom Presets: how to use the Custom Preset Editor, plus what every parameter does
- Adaptive Mode: the live-tuning mode and every setting it exposes (Linux only)
- Automations: switch presets automatically on AC/battery and resume
-
Configuration: the
config.inifile, explained - Developer Documentation: architecture, internals and contribution reference
Heads up: if you're updating from UXTU4Linux v1.1.0 or earlier, "Check updates" walks you through a one-time automatic migration to ZenTune. Your settings and presets carry over, no manual steps required.
Getting started
Using the app
Internals