BGS(1)

📦 version 0.8, in nixos 26.05, nixpkgs unstable

💖 BGS(1) — bgs, the background setter 💖

okay so welcome to the BGS(1) page from the General Commands Manual, bestie — this is all about bgs, aka the background setter. 🫶

🌸 NAME 🌸

bgs — background setter. literally the whole name, and it ate.

✨ SYNOPSIS ✨

bgs [-v] [-c] [-C hex] [-z] [-R] [-x] [IMAGE1...IMAGEN]

🦋 DESCRIPTION 🦋

bgs lets you tailor the appearance of the background ("root") window on a workstation display running X. iconic behavior, no cap.

It uses imlib2 for image rendering and rotates the images automatically. it's designed for dynamic Xinerama/Xrandr setups — the kind used with notebooks — but it works well in any setup. versatile queen. 👑

💅 OPTIONS 💅

  • -v — prints version information to standard output, then exits. short and sweet.
  • -c — centers image rather than scaling it. centering era.
  • -C hex — specifies background color to use when the image does not fill the screen. pick your hex, bestie.
  • -z — zooms image rather than scaling it. zoom zoom.
  • -R — prevents automatic rotation for optimal screen fill. sometimes you just need it to stay put.
  • -x — switches to dynamic mode. bgs will update your background as soon as the root window changes. main character responsiveness.

if multiple images are specified, each image is set for each monitor, in order. monitor-by-monitor, in order, periodt.

👀 SEE ALSO 👀

dwm(1) and xsetroot(1) — go check those besties too. 🫶

💀 BUGS 💀

bgs can't decide how the monitor is rotated if you use xrandr-rotation, so it assumes the monitor is rotated clockwise. not me guessing your monitor rotation 😭 — that's just the vibe check it does.

okay that's the page, bestie 💖 the footer sign-off is bgs-0.8 from BGS(1), and there's no date in this footer to mention. 🎀

📦 where this page comes from