geodesicgears(6x)

πŸ’« geodesicgears πŸ’«

okay bestie so this one lives in the XScreenSaver manual, section 6x, and it's called geodesicgears β€” yes, lowercase, yes, that's the vibe, that's the name, we don't change it πŸ’…


✨ NAME ✨

geodesicgears β€” gears on the surface of a sphere. that's it. that's the whole thing. spheres. gears. together. iconic behavior honestly πŸŽ€


🌸 SYNOPSIS 🌸

geodesicgears [--display host:display.screen] [--visual visual]
[--window] [--root] [--window-id number] [--delay number] [--timeout
number] [--labels] [--numbers] [--wireframe] [--wander] [--no-spin]
[--fps]

πŸ¦‹ DESCRIPTION πŸ¦‹

A set of meshed gears arranged on the surface of a sphere. like, that's the feel. gears that interlock, sitting all over a sphere like it's the most normal thing in the world. it is not, but she doesn't care, and neither should you 🫢


πŸ’– OPTIONS πŸ’–

  • --visual _visual_ β€” pick which visual to use, bestie. legal values are either the name of a visual class, or the id number of a specific visual (and the id number can be decimal or hex, so go off 🌈).
  • --window β€” draw on a newly-created window. this is the default, so if you do nothing, this is what you get ✨
  • --root β€” draw on the root window. the classic desktop takeover moment, no cap πŸ‘‘
  • --window-id _number_ β€” draw on the specified window. you point, it draws, we love a targeted queen 🎯
  • --delay _number_ β€” per-frame delay, in microseconds. default: 30000 (which is 0.03 seconds, for the people who think in seconds) ⏱️
  • --timeout _number_ β€” how long before it switches to a new model. valid range is 5 – 120 seconds. default: 20. she gets bored of her own gears and makes new ones, honestly relatable πŸ’€
  • --labels | --no-labels β€” whether to show the number of gears and teeth. default: no. so if you want the deets, you gotta ask πŸ™ˆ
  • --numbers | --no-numbers β€” whether to label the gears with ID numbers. default: no. yes, like little name tags but for gears, and honestly? cute 🌸
  • --wireframe | --no-wireframe β€” render in wireframe instead of solid. skeleton mode. x-ray mode. see-through realness 🩻✨
  • --wander | --no-wander β€” whether the object should wander around the screen. she roams. she's a free spirit πŸ¦‹
  • --spin | --no-spin β€” whether the object should spin. (heads up: the synopsis writes this one as --no-spin, but the option pair is --spin / --no-spin, k? πŸ’…)
  • --fps | --no-fps β€” whether to show a frames-per-second display at the bottom of the screen. numbers on screen, nerds thriving, we stan a measurable moment πŸ”₯

🌈 ENVIRONMENT 🌈

  • DISPLAY β€” to get the default host and display number. the classic. the original. the one your shell already knows about πŸ–₯️
  • XENVIRONMENT β€” to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property. overachieving file, love that for it πŸ’œ
  • XSCREENSAVER_WINDOW β€” the window ID to use with --root. yes, it's the --root one, don't mix them up bestie 🫢

πŸŽ€ SEE ALSO πŸŽ€

X(1), xscreensaver(1), geodesic(6x), pinion(6x)


Copyright Β© 2014 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.

okay so the important part: it's "as is", and there's no express or implied warranty. no promises about whether it's suitable for any purpose. so like, don't come for her if it doesn't do a thing you assumed it would. the permission is real and free, the warranty is not 😭

πŸ’œ AUTHOR πŸ’œ

Jamie Zawinski. we love a legend, we love a name credit, we love the consistency 🫢


and that's the whole page bestie!! this one's from X Version 11, shipped as 6.17-1.fc44, dated 13-Oct-2026 β€” so go spin some sphere gears, show the fps if you're feeling brave, and have the most mathematically slay day ever πŸ’–βœ¨πŸŽ€πŸ¦‹πŸŒΈπŸ’…πŸŒˆβ­πŸ‘‘

πŸ“¦ where this page comes from