xflame(6x)

✨ NAME ✨

okay so bestie, this is xflame(6x) — from the XScreenSaver manual — and it draws animated flames. that's the whole name-section vibe: xflame — draws animated flames. 🔥💖

---

🌈 SYNOPSIS 🌈

here's the summoning spell, exactly as written:

xflame [--display host:display.screen] [--window] [--root] [--window-id
number][--install] [--visual visual] [--foreground color] [--hspread
int] [--vspread int] [--residual int] [--variance int] [--vartrend int]
[--bloom  --no-bloom] [--bitmap xbm-file] [--baseline int] [--fps]

no cap, that's the whole incantation. 🫶

---

💅 DESCRIPTION 💅

The xflame program draws animated flames across the bottom of the screen. they're lowkey living down there, and the flames occasionally flare up — like a little drama moment, but make it fire. 🔥

If a bitmap is specified, that image will float above the flames, burning. yes, burning. main character energy fr. 🎀

---

✨ OPTIONS ✨

xflame accepts the following options: 💖

• --display host:display.screen — this one is in the synopsis, bestie; it takes a host:display.screen value. don't leave it out. 🦋
• --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. 🪟
• --install — install a private colormap for the window. 🎨
• --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. 👀
• --foreground color or --fg color — the color of the flames; default red. (the background color is always black.) 🖤
• --bitmap xbm-file (the options text calls the arg filename) — specifies the bitmap file to use (a monochrome XBM file). the name "none" means not to use a bitmap at all. if unspecified, a built-in image will be used. 🖼️

then we hit the arcane zone, and the original is so real for this:

The other options are arcane. If someone would care to document them, that would be great.

so here are those mysterious little guys, still undocumented:

• --hspread int — arcane, undocumented. no extra tea in the original.
• --vspread int — arcane, undocumented. same.
• --residual int — arcane, undocumented. yep.
• --variance int — arcane, undocumented. still mysterious.
• --vartrend int — arcane, undocumented. iconic mystery.
• --bloom, --no-bloom — arcane, undocumented; the synopsis writes them as [--bloom --no-bloom]. 💀
• --baseline int — arcane, undocumented. that's the vibe.
• --fps — displays the current frame rate and CPU load. slay, metrics. 📈

---

🌸 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, bestie. 📚✨

---

👑 COPYRIGHT 👑

Copyright © 1996-1999 by Carsten Haitzler. 💖

the legal bit, preserved with care:

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.

---

🦋 AUTHOR 🦋

Primarily written by Carsten Haitzler <raster@redhat.com>. Modified over the years by Rahul Jain <rahul@rice.edu>, Daniel Zahn <stumpy@religions.com>, and Jamie Zawinski <jwz@jwz.org>. absolute legends, honestly. 🌟

okay bye bestie 🫶 — this was xflame(6x) from X Version 11, 6.09 (07-Jun-2024). stay flaming. 💅🔥