#tui #nvidia #switching #gpu #laptop #envy #nvidia-gpu #hybrid #ratatui #optimus

app envy-tui

TUI manager for EnvyControl - GPU switching for Nvidia Optimus laptops

3 releases

0.1.3 Jan 14, 2026
0.1.2 Jan 13, 2026
0.1.0 Jan 12, 2026

#44 in Graphics APIs

MIT license

230KB
797 lines

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

Dependencies

~8–14MB
~274K SLoC