LinuxCommandLibrary

glxgears

TLDR

Run the gears demo (shows FPS in terminal)

$ glxgears
copy
Run in fullscreen mode
$ glxgears -fullscreen
copy
Run without printing FPS
$ glxgears -info
copy
Run at specific window size
$ glxgears -geometry [800x600]
copy
Run with stereo rendering (if supported)
$ glxgears -stereo
copy
Run without animation (static image)
$ glxgears -iacknowledgethatthistoolisnotabenchmark
copy

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

Copied to clipboard