cubetwist(6x)

✨ cubetwist(6x) ✨ β€” the XScreenSaver manual, but make it cute πŸ’«

okay so picture this: it's a page from the XScreenSaver manual, and it's about a little program called cubetwist. she's an icon, she's a legend, and she is literally just cubes inside cubes inside cubes, all spinning and sliding, recursively, forever. the moment. πŸ§ŠπŸ¦‹


🌸 NAME 🌸

cubetwist β€” a series of nested cubes rotate and slide recursively. that's it. that's the whole vibe. no cap.


πŸ’… SYNOPSIS πŸ’…

cubetwist [--display host:display.screen] [--visual visual] [--window]
[--root] [--window-id number] [--delay number] [--speed number]
[--thickness number] [--displacement number] [--no-flat] [--no-wander]
[--no-spin] [--wireframe] [--fps]

like, you run her, she does cube stuff. periodt. ✨


🌈 DESCRIPTION 🌈

a series of nested cubes rotate and slide recursively. bestie that's genuinely the entire description, it's giving "mysterious main character who says two words and leaves." and honestly? it ate. πŸ’–


πŸ‘‘ OPTIONS πŸ‘‘

here's every single knob and dial you get to play with, no gatekeeping:

  • --visual visual β€” pick which visual to use. legal values are either the name of a visual class, or the id number of a specific visual (decimal or hex both work, we don't discriminate 🫢).
  • --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 instead. bold choice, love that for you.
  • --window-id number β€” draw on the specific window you point at. you pick, she paints. πŸ’…
  • --delay number β€” per-frame delay, measured in microseconds. default: 30000 which is 0.03 seconds, in case your brain also refuses to think in microseconds bestie, same.
  • --speed number β€” animation speed. 2.0 means twice as fast, 0.5 means half as fast. math girlies rise πŸ™ˆ
  • --thickness number β€” thickness of the cube edges. range is 0.005 - 0.2. default: 0.05.
  • --displacement number β€” displacement between the nested cubes. range is 0.0 - 0.2. default: 0.01.
  • --flat | --no-flat β€” whether to use flat shading, or lighting. default is flat.
  • --wander | --no-wander β€” whether the object should wander around the screen. let her roam 🧚
  • --spin | --no-spin β€” whether the object should spin. (why would you turn this off. anyway.)
  • --wireframe | --no-wireframe β€” render in wireframe instead of solid. skeleton-mode realness πŸ’€
  • --fps | --no-fps β€” whether to show a frames-per-second display at the bottom of the screen. numbers go brrr πŸ”₯

πŸ¦‹ ENVIRONMENT πŸ¦‹

the environment variables she reads, because she's nosy in the best way:

  • DISPLAY β€” used to get the default host and display number.
  • XENVIRONMENT β€” used to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property. ikyk 🌸
  • XSCREENSAVER_WINDOW β€” the window ID to use with --root.

πŸŽ€ SEE ALSO πŸŽ€

go read the siblings, they're all iconic:


Copyright Β© 2016 by Jamie Zawinski.

so here's the legal tea, and I'm telling you exactly what it says: permission is hereby granted to use, copy, modify, distribute, and sell this software and its documentation for any purpose, without fee β€” provided that the above copyright notice appears 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. (yes bestie, that means no promises. she is what she is. 😭)


🌟 AUTHOR 🌟

Jamie Zawinski. πŸ‘‘


lowkey shoutout to X Version 11, version 6.17-1.fc44, dated 13-Oct-2026 β€” that's the whole source-and-date situation, mwah, bye bestie πŸ’–βœ¨πŸŽ€
πŸ“¦ where this page comes from