FBSETROOT(1)

💖 FBSETROOT 💖

okay bestie, so this is the fbsetroot page from the Fluxbox Manual and it's genuinely one of my faves 🫶 it's a lil background utility that the fluxbox(1) window manager uses, and it was originally written for and by the og blackbox(1) window manager. vintage queen behavior honestly 👑

---

✨ SYNOPSIS ✨

fbsetroot [-display display] -solid color

fbsetroot [-display display] -mod x y -fg color -bg color

fbsetroot [-display display] -gradient texture -from color -to color

fbsetroot -help

---

🌸 DESCRIPTION 🌸

so fbsetroot(1) is a utility that controls how the root window looks, and it does that in exactly three ways:

• give it a solid color 💅
• write a two color modula pattern to it ✨
• render a gradient texture, based on two different colors 🦋

it's giving xsetroot(1) energy in terms of functionality, but no cap it does more: it supports multiple-screen displays, and gradient textures the same way that blackbox or fluxbox does. the way it doesn't handle cursors etc. though?? not its job, not its problem 🙈

ngl the lore is iconic: fbsetroot was originally part of the Blackbox package and got carried over with the code that became Fluxbox. back in those days it was called bsetroot. glow-up era fr fr 👑

and if any errors are encountered, fbsetroot will use either gxmessage(1) or xmessage(1) to inform the user of errors. it will let you know bestie 😭

---

🎀 OPTIONS 🎀

okay so fbsetroot operates in three ways, and you must choose one of the first 3 options. choose wisely, main character 🫶

• -solid color — sets the root window to the specified color 💖
• -mod x y — creates a modula pattern. you must specify -bg and -fg colors, periodt ✨
• -gradient texturestring — renders the specified texture string to the root window 🌈

so texturestring may be one of:

Horizontal / Vertical / Diagonal / Crossdiagonal / Pipecross /
Elliptic / Rectangle / Pyramid

select one of these texture types — they only apply when -gradient is specified. you must also specify both a -from and a -to color, no skipping 💅

• -display display — tells fbsetroot to connect to the specified display 🌸
• -bg, -background color — background color. needed for -mod patterns 🦋
• -fg, -foreground color — foreground color. needed for -mod patterns 🦋
• -from color — start color for rendering textures. needed for -gradient patterns ✨
• -to color — ending color for rendering textures. needed for -gradient patterns ✨
• -help — prints version info and short help text. iconic behavior honestly 👑

---

💜 AUTHORS 💜

this manpage was modified by Curt "Asenchi" Micol <asenchi at asenchi.com> for the Fluxbox window manager 🫶

further updates for fluxbox-1.1.2 and conversion to asciidoc format by Jim Ramsay <i.am at jimramsay.com> ✨

---

🌟 SEE ALSO 🌟

fluxbox(1) fbsetbg(1) xsetroot(1) xmessage(1) gxmessage(1)

---

👑 AUTHOR 👑

Jim Ramsay <i.am@jimramsay.com>

• Author.

---

and that's the whole page bestie, every last detail preserved, no crumbs left 💖

k thanks for coming to my ted talk, this was fbsetroot.txt, dated 08 February 2015, from the Fluxbox Manual. slay, stay hydrated, and go set that root window 🧚✨💅