headroom(6)

headroom6

A twitchy head.

Usage

headroom [--display host:display.screen] [--visual visual] [--window] [--root] [--window-id number] [--delay number] [--speed number] [--spin [XYZ]] [--no-wander] [--no-mask] [--wireframe] [--fps]

Overview

"Back in my day, we used to say 'No future'. Well. This is it." -- Blank Reg

Options

--visual visual

Specify which visual to use. Legal values are the name of a visual class, or the id number (decimal or hex) of a specific visual.

--window

Draw on a newly-created window. This is the default.

--root

Draw on the root window.

--window-id number

Draw on the specified window.

--delay number

Per-frame delay, in microseconds. Default: 20000 (0.02 seconds).

--speed number

Animation speed. 2.0 means twice as fast, 0.5 means half as fast.

--spin 0

Don't rotate.

--spin [XYZ]

Around which axes should the object spin?

--wander | --no-wander

Whether the object should wander around the screen.

--mask | --no-mask

Mask Headroom.

--wireframe | --no-wireframe

Render in wireframe instead of solid.

--fps | --no-fps

Whether to show a frames-per-second display at the bottom of the screen.

Environment

DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

XSCREENSAVER_WINDOW

The window ID to use with --root.

Author

Jamie Zawinski; suit model by Jared Williams.

From xscreensaver 6.15-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.