pekwm_bg(1)

💖 pekwm_bg — the manual, but make it cute 💖

okay bestie, so this is the pekwm_bg(1) page from the User Manual, and I'm gonna walk you through it like we're texting at 2am. it's not long, it's not scary, and by the end you're gonna be setting backgrounds like it's nothing. periodt. ✨

🌸 NAME 🌸

pekwm_bg — a simple background setting application. that's literally the whole job. it sets your background and it does it well. no notes. 💅

🦋 SYNOPSIS 🦋

pekwm_bg [--display] texture

so like, you give it a texture and it goes. optionally you can pass --display in there too. that's the shape of it. 🎀

✨ DESCRIPTION ✨

okay so pekwm_bg is a simple background setting application that ships bundled together with pekwm. the way it usually gets used? whenever a theme has a background texture specified, pekwm_bg is typically what runs. it's the little background girlie doing her job in the background (pun fully intended, ate that). 👑

here's the thing that's actually kind of iconic: pekwm_bg repeats the texture on each head, which makes images appear once for every available head. multiple monitors? every single one gets the goods. no monitor left behind fr fr. 🌈

and the tea: pekwm_bg accepts textures in the same format as pekwm themes. the most common ones for backgrounds are these three besties right here:

• Image background.png#scaled — an image, in this case background.png scaled to screen size. glow up. 🖼️
• Solid #eeeeee — a solid color. yes, #eeeeee. simple, clean, valid, iconic. 💜
• LinesHorz 33% #afadbf #9f9daf #afadbf — 3 horizontal lines. that's three (3) whole lines. horizontal ones. slay. 📏

💅 OPTIONS 💅

• --daemon — run as a daemon. it just goes and lives in the background by itself. main character energy but make it ✨independent✨.
• --display DISPLAY — connect to DISPLAY instead of the DISPLAY set in the environment. basically "no bestie, use this display, not the one the env said." 🙈
• --help — show help information. when in doubt. always. we love a helper. 🫶
• --load-dir DIR — load images from the specified directory DIR. tell it where your pictures live. 🍓
• --stop — stop the running pekwm_bg daemon. bye bye daemon, you did great, take care. 💀

🎀 SEE ALSO 🎀

literally nothing else listed here, bestie. that's it. that's the whole page. we respect a short manpage. 😭

okay so that's the entire vibe. go forth, set textures, repeat them on every head, live your truth. no cap. 🦋💖

and finally, the lil' sign-off: this page comes from the pekwm_bg manual itself, dated February 2021, and yes it's pekwm_bg(1) — section one of the manual, for pekwm_bg. you made it to the end bestie, I'm so proud of you. goodbye, mwah. 💅⭐