CCTL (ColorControl) is a lightweight command-line control center for Colorful Evol P15 laptops built on Clevo/TUXEDO chassis. It provides direct control over EC power profiles, CPU and GPU fans, keyboard RGB colors and effects, battery charge modes and thresholds, display refresh rate and scaling, GPU MUX switching, NVIDIA clocks, webcam, and microphone. Live CPU and GPU monitors are included, and the DKMS drivers that back these features can be managed from the same tool.
CCTL is written in C, runs without a GUI, and needs no always-on service — keyboard effects and custom fan curves use a small background worker only while they are active.
Specifically designed for the Colorful Evol P15 series (Clevo/TUXEDO chassis).
| Laptop | CPU | GPU | Keyboard |
|---|---|---|---|
| Colorful Evol P15 | Intel Core i7-13620H | RTX 4060 Mobile 100W | Single-zone RGB |
| Colorful Evol P15 | Intel Core i5-12500H | RTX 4050 Mobile 100W | Single-zone RGB |
- Series: Colorful Evol P15 series
- GPUs: NVIDIA GeForce RTX 40 Series Mobile
- CPUs: Intel CPUs
- Keyboard: Single-zone RGB keyboard (tested)
Note: Built specifically for Colorful Evol P15 series laptops. Other laptop models or other Clevo/TUXEDO variants may have different EC register layouts, fan byte orders, or EC profile codes — use at your own risk.
-
Install the latest release in one command (downloads the latest binary and runs the installer):
curl -fsSL https://github.com/bhusann/cctl/releases/latest/download/cctl -o /tmp/cctl && chmod +x /tmp/cctl && sudo /tmp/cctl install
-
Or download the pre-built
cctlbinary from the Releases page and install it manually:chmod +x ./cctl && sudo ./cctl install -
Install kernel drivers via DKMS (required for fans, keyboard backlight, battery):
cctl drivers-manage
-
Ready to use immediately (privileged commands auto-elevate seamlessly, no manual sudo or aliases needed):
cctl set balanced # apply a power profile (auto-elevates via sudo) cctl fan auto # set fans to automatic (auto-elevates via sudo) cctl fancurve start quiet # run a saved custom fan curve (after creating one) cctl status # view all current settings
-
Download the latest
cctlbinary from the official Releases page. -
In the folder where you downloaded it, run:
chmod +x ./cctl sudo ./cctl install
-
When asked to upgrade or reinstall cctl, type
yto confirm. The installer updates the installed binary and sudo rule. It then asks whether passwordless sudo should apply to the current user only (default,1) or all users (2).
cctl — full command reference
cctl status — all current settings at a glance
cctl cpumon — live CPU, memory, fan, and power readings
cctl gpumon — live NVIDIA GPU readings
cctl kbe — keyboard backlight effects
cctl kbc — keyboard color presets
set <profile> [--nosafe] applies preset (EC defaults + table values below).
Built-in profiles are quick-use presets, not official or universal
recommendations. Choose what suits your workload, or save a preferred
combination as a custom profile.
Profile EC code Turbo Governor EPP EC default TDP Refresh
────────── ─────── ────── ──────────── ─────────────────── ─────────────────── ───────
max 2 ON powersave performance 90/115W + GPU 100W --
cpuperf 3 ON powersave performance 45/115W --
balanced 3 ON powersave balance_performance 45/115W --
powersave 1 OFF powersave balance_power 15/30W lowest
silent/eco 0 OFF powersave power 15/30W --
Note
The built-in powersave profile and silent/eco leave fan control unchanged. powersave also selects the lowest supported internal display refresh rate under X11 (e.g. 40 Hz) to maximize battery runtime. You can adjust the refresh rate anytime using cctl rr.
Caution
Silent fan mode and manual fan duty may keep fans quiet or fixed regardless of
CPU temperature, even under heavy load. To protect the hardware, applying EC
profile code 2 or 3, or enabling Turbo while EC code 2 or 3 is
active, sets fans to AUTO by default.
--nosafe skips that automatic change and keeps the current fan setting.
Use manual fan duty only for experimental purposes.
Full-load measurements and comparisons are documented in the EC profile test results.
Create extra power presets with cctl editconf, then apply one with
cctl set <name>. The Custom Profiles guide shows
how to choose profile settings and includes examples and safety limits.
Command names:
- Profiles and setup:
set,editconf,install,uninstall,drivers-manage - Keyboard and fans:
kbc,kbb,kbe,kbn,fn,fan,fancurve(aliasfanc) - GPU and privacy:
mux,nvidia clock,nvidia memclock,webcam,mic - Battery and system info:
bat,status,--version - Monitors:
cpumon,gpumon - Display:
rr,scale - CPU controls:
turbo,gov,epp,rapl - Snapshots:
snap(aliassnapshot; baresnaplists saved snapshots), actionssave/s,restore/r,view/v,delete/del - Application settings:
options - Help & Agent Skill:
--help,--am
Full usage, options, and hardware quirk notes: commands.md.
Most cctl commands apply a setting and exit; cctl has no tray app or general
startup service. cctl fancurve start <name> is an exception: it starts a
detached worker that runs the curve until stopped or the system shuts down.
When a compatible login manager provides sleep notifications, the worker
returns fan control to the laptop before sleep and resumes the curve after wake.
If the wake notification is missed, it can resume curve control when a monitored
temperature rises above 85 °C. See the Fan Curves guide
for details.
To restore saved settings at startup, save them with cctl snap save <name> and
configure your service manager (for example, systemd or runit) to run
cctl snap restore <name>. Snapshots include battery charge mode and the active
fan-curve settings and temperature/fan points, and restore that configuration
last. Manual fan speeds are not saved. Curves do not start automatically at
boot unless your startup setup restores a snapshot containing one.
Caution: cctl writes the EC directly. Don't run TCC (
tccd), NBFC, or another Clevo fan daemon at the same time — they will fight over fan speed and profile state. If TCC is installed, stop it first:sudo systemctl stop tccd(re-enable later withsudo systemctl enable --now tccd).
make # Standard build (profiles, fans, display, battery, nvidia clock/power)
make install # Build and install through cctl's installerThe Makefile respects CC, CFLAGS, and LDFLAGS. Hardening flags are always applied. Pass STRIP=0 to keep debug symbols.
The Clevo/TUXEDO driver stack (clevo_acpi, tuxedo_keyboard, tuxedo_io) is required for fan control, keyboard backlight, battery thresholds, and EC profile codes. The installer handles DKMS registration, build, and modprobe config.
Driver sources live only in the mirror repo: https://github.com/bhusann/tuxedo-drivers-cctl-mirror — a readable drivers/ folder plus the pre-packed drivers.tar.gz. Every GitHub release of cctl also attaches that identical tarball.
Install or uninstall directly with the script (it lives in the mirror repo):
git clone https://github.com/bhusann/tuxedo-drivers-cctl-mirror
sudo tuxedo-drivers-cctl-mirror/drivers/driverinstall.sh --install
sudo tuxedo-drivers-cctl-mirror/drivers/driverinstall.sh --uninstall
tuxedo-drivers-cctl-mirror/drivers/driverinstall.sh --status # no root neededAuto-installs dkms + kernel headers if missing, with confirmation prompt:
| Package Manager | Distros | Tested |
|---|---|---|
pacman |
Arch, Manjaro, EndeavourOS, CachyOS, Garuda | ✅ Arch, CachyOS |
apt |
Debian, Ubuntu, Mint, Pop!_OS, Zorin | — |
dnf |
Fedora (standard Workstation/Spins), RHEL, Rocky, Alma | — |
zypper |
openSUSE Tumbleweed/Leap | — |
xbps |
Void Linux | — |
emerge |
Gentoo | — |
eopkg |
Solus | — |
Immutable / Atomic OS note: Atomic and immutable editions of Fedora (Silverblue, Kinoite, Atomic Desktops, Bazzite, etc. using
rpm-ostree) are not supported because the root filesystem is read-only and DKMS modules cannot persist across image updates. Only standard, non-atomic Fedora (Workstation, KDE Spin, etc. using regulardnf) is supported. On unrecognized distros, the installer points to the driver source in the mirror repo for manual installation.
Drivers first, then the cctl binary — in that order, so cctl is still around for the clean driver removal.
- Kernel drivers —
sudo cctl drivers-manageand select the uninstall option (it cleanly unloads the modules and deregisters DKMS):
sudo cctl drivers-manage # select the uninstall option- cctl and its data — run the uninstall command:
sudo cctl uninstallType yes in full to confirm. This removes the cctl binary, sudoers rule and
backup, custom profiles, and saved cctl data under /var/lib/cctl. If cctl
detects loaded TUXEDO/Clevo modules, it recommends removing them first with
cctl drivers-manage; you can confirm to remove cctl while leaving the drivers
installed. It is recommended to uninstall the drivers first, before uninstalling
the cctl binary.
For manual driver and cctl cleanup, follow the manual uninstallation guide.
cctl own code is licensed under the MIT License — see LICENSE.
The driver code (in the mirror repo's drivers/ folder) is not MIT. It is derived from the TUXEDO Linux driver project and remains under GPL-2.0-or-later — see drivers/LICENSE and THIRD-PARTY-NOTICES.
Important
Created with AI assistance under human direction, and thoroughly tested and evaluated by a human.
cctl uses driver code from the TUXEDO Linux driver project:
https://github.com/tuxedocomputers/tuxedo-drivers
The driver code is licensed under GPL-2.0-or-later. Copyright belongs to the respective original authors (TUXEDO Computers GmbH and contributors).
GPU MUX reverse-engineered findings are referred from this repo:





