headroom(6x)

📦
version 6.17 · 10 versions
, in fedora 44

💫 headroom — the manual, but make it a group chat 💫

okay bestie, so this is a page from the XScreenSaver manual — section 6x, if you're keeping score. it's called headroom. buckle up. 🎀

✨ NAME ✨

headroom — a twitchy head. that's it. that's the whole premise. a head. it twitches. 💅

🌸 SYNOPSIS 🌸

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

like, that's the whole invocation. copy-paste it, run it, watch a head do its little head things. no cap. ✨

🦋 DESCRIPTION 🦋

okay so the entire description is this quote, and honestly? it EATS. iykyk:

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

that's the vibe check. that's the whole description. iconic behavior from a screensaver honestly. 😭💖

👑 OPTIONS 👑

here's where we get into the good stuff, bestie. every single flag, no skipping, periodt. 🫶

  • --visual visual — pick which visual you wanna use. legal values are either the name of a visual class, or the id number of a specific visual (and you can write that number in decimal or hex). ✨
  • --window — draw on a newly-created window. this is the default, so if you do nothing at all, congrats, this is what you get. 💅
  • --root — draw on the root window instead. main character energy.
  • --window-id number — draw on the specific window you point at. yes, that one.
  • --delay number — per-frame delay, measured in microseconds. default: 20000, which is 0.02 seconds. so teeny. so tiny. 🍓
  • --speed number — animation speed. 2.0 means twice as fast, 0.5 means half as fast. math is math. 🔥
  • --spin 0 — don't rotate. head stays still. respectful.
  • --spin [XYZ] — okay but around which axes should the object spin? you tell it. 🌀
  • --wander | --no-wander — whether the object should wander around the screen. it's giving "unsupervised toddler at the mall."
  • --mask | --no-mask — mask Headroom. 😷
  • --wireframe | --no-wireframe — render in wireframe instead of solid. skeleton mode, lowkey gorgeous.
  • --fps | --no-fps — whether to show a frames-per-second display at the bottom of the screen. number go up, serotonin go up. 📈

🌈 ENVIRONMENT 🌈

the environment variables said hello, and they're important, so here they are:

  • DISPLAY — used to get the default host and display number. 🖥️
  • XENVIRONMENT — used 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.

💜 SEE ALSO 💜

go read those too, bestie. expanding your brain is always in style. 🧚

Copyright © 2020 by Jamie Zawinski.

Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation. No representations are made about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty.

like, yes, free to use and share and even SELL — just keep the copyright notice and this permission notice in there. that's the deal. 🤝

⭐ AUTHOR ⭐

Jamie Zawinski; suit model by Jared Williams. legends only. 👑

and that's the whole page, bestie!! this bad boy is from X Version 11, packed as 6.17-1.fc44, dated 13-Oct-2026, and it lives in the headroom(6x) section of the XScreenSaver manual. take care of her. mwah. 💖💅✨

📦 where this page comes from