LinuxCommandLibrary
GitHubF-DroidGoogle Play Store

envycontrol

GPU switching utility for Nvidia Optimus laptops

TLDR

Switch between GPU modes
$ sudo envycontrol [-s|--switch] [nvidia|integrated|hybrid]
copy
Specify display manager manually
$ envycontrol --dm [gdm|gdm3|sddm|lightdm]
copy
Check current GPU mode
$ sudo envycontrol [-q|--query]
copy
Reset settings
$ sudo envycontrol --reset
copy
Display help
$ envycontrol [-h|--help]
copy
Display version
$ envycontrol [-v|--version]
copy

SYNOPSIS

envycontrol [options]

DESCRIPTION

envycontrol is a GPU switching utility specifically designed for Nvidia Optimus laptops running Linux. It provides a streamlined interface for switching between integrated Intel/AMD graphics, hybrid mode (both GPUs active), and dedicated Nvidia GPU mode without requiring manual configuration file editing.
The tool simplifies power management and performance tuning on dual-GPU systems by handling the complex configuration changes needed for GPU mode switching, including display manager setup and driver configuration. Changes require a system reboot to take effect as the underlying graphics stack must be reinitialized.

PARAMETERS

-s, --switch mode

Switch to nvidia, integrated, or hybrid
--dm manager
Specify display manager
-q, --query
Show current GPU mode
--reset
Reset to default settings
-h, --help
Display help message
-v, --version
Display version

CAVEATS

Requires Nvidia Optimus laptop. Changes require reboot to take effect. Display manager must be correctly specified. May conflict with other GPU switching solutions.

SEE ALSO

Copied to clipboard
Kai