FOCUSWS(1)

💅 FOCUSWS(1) — the "go to that other workspace" bestie

okay so real talk, this is focusws from the General Commands Manual, and honestly? it's giving tiny-but-mighty. ✨

🌸 NAME 🌸

focusws — focus workspace. that's it, that's the whole gig. she focuses a workspace for your window manager and she does it flawlessly. 💖

🎀 SYNOPSIS 🎀

focusws [-cp] [direction]

like, you can give her flags, you can give her a direction, you can give her both, you can give her neither. she's flexible like that. 🫶

✨ DESCRIPTION ✨

focusws focuses a window manager workspace. no cap, that's the whole thing. the argument direction has to be one of these, okay?

• next — focus the next workspace. onward and upward, queen. 👑
• previous — focus the previous workspace. we're going back, bestie, and it's iconic.
• N — if N is a number, focus the N-th workspace. yes, directly. no detours. she ate. 🔥

and now the options, aka the fun part:

• -c — cycle through the current cluster of workspaces. and before you ask what a cluster is: the current cluster of workspaces is a sequence of continuous populated workspaces next to the current workspace. so like — a cluster is a sequence of workspaces, one next to the other, that follows or precedes the currently focused workspace. and the blank workspace following the cluster also belongs to the cluster. yes, the empty one comes too, she's part of the group chat. 🫶
• -p — cycle through populated workspaces. meaning: ignore workspaces without a window in it. if nobody's home, we are not knocking. 💀

⚠️ okay so this is the important bit: both -c and -p are incompatible and cannot be used together. pick one, bestie, you cannot have both, it's not that kind of party. 😭

and also: both options are ignored if a workspace number is supplied as argument. if you say a number, she listens to the number. periodt.

🦋 ENVIRONMENT 🦋

these environment variables affect the execution of focusws:

• DISPLAY — the display where the workspaces are. that's the one. the whole vibe check happens on this display. 🌈

💜 EXIT STATUS 💜

• 0 — success. she slayed, everything worked. 🎉
• >0 — error occurred. something went sideways, ngl, check your args. 💀

🌟 SEE ALSO 🌟

focuswin(1), focusmon(1), — her two besties, they also do focusing things, go say hi. 🧚

and that's the whole page, bestie!! 💅✨ this little cutie comes to you from the General Commands Manual (that's FOCUSWS(1), source/version and date and all — shoutout to the section 1 girlies), and honestly? she's perfect, no notes. 🎀🦋💖