gtk-layer-demo(1)

📦 version 0.10.1, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 gtk-layer-demo — the GTK Layer Shell Demo Application ✨

okay bestie, so this is gtk-layer-demo, a little program from the GTK Layer Shell Demo Application family, and it's literally here to Demonstrate the functionality of the Layer Shell Wayland protocol. That's the whole job. She's a demo and she's thriving. 🎀

✨ SYNOPSIS ✨

gtk-layer-demo [ options ]

🦋 DESCRIPTION 🦋

So, GTK Layer Shell? It's a library, and its whole vibe is letting you write GTK applications that use Layer Shell. And Layer Shell itself is a Wayland protocol made for desktop shell components — think panels, notifications, wallpapers, all that good stuff. 👑

The way it works is you can anchor your windows to a corner or an edge of the output, or stretch them across the entire output. Full main character energy, your choice. 🌈

lowkey important: this library only makes sense on Wayland compositors that support Layer Shell, and it will not work on X11. Not a "hmm maybe", not a "with a workaround" — it just won't. 💀

She supports all Layer Shell features too, including popups and popovers. GTK popups Just Work™. That's not me being cute, that's the actual trademarked-sounding claim, and honestly? iconic. ✨

And gtk-layer-demo is the GTK application that demonstrates the functionality of the Layer Shell Wayland protocol as addressed by the GTK Layer Shell library. Basically a playground where you get to see all of this happen in real time. 🫶

💅 OPTIONS 💅

  • -l, --layer — the layer type, bestie. Any of 'overlay', 'top', 'bottom' or 'background' — or the little shorthand versions 'o', 't', 'b' or 'g' if you're feeling efficient. 🍓
  • -a, --anchor — a sequence of 'l', 'r', 't' and 'b' to anchor to those edges, or '0' for no anchor at all. Pick your edges, girl. 📌
  • -m, --margin — a comma separated list of margin values, in the order <LEFT>,<RIGHT>,<TOP>,<BOTTOM>. Yes, that order specifically. Don't come for me, I don't make the rules. 💖
  • -e, --exclusive — enable auto-exclusive zone. ✨
  • -k, --keyboard — enable keyboard interactivity. Now she listens. ⌨️
  • -f, --fixed-size — enable a fixed window size. No growing, no shrinking, just commitment. 🌸

🌟 AUTHOR 🌟

This manual has been written for the Debian project by Mike Gabriel <mike.gabriel@das-netzwerkteam.de>. Thank you Mike, you ate. 🫡

and that's the whole page, bestie!! Version 0.1.0, from the GTK Layer Shell Demo Application manual — go anchor some windows and slay 💅✨🦋

📦 where this page comes from