halo(6x)

✨ halo(6x) — the XScreenSaver manual, but make it cute ✨

okay bestie, buckle up, because this one is literally the XScreenSaver manual entry for halo, and it's giving iconic circle energy 💅

---

🌸 NAME 🌸

halo — draws circular patterns. yes. circles. that's the whole vibe. 🌀

---

🦋 SYNOPSIS 🦋

halo [--display host:display.screen] [--foreground color] [--background color]
     [--window] [--root] [--window-id number][--mono] [--install]
     [--visual visual] [--count int] [--delay usecs]
     [--mode seuss | ramp | random ] [--animate] [--colors integer] [--fps]

like, that's the whole incantation. copy it, paste it, slay. ✨

---

💖 DESCRIPTION 💖

so the halo program draws cool patterns based on circles. that's it. that's the plot. and honestly? it ate. 🔥

---

🎀 OPTIONS 🎀

halo accepts the following options, bestie — every single one, no skips:

• --window — draw on a newly-created window. this is the default, so if you do nothing, this is what you get. main character energy by default, fr fr.
• --root — draw on the root window instead. going full background wallpaper mode. 🌈
• --window-id number — draw on the specified window. you pick the window, you pick the destiny. 👑
• --mono — if you're on a color display, pretend we're on a monochrome display. delulu? maybe. but it's what the flag does. 💀
• --install — install a private colormap for the window. lil private color situation, just for you. 🎨
• --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. yes, decimal or hex. we contain multitudes. 🔢
• --count integer — how many circles to draw. default 0, meaning random. so zero means "surprise me" and honestly? iconic. 🎲
• --mode seuss | ramp | random — the mode selector, and it's a whole personality quiz:
  • in seuss mode, alternating striped curves will be drawn. striped. curves. dr. seuss would be obsessed. 🍓
  • in ramp mode, a color ramp will be drawn. smooth gradient moment. 🌈
  • random means pick the mode randomly. chaos, but make it aesthetic. 🙈
• --delay microseconds — how much of a delay should be introduced between steps of the animation. default 100000, or about 0.1 second. slow it down, speed it up, it's your world. ⏳
• --colors integer — how many colors to use. default 100. one hundred colors, no cap. 💜
• --animate — if specified, then the centerpoints of the circles will bounce around. otherwise, the circles will be drawn once, erased, and a new set of circles will be drawn. bouncing circles = highkey the fun option. 🏀
• --fps — display the current frame rate and CPU load. numbers on screen. we love a stats girlie. 📊

---

🌟 ENVIRONMENT 🌟

the environment variables, bestie, they're doing the behind-the-scenes work:

• 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. deep lore, iykyk. 🧚
• XSCREENSAVER_WINDOW — the window ID to use with --root. noted and filed away. 💫

---

🫶 SEE ALSO 🫶

X(1), xscreensaver(1) — go read those too, bestie, they're the extended universe. 📚

---

👑 COPYRIGHT 👑

Copyright © 1993 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, word for word, because copyright is not the place to freestyle 💅

---

🦋 AUTHOR 🦋

Jamie Zawinski <jwz@jwz.org>, 6-jul-93. a legend, honestly. 🫡

---

ngl, that's the whole page. every flag, every default, every env var, every legal line — all here. no details lost, just vibes added. ✨

---

and finally, the cute sign-off you asked for: this is X Version 11, version 6.09 (07-Jun-2024), and the manual page is halo(6x). periodt. 💖🎀🦋🌸