envy-tui

Crates.ioenvy-tui
lib.rsenvy-tui
version0.1.3
created_at2026-01-12 20:50:09.587867+00
updated_at2026-01-14 20:46:15.913651+00
descriptionTUI manager for EnvyControl - GPU switching for Nvidia Optimus laptops
homepage
repository
max_upload_size
id2038834
size283,081
Tássio Virgínio (tassiovirginio)

documentation

README

Envy TUI

A Terminal User Interface (TUI) manager for EnvyControl - Easy GPU switching for Nvidia Optimus laptops under Linux.

Rust License

Features

  • Modern TUI - Beautiful terminal interface built with Ratatui
  • Mode Switching - Switch between Integrated, Hybrid, and Nvidia modes
  • Advanced Options - Configure RTD3, Coolbits, and ForceCompositionPipeline
  • Visual Feedback - Color-coded modes and clear status indicators
  • Keyboard Navigation - Vim-style keybindings for efficient control

Prerequisites

  • EnvyControl installed on your system
  • Rust toolchain (for building from source)

Installation

Arch Linux (AUR)

yay -S envy-tui-bin

From Source

# Clone the repository
git clone https://github.com/yourusername/envy-tui.git
cd envy-tui

# Build and install
cargo install --path .

Usage

# Run the TUI
envy-tui

Keybindings

Key Action
↑/↓ or j/k Navigate
Tab Switch between panels
Enter Apply selected mode
Space Toggle option
r Reset EnvyControl
q or Esc Quit

Graphics Modes

Mode Description
Integrated Uses Intel/AMD iGPU exclusively. Nvidia GPU is turned off for power saving.
Hybrid Enables PRIME render offloading. GPU can be dynamically turned off when not in use.
Nvidia Uses Nvidia dGPU exclusively. Higher performance, higher power consumption.

Options

Hybrid Mode

  • RTD3 Power Management - Enable PCI-Express Runtime D3 power management (Turing+)

Nvidia Mode

  • Force Composition Pipeline - Fix screen tearing
  • Coolbits - Enable GPU overclocking options

License

MIT License - see LICENSE for details.

Acknowledgments

Commit count: 0

cargo fmt