gravitywell(6)

📦
version 6.15 · 2 versions
, in alpine 3.24, arch rolling, nixpkgs unstable

✨ gravitywell — the XScreenSaver manual page, but make it cute ✨

okay so bestie, this is gravitywell(6), straight out of the XScreenSaver manual, and honestly? it's giving cosmic. buckle up 🪐💫

🌌 NAME 🌌

gravitywell — spaaaaace. that's it. that's the whole name. iconic, no notes 💅

🚀 SYNOPSIS 🚀

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

literally just run it with whatever flags your heart desires, bestie 🫶

🌠 DESCRIPTION 🌠

Massive objects distort space in a two dimensional universe. that's the vibe. big heavy things, bending the fabric of a flat little cosmos, no cap 😭✨

🎀 OPTIONS 🎀

  • --visual visual — tells it which visual to use, bestie. legal values are the name of a visual class, or the id number (decimal or hex) of a specific visual. yes, hex. she's versatile 💜
  • --window — draw on a newly-created window. this is the default, so like. it's already doing this unless you say otherwise 🪟
  • --root — draw on the root window. main character behavior tbh 👑
  • --window-id number — draw on the specified window. you pick which one. you're the boss 🎯
  • --delay number — per-frame delay, in microseconds. default: 30000 (that's 0.03 seconds, if math isn't your era) ⏱️
  • --speed number — animation speed. 2.0 means twice as fast, 0.5 means half as fast. so like, 2.0 is the caffeine version ☕🔥
  • --resolution number — density of the underlying universe. default: 1.0. the underlying universe, bestie, she said what she said 🌌
  • --grid-size number — grid size. smaller values are more dense. default: 1.0. tiny number = tight vibes 🔍
  • --count number — number of stars. default: 15. fifteen little icons ✨⭐🌟

🌸 ENVIRONMENT 🌸

  • DISPLAY — to get the default host and display number. the classic 🖥️
  • XENVIRONMENT — to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property. yes it's a mouthful, yes it matters 💅
  • XSCREENSAVER_WINDOW — the window ID to use with --root. the lil helper 🫶

🦋 SEE ALSO 🦋

X(1), xscreensaver(1) — go read those too, bestie, i believe in you 📚✨

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 read that one, it's the legal bits and we don't skip those 😌

💖 AUTHOR 💖

Jamie Zawinski.

and that's the whole page, bestie!! 🌈🎀 this was X Version 11, dated 6.15 (30-Mar-2026) — mwah, go bend some space 💋💫

📦 where this page comes from