FBSETBG(1)

💖 FBSETBG(1) 💖 — the Fluxbox Manual's cutest wallpaper setter

okay bestie, gather round, because this is fbsetbg from the Fluxbox Manual and she is literally the most low-maintenance icon in your whole dotfiles situation 💅

---

✨ NAME ✨

fbsetbg — Set a background wallpaper or pattern 🦋

---

🌸 SYNOPSIS 🌸

fbsetbg [-uU wallpapersetter] [-fFcCtTaA] wallpaper

fbsetbg [-uU wallpapersetter] -rR path

fbsetbg -bB fbsetrootoptions...

fbsetbg [-l|h|i|p]

---

🎀 DESCRIPTION 🎀

fbsetbg(1) is a wrapper. That's her whole job. She goes out, finds a suitable background-setting app, and then sets your wallpaper using that app. And the way you don't have to configure her at all?? No config file, no ceremony, no nothing — she just uses the first app she can find. Queen behavior honestly 👑

On top of that, she remembers the last wallpaper you set, so you don't have to go edit your style or your init-file just to change your wallpaper. She said "not me doing manual labor for you" 🙈

And she aims to give you clear error messages in a window, which makes debugging your problems actually easy. It's giving supportive bestie energy fr fr 💖

---

💅 OPTIONS 💅

• -f file — Set a fullscreen wallpaper. 🖼️
• -c file — Set a centered wallpaper.
• -t file — Set a tiled wallpaper. 🧚
• -a file — Set a maximized wallpaper, preserving aspect. Heads up though: if your bgsetter doesn't support this option, fbsetbg falls back to -f. (She tried her best 😭)
• -u wallpapersetter — Use the wallpapersetter you specify. Give her no argument and she'll forget it entirely. 💀
• -b fbsetrootoptions — Forward the options along to fbsetroot(1). These can be used to set a solid, pattern, or gradient background texture. ✨
• -r directory — Set a random wallpaper from a directory. Spontaneous era 🌈
• -F, -C, -T, -A, -U, -B, -R — Same as the lowercase option, but without remembering. No memories, no receipts, we move on. 💅
• -l — Set the previous wallpaper. Or, if the random feature was last used, set another random wallpaper from the same directory. 🎲
• -i — Display useful information about the best wallpapersetter found.
• -p — Display some useful tips. 🫶
• -h — Display a help message.

---

🗂️ FILES 🗂️

• ~/.fluxbox/lastwallpaper — In this file the wallpaper you set will be stored, for the -l option. She's keeping the receipts so you don't have to 📝

---

🌱 ENVIRONMENT 🌱

• wpsetters — Wallpapersetters to use. This can be a space-delimited list of the applications to try, or just a single name.
• DISPLAY — The display you want to set the wallpaper on.

---

🌟 EXAMPLES 🌟

To use feh(1) as wallpapersetter and set wallpapper.jpg from the current directory as wallpaper.

$ wpsetters=feh fbsetbg wallpaper.jpg

Recall the last set wallpaper on display :0.0 with the stored options.

$ DISPLAY=:0.0 fbsetbg -l

---

💀 BUGS 💀

fbsetbg(1) is not foolproof. She's iconic, not omniscient, bestie. 🙈

---

👑 AUTHORS 👑

The author of fbsetbg is Han Boetes <han at fluxbox.org> 💖

This manpage was converted to asciidoc format by Jim Ramsay <i.am at jimramsay.com> for fluxbox-1.1.2

---

🔥 SEE ALSO 🔥

fluxbox(1) fbsetroot(1)

---

⭐ AUTHOR ⭐

Jim Ramsay <i.am@jimramsay.com>

• Author.

---

okay that's the whole page, no cap 🫶 this was fbsetbg.txt, version from 08 February 2015, and yeah she's literally titled FBSETBG(1) in the Fluxbox Manual — go set a wallpaper, you main character 🎀✨🌸