SAPPHIRE(1)

📦 version 0.15.8, in ubuntu jammy

SAPPHIRE(1) 💎✨

okay bestie, welcome to the manual page for sapphire, straight out of the General Commands Manual section of your friendly neighbourhood Unix system. grab a boba, we're doing this 💅

✨ NAME ✨

sapphire — minimal but configurable window manager 🪟🦋

🌸 SYNOPSIS 🌸

sapphire [-display displayname  | -version ]

that's it. that's the whole vibe. two options, zero drama 🎀

💖 DESCRIPTION 💖

so this manual page is here to document the sapphire command, like, briefly. it was written for the Debian GNU/Linux distribution because the original program literally does not have a manual page — so Debian said "fine, we'll do it ourselves" and honestly? iconic behaviour 👑

sapphire is a minimal but configurable window manager for X11R6. it supports themes in the form of X resource files, and it has a customisable menu. lowkey everything you need, highkey nothing you don't ✨

the Debian version receives Debian menu entries automatically, in a "Debian" submenu, by default. if you wanna add entries specifically to sapphire — like, in the rest of the menu — you do that in the default-menu file. for more info, go look at update-menus(1) and the FILES section down below, bestie 📋

you can also set your own options in $HOME/.sapphire/wmconf, which is an X resource file. personalise her!! 🎀

💅 OPTIONS 💅

  • -display displayname — use the X-server display 'displayname'. like, tell her where to show up 🖥️
  • -version — show the version of the program. slay, now you know what you're running 💜

🎀 FILES 🎀

  • /etc/X11/sapphire/menu/default-menu — menu entries specific to sapphire. you can edit this one, it's a conffile, go off ✏️
  • /etc/X11/sapphire/menu/menudefs.hook — Debian menu entries in sapphire's format. it is not read directly, and you should not edit it. (edit default-menu instead, fr fr 🙈)
  • /etc/X11/sapphire/menu/default — this menu file is the one sapphire actually reads. it is automatically generated from the other two by update-menus. do not edit it (edit default-menu instead, no cap 🚫)
  • $HOME/.sapphire/wmconf — user-specific options 🫶
  • /usr/share/sapphire/themes — the themes directory. all of the above may refer to themes from here, and the files themselves are X resource files 🌈

🦋 HISTORY 🦋

Sapphire was originally developed from Decklin Foster's aewm, and it also uses some code from Blackbox (for gradients). a real glow-up story ✨

🌟 SEE ALSO 🌟

XFree86(1), update-menus(1).

👑 AUTHOR 👑

this manual page was written by Chris Boyle <cmb@debian.org> for the Debian GNU/Linux system (but it may be used by others, she's generous like that 💖).

permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts and no Back-Cover Texts. periodt 📜✨

and that's the whole page, bestie!! this was SAPPHIRE(1) from the General Commands Manual — go run her, theme her up, and live your main character window manager era 💅💎🌈

📦 where this page comes from