braid(6x)

🌈 braid 💅 (XScreenSaver manual, bestie edition)

💖 NAME 💖

braid — draws random color-cycling braids around a circle. literally the whole point, and it's iconic. 🌀💖

✨ SYNOPSIS ✨

braid [--display host:display.screen] [--foreground color] [--background
color] [--window] [--root] [--window-id number][--mono] [--install]
[--visual visual] [--ncolors integer] [--delay microseconds] [--cycles
integer] [--count integer]

[--fps]

🦋 DESCRIPTION 🦋

okay so braid draws random color-cycling braids around a circle. that's the vibe. no cap, it's giving rainbow spiral main character energy. 🌈🌀

🎀 OPTIONS 🎀

braid accepts the following options:

• --window — draw on a newly-created window. This is the default. ✨
• --root — draw on the root window. 🌍
• --window-id number — draw on the specified window. 🪟
• --mono — if on a color display, pretend we're on a monochrome display. delulu grayscale era 💀
• --install — install a private colormap for the window. fancy private vibes 💅
• --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. 🎨
• --ncolors integer — how many colors should be used (if possible). Default 64. The colors used cycle through the hue, making N stops around the color wheel. 🌈
• --cycles integer — the original page lists this in the synopsis but doesn't give it a separate description. mysterious icon behavior 🕵️‍♀️
• --count integer — same deal: it's in the synopsis, but the original page doesn't expand on it. lowkey mysterious ✨
• --fps — display the current frame rate and CPU load. performance check, slay 📊

synopsis-only cuties 💫

these show up in the synopsis, but the original OPTIONS text doesn't give them their own blurbs, so no invented lore bestie:

• --display host:display.screen — in the synopsis; original page doesn't add a separate OPTIONS description. 🌍
• --foreground color — in the synopsis; original page doesn't add a separate OPTIONS description. 🎨
• --background color — in the synopsis; original page doesn't add a separate OPTIONS description. 🖌️
• --delay microseconds — in the synopsis; original page doesn't add a separate OPTIONS description. ⏱️

🌸 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 👑

go say hi to these: X(1), xscreensaver(1), xlock(1). 💖

🧚 COPYRIGHT 🧚

okay legal bestie moment, preserving the exact copyright + permission text because we do not mess with license wording:

Copyright © 1995 by John Neil. 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.

💜 AUTHOR 💜

• the author line is literally John Neil <neil@math.idbsu.edu>, 29-Aug-95. 👑
• and: Ability to run standalone or with xscreensaver added by Jamie Zawinski <jwz@jwz.org>, 10-May-97. 🫶

---

okay that's the whole page, bestie — X Version 11, version 6.09, dated 07-Jun-2024. bye and slay 💖✨