gravitywell(6x)

📦
version 6.17 · 10 versions
, in fedora 44

💫 gravitywell(6x) 💫

okay bestie, this is a page from the XScreenSaver manual, and no bc same, we're talking about gravitywell. spaaaaace. that's literally the whole name. iconic.

🚀 SYNOPSIS

gravitywell [--display host:display.screen] [--visual visual] [--window]
[--root] [--window-id number] [--delay number] [--speed number]
[--resolution number] [--grid-size number] [--count number]

🪐 DESCRIPTION

So like… massive objects distort space in a two dimensional universe. that's it. that's the whole vibe. heavy things bend the fabric of spacetime and you get to watch it happen. no cap. 🌌

✨ OPTIONS ✨

  • --visual visual — pick which visual you wanna use, bestie. legal values are either the name of a visual class, or the id number of a specific visual (and yes, decimal or hex both work, we're not monsters).
  • --window — draw on a newly-created window. this is the default, so if you don't say anything, this is what you get. the way it just does that 💅
  • --root — draw on the root window instead. planting your little space garden directly on the desktop, obsessed.
  • --window-id number — draw on the specified window. you have to tell it which one, though, it can't read your mind (yet).
  • --delay number — per-frame delay, measured in microseconds. default is 30000, which is 0.03 seconds, if you're not into counting microseconds. lowkey a whole language of its own.
  • --speed number — animation speed. 2.0 means twice as fast, 0.5 means half as fast. so like, 1.0 is just… normal speed. slay.
  • --resolution number — the density of the underlying universe. yes, THE UNIVERSE. default: 1.0. we are literally tuning reality here.
  • --grid-size number — Grid Size. smaller values are more dense. default: 1.0. tiny number = crowded grid, iykyk.
  • --count number — Number of stars. default: 15. bring more stars, bring fewer stars, you're the main character.

🌸 ENVIRONMENT 🌸

  • DISPLAY — used to get the default host and display number. it's how gravitywell knows where to show up.
  • XENVIRONMENT — used to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property. yes that's a lot of words, it's giving ✨configuration✨.
  • XSCREENSAVER_WINDOW — the window ID to use with --root.

👀 SEE ALSO

X(1), xscreensaver(1) — go read those too, they're the whole friend group.

Copyright © 2019 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.

fr fr, that's the legal bit, please don't skip it, it's the one part you can't vibe your way around. 🙈

👑 AUTHOR

Jamie Zawinski.

okay that's the whole page, you ate that. this was X Version 11, 6.17-1.fc44, dated 13-Oct-2026, and that's a wrap bestie — go distort some spacetime 💖🦋✨

📦 where this page comes from