HSETROOT(1)

📦
version 1.0.5 · 2 versions
  • 1.0.5 · debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking (latest)
  • 1.0.5 · opensuse-leap 16.0
, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 HSETROOT — yet another wallpaper application 💖

okay bestie, welcome to hsetroot(1), the General Commands Manual glow-up. this is the tool that makes your X desktop actually serve looks. 🎀

✨ SYNOPSIS ✨

hsetroot [ command1 [ args... ] ] [ command2 [ args... ] ]

🌸 DESCRIPTION 🌸

so like. hsetroot is a tool that lets you compose wallpapers — and by wallpapers we mean "root pixmaps" for X, no cap. 🖼️ it has a LOT of options: rendering gradients, solids, images… but that's not even the best part. it also lets you perform manipulations on those things, or chain them together like a lil pipeline of aesthetic excellence. the way that you can just stack commands… obsessed. 💅

👑 OPTIONS 👑

🌈 Generic Options:

  • -root — treat multiple displays as one big screen, aka ignore xrandr outputs entirely. one screen, one vibe, periodt. ✨
  • -screens <int> — set a screenmask to use. it's giving very precise, very controlled. 🎯

🧚 Gradients:

  • -add <color> — add a color to the range using distance 1. the default lil sprinkle. 🌈
  • -addd <color> <distance> — add a color to the range using a custom distance, for when you wanna be specific about it. 💜
  • -gradient <angle> — render the gradient using the specified angle. tilted, but make it fashion. 📐
  • -clear — clear the color range. fresh slate, main character energy. 🧼

🍓 Solid:

  • -solid <color> — render a solid using the specified color. simple, clean, iconic, no notes. 🎀

🦋 Image files:

  • -center <image> — render an image centered on the screen. dead center, as it should be. 🎯
  • -cover <image> — render an image centered on the screen, scaled so that all of the screen is covered. no empty space allowed, she fills the room. 💅
  • -tile <image> — render an image tiled. repeat repeat repeat, she's everywhere and we love that for her. 🔁
  • -full <image> — render an image at maximum aspect. 📏
  • -extend <image> — render an image at maximum aspect, and copy a 1px border taken from the image over the remaining area so that no black borders are shown. truly the "no ugly edges" queen. 👑✨
  • -fill <image> — render an image strechted. (yes, that's the original spelling, bestie, we're keeping it exactly as-is, it's part of the lore now 🫶)

🌟 Manipulations:

  • -tint <color> — tint the current image. give it a lil wash of mood. 🌸
  • -blur <radius> — blur the current image. soft focus, dreamy, ethereal. ☁️
  • -sharpen <radius> — sharpen the current image. crisp, snatched, HD. 🔥
  • -contrast <amount> — adjust contrast of the current image. 🎚️
  • -brightness <amount> — adjust brightness of the current image. ☀️
  • -gamma <amount> — adjust the gamma level of the current image. 🌗
  • -flipv — flip the current image vertically. upside down era. 🙃
  • -fliph — flip the current image horizontally. mirror mirror. 🪞
  • -flipd — flip the current image diagonally. the chaos flip, diagonal diva. 💫

💀 Misc:

  • -alpha <amount> — adjust the alpha level for colors and images. transparency is a lifestyle. 🫧
  • -write <filename> — write the current image to a file. save your work, bestie, don't lose the masterpiece. 💾

💖 AUTHORS 💖

Hyriand <hyriand@thegraveyard.org

(that's the exact line from the page, unclosed bracket and all — not me, that's just how it was handed down to us 🙈)

okay so that's the whole page, we ate and left no crumbs. 🍽️✨

this lil manual is from the General Commands Manual, dated July 29, 2012, and it's filed under HSETROOT(1) — so go forth, set that root pixmap, and make your desktop the moment. slay. 💅🌈👑

📦 where this page comes from