grav(6x)

✨ grav(6x) — the XScreenSaver manual, bestie edition ✨

okay so you found the grav(6x) page in the XScreenSaver manual and you're like "what is this" — don't worry, I gotchu 💖

---

🌸 NAME 🌸

grav — it draws a simple orbital simulation. that's it. that's the whole vibe. 🪐✨

---

🦋 SYNOPSIS 🦋

grav [--display host:display.screen] [--foreground color] [--background
color] [--window] [--root] [--window-id number][--mono] [--install]
[--visual visual] [--ncolors integer] [--delay microseconds] [--count
integer] [--decay] [--no-decay] [--trail] [--no-trail]

[--fps]

like yes, that's a lot of brackets, but they're all optional bestie, breathe 💀

---

💫 DESCRIPTION 💫

The grav program draws a simple orbital simulation.

that's literally the whole description. short king energy. 👑 but honestly? it's giving "the code speaks for itself" and honestly it ate. 🌈

---

🎀 OPTIONS 🎀

grav accepts the following options:

• --window — draws on a newly-created window. this is the default, so if you do nothing, congrats, you already picked this one 🫶
• --root — draws on the root window. main character energy, it's on everything ✨
• --window-id number — draws on the specified window. you pick, you choose, you slay 💅
• --mono — if you're on a color display, this makes it pretend we're on a monochrome display. delulu but make it retro 🖤🤍
• --install — installs a private colormap for the window. fancy 🎩
• --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. hex? decimal? both valid, we love a flexible icon 🔥
• --ncolors integer — how many colors should be used (if possible). default 64. and the colors are chosen randomly, so it's a lil surprise every time 🎨🙈
• --count integer — default 12. twelve lil orbiters. a dozen. a baker's dozen minus one 🍓
• --decay
• --no-decay — whether orbits should decay. yes this is a real toggle, no cap 🌀
• --trail
• --no-trail — whether the objects should leave trails behind them (makes it look vaguely like a cloud-chamber). lowkey iconic, highkey physics-core 🧚‍♀️💨
• --fps — display the current frame rate and CPU load. numbers go brrr 📊

ok quick heads up — the way this page is laid out, --decay/--no-decay are listed as a pair, and --trail/--no-trail are listed as a pair, with the description sitting under the second one. that's just how the original rolls, not me being chaotic 💀

---

🌺 ENVIRONMENT 🌺

• DISPLAY — to get the default host and display number. the classic. the OG. iykyk 🖥️
• XENVIRONMENT — to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property. say that five times fast, i dare you 😭
• XSCREENSAVER_WINDOW — the window ID to use with --root. pairing them up like they're meant to be 🫶

---

👑 SEE ALSO 👑

X(1), xscreensaver(1), xlock(1)

the holy trinity of "your screen is doing something and you should know why" fr fr 🌟

---

💜 COPYRIGHT 💜

Copyright © 1993 by Greg Bowering.

Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation.

tl;dr: go off, just keep the notice in there. respect the paperwork bestie 📜💖

---

🧚 AUTHOR 🧚

Greg Bowering <gb@pobox.com>, 1993.

Ability to run standalone or with xscreensaver added by Jamie Zawinski <jwz@jwz.org>, 10-May-97.

shoutout to the 90s devs, they were really out here building orbiting dots before it was cool 🛰️💫

---

and that's the whole page!! we made it 🌈✨

sign-off time 🎀 this little beauty is X Version 11, version 6.09 (07-Jun-2024) — screenshot it, cite it, obsess over it, periodt 💅💖