switcheroo-control
TLDR
List available GPUs
SYNOPSIS
switcherooctl [options] [command]
DESCRIPTION
switcherooctl is the command-line interface for switcheroo-control, a daemon that manages hybrid graphics on Linux laptops with multiple GPUs. It provides a simple way to list available graphics adapters and launch applications on a specific GPU.
On hybrid graphics systems with both integrated (power-efficient) and discrete (high-performance) GPUs, applications default to the integrated GPU. Using switcherooctl, you can run specific applications on the discrete GPU for better graphics performance.
The underlying daemon interfaces with the kernel's vga_switcheroo subsystem and provides a D-Bus API that desktop environments like GNOME and KDE use for GUI-based GPU selection.
Setting the environment variable DRI_PRIME=1 achieves a similar effect for individual applications.
PARAMETERS
-g, --gpu index
GPU index to use for launch command.-h, --help
Display help information.-v, --version
Display version information.
COMMANDS
list
List known GPUs with their indices and capabilities.launch command
Launch application on discrete GPU (or specified GPU with -g).
CAVEATS
Requires switcheroo-control.service to be running. Only works on systems with hybrid graphics (typically laptops with Intel/AMD integrated and Nvidia/AMD discrete GPUs). Detection may incorrectly identify GPUs in some configurations. Does not provide mux switching (for systems with hardware mux).
HISTORY
switcheroo-control was developed for the GNOME desktop to provide a user-friendly interface for hybrid graphics management on Linux. It abstracts the kernel's vga_switcheroo mechanism, allowing desktop environments to offer "Launch using Discrete Graphics" options in application menus.
SEE ALSO
prime-run(1), nvidia-settings(1), glxinfo(1)


