juggler3d(6)

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

💅 juggler3d — the XScreenSaver manual, section 6 🎪

okay so picture this: a little stick-man, just out here, juggling. that's the whole bit. bestie, this is juggler3d from the XScreenSaver manual, and it literally draws a stick-man juggling various collections of objects. main character energy fr fr ✨

🎀 SYNOPSIS 🎀

number] [--window ] [--mono ] [--install | --noinstall ] [--visual
visual ] [--window-id id ] [--pattern pattern ] [--tail number ] [--real
| --no-real ] [--describe | --no-describe ] [--balls | --no-balls ]
[--clubs | --no-clubs ] [--torches | --no-torches ] [--knives |
--no-knives ] [--rings | --no-rings ] [--bballs | --no-bballs ] [--count
count ] [--cycles cycles ] [--delay delay ] [--ncolors ncolors ] [--fps]

🌸 DESCRIPTION 🌸

Draws a stick-man juggling various collections of objects. that's it. that's the saver. and honestly? iconic. 👑

✨ OPTIONS ✨

juggler3d accepts the following options, and yes we're going through all of them, no skipping, i don't gatekeep 🫶

  • --display host:display.screen — which X11 display to use. overrides the DISPLAY environment variable, like a boss.
  • --root — draw on the root window.
  • --window-id number — draw on the specified window.
  • --window — draw on a newly-created X window. this is the default, so like, you're already living it 💅
  • --mono — draw in monochrome. sad beige juggling for sad beige times.
  • --install | --noinstall — turn on/off installing colormap.
  • --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 girlies rise 🌈
  • --window-id id — draw on an already existing X window. (yes, it's listed again. no, i'm not editing the lore. both stay.)
  • --pattern " pattern " — specify juggling pattern in annotated site-swap notation. in site-swap notation, the "height" of each throw is given. e.g., "3" is the height needed to juggle a 3-Cascade. ⚠️ note that these sequences need to be chosen carefully, to avoid collisions — the math does NOT cover for you, bestie.

annotations indicate relative hand movements or tricks:

  • - — Inside throw (default)
  • + — Outside throw
  • = — Cross Throw
  • & — Cross Catch
  • x — Cross Throw and Catch
  • _ — Bounce
  • --pattern "[ pattern ]" — specify juggling pattern in annotated Adam notation. Adam notation is a little harder to visualize 😭 each integer n represents a cyclic permutation of (0...n). the equivalent site-swap value is determined by calculating how many of the permutations it takes to get back to the identity. the largest number used is the same as the number of objects in the pattern. the advantage of Adam notation is that these sequences do not need to be chosen carefully, since all possible sequences are juggle-able. slay. annotations are the same as in site-swap notation.

for example, both of these describe a 3-Shower:

--pattern "+5 1"

--pattern "[+3 1]"

for further examples, see the portfolio list in the source code. iykyk 📚

  • --tail number — Minimum Trail Length. 0 - 100. Default: 1. Objects may override this — for example flaming torches always leave a trail. 🔥 (they're dramatic like that.)
  • --real|--no-real — turn on/off real-time juggling. Deprecated. there should be no need to turn off real-time juggling, even on slow systems. adjust speed using --count above. like, this flag is so 2004, we don't need it 💀
  • --describe|--no-describe — turn on/off pattern descriptions.
  • --balls|--no-balls — turn on/off Balls.
  • --clubs|--no-clubs — turn on/off Clubs.
  • --torches|--no-torches — turn on/off Flaming Torches. 🔥🔥🔥
  • --knives|--no-knives — turn on/off Knives. (do not try this at home, it's a screensaver)
  • --rings|--no-rings — turn on/off Rings.
  • --bballs|--no-bballs — turn on/off Bowling Balls.
  • --count number — Speed. 50 - 1000. Default: 200. this determines the expected time interval between a throw and the next catch, in milliseconds. this is the actual speed knob, use this one 🎚️
  • --cycles number — Performance Length. 50 - 1000. Default: 1000. setting this smaller will force the juggler to switch patterns (and objects) more often. shorter setlist, more variety, we love a medley 🎶
  • --delay delay — additional delay between frames, in microseconds. Default: 10000. Deprecated. adjust speed using --count. bestie i'm begging you, use --count 😭
  • --ncolors ncolors — maximum number of colors to use. Default: 32.
  • --fps — display the current frame rate and CPU load. nerd stats but make it cute 📊

🦋 ENVIRONMENT 🦋

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

🌈 SEE ALSO 🌈

X(1), xscreensaver(1) — go read those too, they're the parent lore 🫶

Copyright © 1996,2000,2002,2004 by Tim Auckland. 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, keep it intact, it's load-bearing 💅)

🧚 AUTHOR 🧚

Tim Auckland.

Converted to OpenGL by Jamie Zawinski, 2009.

and that's the whole page, bestie — no cap, every flag accounted for 💖 this lil legend dropped as X Version 11, version 6.15, dated 30-Mar-2026. go juggle something. 🎪✨🍓

📦 where this page comes from