KATRIAC(1)

💖 NAME 💖

Welcome to the General Commands Manual era, bestie: this is katriac(1), the client for katriawm. Its whole thing is being the lil messenger girl for your window manager. 🫶

✨ SYNOPSIS ✨

katriac command [arguments]

🌸 DESCRIPTION 🌸

So katriac can be used to control katriawm(1). For example, you can tell the WM to move windows, switch workspaces, and so on — very main character energy for your hotkeys. 💅

It should be called from a hotkey daemon like nhkd(1), okay? That’s the vibe.

katriac expects exactly one command, likely followed by some arguments. Like, one command only, but bring its lil args along. The following commands are available:

🎀 The commands, bestie 🎀

• client_center_floating — If the currently selected client is floating, center it on the currently selected monitor. ✨
• client_close — Ask the currently selected client to gracefully close itself. Polite queen behavior. 🎀
• client_floating_toggle — Toggle floating mode of currently selected client.
• client_fullscreen_toggle — Toggle fullscreen mode of currently selected client.
• client_kill — Kill the currently selected client. No questions asked. 💀 Like… okay then.
• client_maximize_floating — If the currently selected client is floating, maximize it on the currently selected monitor.
• client_move_list target — Move the currently selected client in the internal list of clients. This can affect the tiling layout, for example. target must be one of prev, next.
• client_move_mouse event — Move the window which is currently under the mouse pointer. event must be one of down, motion, up. Note that client_move_mouse down can also be used to raise a window. 🖱️
• client_resize_mouse event — Resize the window which is currently under the mouse pointer. event must be one of down, motion, up.
• client_select target — Focus another client on the current workspace. target must be one of prev, next, recent. recent selects the previously selected client on the current workspace.
• client_switch_monitor target — Move currently selected client to another monitor. target must be one of left, right.
• client_switch_workspace target — Move currently selected client to another workspace on the same monitor. target must be one of prev, next, or an integer i where 0 <= i <= 127 to denote one particular workspace. 🦋
• floaters_collect — Fit all floating clients of the current workspace to the current monitor. Some of them might have moved around. Lil cleanup era. ✨
• layout_set algorithm — Set the layout algorithm on the currently visible workspace on the currently selected monitor. algorithm must be one of tile, stack, monocle, float.
• monitor_select target — When multiple monitors are connected to your computer, you can use this command to select the active monitor. New windows will spawn on that monitor. target must be one of left, right, recent, which will navigate to the monitor left/right of the currently active monitor or to the previously selected monitor. 🖥️
• placement_store slot — The current window placement can be saved in one of eight slots. “Placement” means a client’s workspace, a client’s monitor, the currently active layouts, and the currently active workspace on each monitor. In other words, this operation does not save a client’s pixel coordinates. slot must be an integer i where: 0 <= i <= 10. (Yes, eight slots and a listed range of 0 <= i <= 10 — that’s literally what the page says, bestie. 😭)
• placement_use slot — Restores a previously saved layout. See placement_store. Note that this is a “best effort” operation. For example, if you store a layout that comprises three monitors, you can restore it later on even when there are only two monitors connected. Clients on the missing monitor will be moved to the very first monitor. 🫶
• urgency_clear_visible — Clears the urgency hint on all currently visible windows.
• urgency_mute_toggle — Toggles “mute mode”. When enabled, there won’t be any indicators showing window urgency. Urgency hints are still managed, though, so upon disabling mute mode, you will instantly see which windows have their urgency hint set. 🔔
• wm_restart — Causes katriawm(1) to restart.
• wm_quit — Causes katriawm(1) to quit.
• workspace_select target — Each monitor can display exactly one workspace at a time. You can use this command to select the active workspace on the currently active monitor. target must be one of prev, next, recent, or an integer i where 0 <= i <= 127 to denote one particular workspace. recent will jump to the previously selected workspace. 🌈

🌿 ENVIRONMENT 🌿

• DISPLAY — X11 display to connect to. 👀

📜 LICENSE 📜

katriac is released under the MIT license. See the accompanying LICENSE file. 💖

🕰️ HISTORY 🕰️

katriac was originally written by movq. The project was started in December 2015. 👑

🔗 SEE ALSO 🔗

• katriawm(1)
• nhkd(1)

---

Cute lil sign-off: this page is from Debian, dated 2025-08-03, and the manual tag is KATRIAC(1). Bye bestie, go control your WM! 💅🫶✨