A sleek, lightweight hardware control center for ASUS ROG and TUF laptops on Linux.
Like G-Helper, but built natively for your terminal. Fast, keyboard-driven, and zero bloat.
Full-resolution 60 FPS video demonstration available at assets/demo.mp4.
rogtui provides full hardware control for ASUS ROG and TUF laptops through a clean, modern terminal interface. Built in pure Rust, it launches in under 2ms, uses 0.0% CPU when idle, and speaks directly to asusd and supergfxd over system D-Bus.
- Instant Profile Switching: Toggle between Quiet, Balanced, and Performance modes on the fly (
p). - 8-Point Custom Fan Curves: Calibrate custom temperature-to-PWM fan curves for CPU and GPU fans with live thermal marker tracking (
◆). - AC / Battery Auto-Switching: Automatically switch profiles when connecting or disconnecting the charger.
- Safety Clamps: Enforces non-decreasing fan curves and emergency cooling minimums above 80°C.
- Health Charge Limiter: Set charging caps at 60% or 80% to prolong battery lifespan.
- One-Shot Travel Override: Charge to 100% for travel with a single keystroke (
Start ↵), automatically resetting back to your health limit once unplugged. - Live Battery Wattage: Real-time charge and discharge rates with threshold indicators.
- Hardware Aura Modes: Static, Breathe (with synchronized primary & secondary colors), Rainbow Cycle, and Pulse.
- Microphone Voice Pulse: Keyboard illuminates and dances in real-time to speech picked up by your microphone, complete with an adjustable sensitivity meter.
- Audio Pulse & Wave: Cava-style frequency spectrum visualizer directly across your keyboard backlight.
- Ambient Screen Sync: Matches keyboard colors to your active desktop window or wallpaper via Wayland.
- Dynamic Desktop Theme Sync: Smart palette detection synchronizes your keyboard with your active desktop theme and terminal accent colors.
- Background Daemon: Keep software RGB effects running smoothly in the background even after exiting (
rogtui-close/rogtui --daemon, <0.2% CPU). - Slash LED Controls: Automatically detected on supported Zephyrus models.
- Interactive Color Picker: 24-bit RGB/HSV color picker modal (
c) and direct hex entry (#).
- Sensor Monitoring: Instant CPU and GPU temperatures with 2-minute Braille history charts.
- Accurate Power Draw: Real-time CPU package power in Watts and dGPU power monitoring (gracefully indicating
D3cold (0 W)when suspended). - Aligned Specifications: Clean hardware summary with memory, processor, and graphics telemetry.
- Panel Overdrive: Toggle 3ms response time overdrive on supported high-refresh panels.
- GPU Mode Switching: Integrated, Hybrid, and dedicated GPU MUX switching integration via
supergfxd. - System Diagnostics: Export comprehensive markdown diagnostic reports with one key (
y).
| Telemetry Dashboard | Fan Curve Calibration |
|---|---|
 |
 |
| Power & Battery Lifespan | RGB Lighting & Reactive Voice |
|---|---|
 |
 |
Note: AUR package registration is temporarily closed upstream due to an Arch Linux automated account creation pause. In the meantime, install directly via Cargo or compile locally using the included PKGBUILD.
cargo install rogtuigit clone https://github.com/kmanisk/rogtui.git
cd rogtui
makepkg -siRequires Rust 1.80+:
git clone https://github.com/kmanisk/rogtui.git
cd rogtui
cargo build --release
install -Dm755 target/release/rogtui ~/.local/bin/rogtui| Key | Context | Action |
|---|---|---|
Tab / Shift+Tab |
Global | Switch to next / previous tab |
1 .. 5 |
Global | Jump directly to Dash, Power, Fan, RGB, or System |
j / k or Up / Down |
Lists | Navigate controls and menu items |
h / l or Left / Right |
Sliders / Menus | Adjust values, change presets, or cycle options |
Enter / Space |
Controls | Activate button, confirm modal, or open color picker |
m / M |
RGB | Cycle forward / backward through all 19 Aura effects |
p / P |
RGB | Cycle forward / backward through curated color presets |
b / B |
RGB | Adjust keyboard backlight brightness (Off, Low, Med, High) |
c |
RGB / Fan | Open color picker modal (RGB) / toggle custom fan curve (Fan) |
# |
RGB | Enter 6-digit hex color directly (e.g. ff4080) |
p |
Global | Quick cycle active Platform Profile (Dashboard) |
w |
Fan | Write staged fan curve to hardware EC |
r |
Fan | Reset selected fan curve to factory BIOS defaults |
f |
Fan | Toggle CPU / GPU fan curve selection |
y |
System | Export full markdown diagnostic report |
? |
Global | Open keyboard shortcuts help modal |
q / Esc |
Global | Dismiss modal / exit application |
You do not need to open the TUI to control keyboard lighting, presets, or effects. rogtui provides high-speed standalone CLI subcommands that execute directly over D-Bus in under 15ms.
| Command | Action |
|---|---|
rogtui aura next-mode (or rogtui next-effect) |
Cycle to the next Aura effect (hardware and software) |
rogtui aura prev-mode (or rogtui prev-effect) |
Cycle to the previous Aura effect |
rogtui aura next-preset (or rogtui next-preset) |
Cycle forward through curated color presets |
rogtui aura prev-preset (or rogtui prev-preset) |
Cycle backward through curated color presets |
rogtui aura toggle (or rogtui toggle-rgb) |
Toggle keyboard backlighting on or off |
rogtui aura brightness [up|down|off|low|med|high|0-3] |
Set brightness level directly |
rogtui aura status |
Print current Aura mode, color preset, and brightness |
rogtui --close |
Stop the background daemon and turn off RGB lighting |
- Autonomous Daemon Management: If an active software effect (such as Audio Pulse, Audio Wave, Ambient Audio Sync, Rainbow Wave, or Thermal Heatmap) is selected,
rogtuiautomatically manages the background daemon (rogtui --daemon, <0.2% CPU). When cycling back to a hardware effect (Static, Breathe, Rainbow), the daemon automatically yields and terminates. - Bidirectional Live Synchronization: If
rogtuiis currently running on your screen, triggering external keybindings or CLI subcommands immediately hot-reloads the active TUI in real-time within 50ms without restarting the app or dropping state.
# Hardware laptop keys
bindsym XF86Launch4 exec --no-startup-id rogtui aura next-mode
bindsym Shift+XF86Launch4 exec --no-startup-id rogtui aura next-preset
bindsym XF86KbdBrightnessUp exec --no-startup-id rogtui aura brightness up
bindsym XF86KbdBrightnessDown exec --no-startup-id rogtui aura brightness down
# Universal chords (Super + Alt)
bindsym $mod+Mod1+m exec --no-startup-id rogtui aura next-mode
bindsym $mod+Mod1+Shift+m exec --no-startup-id rogtui aura prev-mode
bindsym $mod+Mod1+p exec --no-startup-id rogtui aura next-preset
bindsym $mod+Mod1+Shift+p exec --no-startup-id rogtui aura prev-preset
bindsym $mod+Mod1+b exec --no-startup-id rogtui aura toggle
# Hardware laptop keys
bind = , XF86Launch4, exec, rogtui aura next-mode
bind = SHIFT, XF86Launch4, exec, rogtui aura next-preset
bind = , XF86KbdBrightnessUp, exec, rogtui aura brightness up
bind = , XF86KbdBrightnessDown, exec, rogtui aura brightness down
# Universal chords (Super + Alt)
bind = SUPER ALT, M, exec, rogtui aura next-mode
bind = SUPER ALT SHIFT, M, exec, rogtui aura prev-mode
bind = SUPER ALT, P, exec, rogtui aura next-preset
bind = SUPER ALT SHIFT, P, exec, rogtui aura prev-preset
bind = SUPER ALT, B, exec, rogtui aura togglekeymap:
- name: Rogtui Aura Controls
remap:
Super-Alt-m: { launch: ["rogtui", "aura", "next-mode"] }
Super-Alt-p: { launch: ["rogtui", "aura", "next-preset"] }
Super-Alt-b: { launch: ["rogtui", "aura", "toggle"] }Software RGB animations, reactive microphone meters, and ambient screen sync can run headlessly after closing the UI:
- Launch background daemon:
rogtui --daemon - Stop background daemon:
rogtui-closeorpkill -f "rogtui --daemon" - Resource overhead: Consistently under 0.2% CPU and ~6 MiB RSS.
rogtui supports all ASUS laptops supported by the Linux kernel ASUS WMI drivers and the asus-linux.org daemon stack:
- ROG Zephyrus: G14, G15, G16, M16, Duo 15/16
- ROG Strix / SCAR: Strix G15-G18, SCAR 15-18
- TUF Gaming: A15, A16, F15, F16, Dash series (FA506, FA507, FX506, FX507, FX607, FX608)
- ROG Flow & Handhelds: X13, X16, Z13, ROG Ally, ROG Ally X
- Linux kernel 6.1+ with
asus_wmimodule asusdv6.5.0+ (systemctl is-active asusd)supergfxdv5.2.7+ (for GPU switching)
For technical specifications, D-Bus interfaces, and architecture deep-dives:
docs/rogtui-hardware-control.md: Hardware control architecture and Aura algorithms.docs/asusctl-architecture-and-effects.md: Complete D-Bus endpoints and sysfs telemetry.docs/parity.md: Feature parity comparison with Armoury Crate and G-Helper.
Licensed under either of Apache License, Version 2.0 (LICENSE-APACHE) or MIT license (LICENSE-MIT) at your option.