glxgears
TLDR
Run the gears demo (shows FPS in terminal)
SYNOPSIS
glxgears [-display display] [-info] [-stereo] [-fullscreen] [-geometry WxH]
DESCRIPTION
glxgears is an OpenGL demo that renders three rotating gears. It displays frames per second (FPS) in the terminal every 5 seconds, making it commonly used to verify that OpenGL and GPU acceleration are working correctly.
The application creates a simple GLX window and renders the classic gears animation using OpenGL. When working properly, modern systems typically show several thousand FPS (capped by vsync to monitor refresh rate when composited, or much higher when unthrottled).
The FPS display makes glxgears useful for quick GPU sanity checks: if you see reasonable FPS (hundreds to thousands) and smooth animation, OpenGL acceleration is working. Very low FPS (under 60) may indicate software rendering or driver issues.
Despite common use as a "benchmark," glxgears tests very little of modern GPU capabilities. It uses ancient OpenGL features that aren't representative of real application performance. The FPS number is heavily influenced by vsync, compositing, and rendering pipeline configuration rather than actual GPU power.
PARAMETERS
-display display
Specify X display to use.-info
Print GL renderer info and suppress FPS output.-stereo
Enable stereo rendering (requires hardware support).-fullscreen
Run in fullscreen mode.-geometry WxH
Set window size (width x height).-iacknowledgethatthistoolisnotabenchmark
Disable animation (for static screenshots).
CAVEATS
NOT a valid benchmark for GPU performance comparison. FPS varies wildly based on vsync, window size, compositing, and driver settings. Only tests minimal OpenGL functionality. Cannot detect many GPU driver issues. Stereo mode requires specific hardware.
HISTORY
glxgears was written by Brian Paul around 1999 as part of Mesa, the open-source OpenGL implementation. It was created as a simple demo to test GLX (OpenGL Extension to X11) functionality. Despite disclaimers, it became widely misused as a benchmark due to its readily visible FPS counter. The "iacknowledgethatthistoolisnotabenchmark" flag was added as a humorous commentary on this misuse.
SEE ALSO
glxinfo(1), vulkaninfo(1), xdpyinfo(1), vkcube(1)


