Skip to content

Releases

v5.5.1

Choose a tag to compare

@github-actions github-actions released this 03 Nov 19:42

Small bug fixes.

v5.5

Choose a tag to compare

@bhusann bhusann released this 02 Nov 16:37

Changes

• Typed JSON output: cctl status --json now emits proper JSON types (booleans, integers, nulls, arrays) instead of human-readable strings — covers system, fans, keyboard, privacy, battery, fan curve, and GPU MUX sections.
• Atomic state files: Fan curve and keyboard effect workers now write state via temp file + fsync + rename, preventing readers from ever seeing half-written files.
• Keyboard effect refactor: Extracted kbe_effective_effect() so kbe_is_running() is a pure liveness check; pulse-profile resolution is now explicit at each call site.
• GPU monitor live cadence: gpumon --live skips nvidia-smi dmon PCIe throughput sampling (~1 s blocking) to keep the live JSON cadence fast; reports pcie_rx_mbs / pcie_tx_mbs as null in live mode.
• Fan curve startup: Extracted fc_wait_for_worker() with waitpid-based early-exit detection for clearer error messages.
• Shared monitor code: Unified TUI, color, UTF-8, framebuffer, and buffer helpers between cpumon and gpumon; shared fan telemetry and NVIDIA PCI discovery.
• Hardening: Dropped editor privileges before launching the fan-curve editor, tightened RAPL writes, interactive driver installs, live monitor polling, and short-write handling.
• Cleanup: Removed dead read_fan_telemetry_ex wrapper and stale "run cctl fancurve start" hint after curve edits.

v5.0.1

Choose a tag to compare

@github-actions github-actions released this 28 Oct 19:42

Changes

• Snapshot listing: cctl snap / cctl snapshot without arguments now directly lists saved snapshot names with a clean, colorized overview and help hint.
• Dedicated snapshot view: cctl snap view <name> now requires <name>, separating snapshot inspection from listing.
• Snapshot --nosafe flag: Added --nosafe directly to cctl snap restore <name> [--nosafe]; deprecated the older --mask nosafe syntax.
• --dry-run restriction: Restricted --dry-run strictly to cctl set and cctl snap restore, removing unused/dead dry-run paths from hardware setters.
• Fan curve listing & view: cctl fancurve lists curves followed by a compact help hint; cctl fancurve view <name> now requires <name>.
• Help menu polish: Moved the EC codes 2/3 and Turbo fan-safety note to the bottom of the main help menu; renamed the --am description to (outputs usage guide skill for AI agents).
• Documentation & Agent Skill: Synchronized SKILL.md, src/cctl_skill.inc, README.md, docs/commands.md, and docs/developer-notes.md.
• Updated screenshots: Refreshed docs/screenshots/help.png and docs/screenshots/status.png with latest outputs.

v5.0

Choose a tag to compare

@github-actions github-actions released this 28 Oct 16:40

Changes

  • Added the embedded agent skill: cctl --am prints the complete SKILL.md, and agent workflows for custom profiles and fan curves expose their validation rules through --am.
  • Hardened agent create/edit flows: arguments are validated, duplicates are refused, and files are written only after successful validation.
  • Snapshots now embed the active fan-curve configuration (hysteresis, interval, and all points) and restore it last, independent of the saved profile file.
  • Snapshot restore stops a running curve when the snapshot recorded none, or replaces it with the saved curve; --mask fancurve leaves curve state untouched.
  • Snapshot restore always sets fans to EC automatic before applying settings, even when a curve is active; --mask nosafe skips this step.
  • Battery charge mode and thresholds are now saved and restored with snapshots (bat mask).
  • Snapshot restore ordering and validation were hardened across EC profile, Turbo, fan safety, and curve transitions.
  • cctl fancurve log now waits for a fan curve and keeps following across stops and restarts; Ctrl-C exits at any time.
  • Fan curves now handle suspend/resume through login1, with thermal fallback and improved resume detection.
  • cctl fancurve view / v with no name lists saved profiles, matching cctl snap view.
  • Added the fanc command alias and documented the st stop alias.
  • CPU governors and energy performance preferences are detected from the system's supported values.
  • CPU and GPU monitor JSON output and hardware discovery were improved.
  • Display refresh handling now supports highest wherever lowest is supported.
  • Refined fan-curve diagnostics and status output.
  • Fixed streamed usage output for cctl options streamtext, bounded invalid fan-curve names in errors, and replaced a hardcoded profile-header length with a computed value.

v4.8

Choose a tag to compare

@github-actions github-actions released this 25 Oct 20:25

cctl v4.8

• Custom fan curves. Create, view, edit, start, stop and remove named temperature-driven profiles with linear interpolation, hysteresis, configurable polling, and an optional handoff to EC automatic fan control. Curves run for the current boot and are not included in snapshots.

• Fan-curve crash recovery. The updated tuxedo_io driver restores EC automatic fan control when the curve worker exits unexpectedly, including after SIGKILL. A running curve holds the driver module in use, and curve startup requires tuxedo_io 0.3.10 or newer.

• Suspend and resume handling. When a login manager provides sleep notifications, a running curve releases fans to EC automatic control before suspend and resumes after wake. While suspended, it continues checking temperatures; if a wake notification is missed, it resumes curve control when a monitored temperature rises above 85 °C. If sleep notifications are unavailable, cctl reports that the pre-suspend handoff cannot be provided.

• cctl status now includes CPU/GPU fan telemetry and the active curve. EC profile status prefers a recognized live TCC offset and falls back to the tuxedo_io profile cache when needed.

• Manual fixed-duty fan controls are grouped under Experimental in help, with clearer guidance about their thermal behavior. Profile and Turbo fan-safety handling accounts for an active curve.

• Keyboard notifications. cctl kbn provides finite flash, pulse, sos, and police effects with preset or hex colors. Repeat counts default to one, repeated flash and pulse patterns are spaced out, police lights default to red and blue and accept custom color pairs, and the previous keyboard state is restored afterward.

• Shared CPU/GPU monitor and fan-safety helpers reduce duplicated logic. Help, command documentation, developer notes, and release packaging have also been refreshed.

v4.7

Choose a tag to compare

@github-actions github-actions released this 23 Oct 12:38

cctl v4.7

• Multi-monitor refresh control. cctl rr lists every active display with its resolution, current rate and supported rates. The internal panel is #1, the rest are #2, #3…, and cctl rr <rate> --2 targets one screen. Any numeric rate is accepted — xrandr snaps to the closest mode — and cctl prints the rate that was actually applied. toggle still cycles rates.

• The internal panel is detected in both MUX modes (eDP/LVDS, or the first DP-* such as DP-0 under dGPU), following the mode cctl mux reports. Connected but inactive outputs are listed and can't be targeted.

• cctl status shows every active display with its resolution and refresh rate. Scaling and profiles stay on the internal panel, and scaling keeps the current refresh rate instead of resetting it.

• powersave now drops the internal panel to its lowest rate under X11; custom profiles can set a rate as an optional 8th field.

• max keeps the powersave governor and uses EPP performance, so clocks still settle at idle. The README explains why EPP is what determines performance.

• Help, colours and docs tidied up: cleaner help output, line-by-line MUX confirmation with dGPU in red, updated GPU monitor hint, and a keyboard palette trimmed to 12 distinct presets.

v4.6.3

Choose a tag to compare

@github-actions github-actions released this 08 Oct 17:45

cctl v4.6.3

• Fan safety now follows the active EC code: applying EC 2 or 3 sets fans to AUTO. Turbo ON sets fans to AUTO only when EC 2 or 3 is active; EC 0 and 1 do not trigger AUTO solely because Turbo is enabled.
• Custom profiles and snapshot restore follow the same rule. Snapshot restore checks the live EC code before applying Turbo, even when ec_code is masked. Use --nosafe or snapshot --mask nosafe to bypass the automatic fan change.
• Profiles and power limits: clarified profile and load-test documentation, enforced PL1 and PL2 constraints in the CLI and snapshot restore, and added a thermal note for max mode.
• Snapshots and settings: improved snapshot restore checks and display, and addressed governor, power-limit, and keyboard-effect handling.
• Monitoring: added dedicated CPU/GPU monitors, per-thread frequency display, PROCHOT and soft-throttle detection, and terminal streaming modes. Removed mock monitor data and the gunfire keyboard effect.
• Updated README safety guidance and EC load test tables.
• Battery charge modes: added Custom and Standard charge mode selection (cctl bat <start> <stop> / cctl bat standard).
• Battery status & charge mode display: cctl status shows active battery charge mode (Custom or Standard); when Standard mode is active, charge thresholds are highlighted in red in status and marked as (disabled) in cctl bat.
• Application settings (cctl options): added persistent configuration stored in /var/lib/cctl/settings, including streamtext <on|off> and default <help|status> to configure whether bare cctl displays status or the help menu.
• Display controls: cctl status hides Display Scale when X11/xrandr is absent, matching refresh rate behavior.
• GPU clocks footnote: refined GPU clocks display to (self-recorded, not live)** with a footer clarifying that NVIDIA GPU clocks are self-recorded rather than read live from hardware.
• Source tree & UI: organized project sources into src/, added compact CPU monitor view for 118x30 terminals, and updated documentation.

v4.4.5

Choose a tag to compare

@github-actions github-actions released this 06 Oct 09:26

cctl 4.4.5

  • Added the live visual monitor as the default, with text (--text) and JSON (--json) modes still available.
  • Added q and Ctrl-C as quit options for visual and text monitors.
  • Added checksum-verified driver archive caching during installation, with graceful offline behavior and stale-cache guidance.
  • Improved driver checksum messages and installation feedback.
  • Added the guarded cctl uninstall command.

v4.4

Choose a tag to compare

@github-actions github-actions released this 05 Oct 15:00

cctl v4.4

  • Added snapshots and status updates.
  • Updated keyboard effects and NVIDIA commands.
  • Added custom RAPL overrides to profiles.
  • Refreshed screenshots and profile guidance.
  • Updated the release workflow to dispatch asset uploads and fixed its checksum lookup.

v4.2

Choose a tag to compare

@bhusann bhusann released this 05 Oct 07:40

cctl 4.2

  • Refactor the code into subsystem files and improve shared device and subprocess handling.
  • Add configurable user profiles, dry-run support, capabilities reporting, and JSON status and monitor output.
  • Remove the separate setR command; set leaves RAPL limits unchanged, with rapl available for explicit limits.
  • Improve help output and documentation; set the Lime keyboard preset to RGB 128, 255, 0.