geodesicgears(6)

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

💅 geodesicgears(6) — XScreenSaver manual, but make it make sense

okay so bestie, you know how gears are already iconic? imagine them. on a sphere. yeah. this is that. welcome to the XScreenSaver manual page for geodesicgears, and yes i'm gonna walk you through every single flag because that's what we do here 🫶

✨ SYNOPSIS ✨

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

copy that exactly, don't be cute with it 🎀

🌸 DESCRIPTION 🌸

A set of meshed gears arranged on the surface of a sphere.

that's it. that's the whole vibe. it's giving "clockwork but make it a planet" and honestly? obsessed 💖

✨ OPTIONS ✨

every single one, in order, no skips, no cap 🔥

  • --visual visual — pick which visual you want. legal values are either the name of a visual class, or the id number (decimal or hex) of one specific visual. choose wisely 👑
  • --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 instead. main character energy, full screen 🖥️
  • --window-id number — draw on the window you specify. you pick the window, it fills it 🪟
  • --delay number — per-frame delay, in microseconds. default: 30000 (that's 0.03 seconds, if you're counting at home ⏱️)
  • --timeout number — how long before it switches to a new model. range is 5 - 120 seconds. default: 20. so yeah, new model every twenty seconds, keep up 💅
  • --labels | --no-labels — whether to show the number of gears and teeth. default: no. turn it on if you want the receipts 🏷️
  • --numbers | --no-numbers — whether to label the gears with ID numbers. default: no. name them, number them, treat them like the little icons they are 🔢
  • --wireframe | --no-wireframe — render in wireframe instead of solid. skeleton mode. gorgeous. 🌐
  • --wander | --no-wander — whether the object should wander around the screen. yes it can just. go places 🦋
  • --spin | --no-spin — whether the object should spin. the classic. the iconique. 🌀
  • --fps | --no-fps — whether to show a frames-per-second display at the bottom of the screen. for the nerds who need the numbers (love u) 📊

🌈 ENVIRONMENT 🌈

  • DISPLAY — this is where it gets the default host and display number 🖥️
  • XENVIRONMENT — this one's for getting the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property. very "iykyk" of it 💜
  • XSCREENSAVER_WINDOW — the window ID to use with --root 🪟

🦋 SEE ALSO 🦋

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

go read them, they're all friends 🌸

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.

that's the legal bit, and yeah it's wordy, but it's important — keep the notice in your copies, bestie, that's the whole deal 🙈

👑 AUTHOR 👑

Jamie Zawinski.

okay that's the whole page, slay 💅✨ and for the record, this was X Version 11, 6.15 (30-Mar-2026) — date stamped and everything, so you know it's fresh. mwah 🫶🍓

📦 where this page comes from