devilspie(1)

💖 devilspie(1) 💖

okay bestie, welcome to the General Commands Manual section for devilspie, and no cap, this one is a whole vibe 🦋

✨ NAME ✨

devilspie — do lil actions on windows the second they get created 💅

---

✨ SYNOPSIS ✨

devilspie [OPTION]... configuration-files...

---

🌸 DESCRIPTION 🌸

so devilspie is this program that literally watches windows being born 👶✨ — the moment one gets created, it peeks at it, and if the window matches a set of criteria you set up, it does stuff to it. main character energy, honestly.

the configuration files are a set of s-expressions, iykyk. for documentation and examples, go look at /usr/share/doc/devilspie/.

command-line options, let's go:

• -a, --apply-to-existing — applies to all the windows that already exist, not just the new babies. 🍼
• -d, --debug — spills the debug info everywhere. 💀

---

🎀 ALLOWED SYMBOLS 🎀

in your input files, these are the symbols devilspie actually knows and fw:

• is — string equality, (is a b) means a is the same as b. simple as that. ✨
• contains — substring check, (contains haystack needle) means haystack contains needle. 🔍
• matches — regexp matches, (matches str pattern) means the regexp pattern matches str. 👑
• window_name — returns the title of the current window (String). 🏷️
• window_role — returns the role of the current window, as determined by the WM_WINDOW_ROLE hint (String).
• window_class — returns the class of the current window (String). 🎀
• window_xid — returns the X11 window id of the current window (Integer).
• application_name — returns the application name of the current window, as determined by libwnck (String).
• window_property — returns the given property of the window, like, pass it "_NET_WM_STATE" and you get that back (String). 💖
• window_workspace — returns the workspace a window is on (Integer).
• debug — debugging function, outputs the current window's title, name, role and geometry (Returns TRUE).
• print — print args, no trailing 0, returns boolean. 🖨️
• println — print args, with trailing 0, returns boolean.
• str — transform parameters into strings and concat them. 🧵
• hex — transform the integer parameter into an unsigned hexadecimal string, with the 0x prefix.
• geometry — set position + size (as tring) of current window (returns boolean).
• fullscreen — make the current window fullscreen (returns TRUE). 🌈
• focus — focus the current window (returns TRUE). 👀
• center — center position of current window (returns boolean).
• maximize — maximise the current window (returns TRUE). 🔥
• maximize_vertically — maximise vertically the current window (returns TRUE).
• maximize_horizontally — maximise horizontally the current window (returns TRUE).
• unmaximize — un-maximise the current window (returns TRUE).
• minimize — minimise the current window (returns TRUE). 🙈
• unminimize — un-minimise the current window (returns TRUE).
• shade — shade ("roll up") the current window (returns TRUE).
• unshade — un-shade ("roll down") the current window (returns TRUE).
• close — close the current window (returns TRUE). bye bestie 💀
• pin — pin the current window to all workspaces (returns TRUE). 📌
• unpin — unpin the current window from all workspaces (returns TRUE).
• stick — make the current window stick to all viewports (returns TRUE).
• unstick — unstick the window from viewports (returns TRUE).
• set_workspace — move the window to a specific workspace number, counting from 1 (returns boolean).
• set_viewport — move the window to a specific viewport number, counting from 1 (returns boolean).
• skip_pager — remove the current window from the window list (returns TRUE).
• skip_tasklist — remove the current window from the pager (returns TRUE).
• above — set the current window to be above all normal windows (returns TRUE). ⬆️
• below — set the current window to be below all normal windows (returns TRUE). ⬇️
• decorate — add the window manager decorations to the current window (returns boolean).
• undecorate — remove the window manager decorations from the current window (returns boolean).
• wintype — set the window type of the current window (returns boolean). the accepted values are: normal, dialog, menu, toolbar, splashscreen, utility, dock, desktop. ✨
• opacity — change the opacity level of the current window, as an integer in 0..100 (returns boolean). 🫥
• spawn_async — execute a command in the background (returns boolean). the command is given as a single string, or as a series of strings, similar to execl. 🚀
• spawn_sync — execute a command in the foreground (returns command output as string, or FALSE on error). the command is given as a single string, or as a series of strings, similar to execl.

---

💀 BUGS 💀

ngl, this manpage is almost useless, because it was thrown together on a train. not me exposing the whole origin story 😭🚂

---

💜 AUTHOR 💜

this manual page was written by Ross Burton <ross@burtonini.com>.

---

and that's the whole thing, bestie — you made it to the end of devilspie(1), so go forth and un-maximise something 🎀✨