FOCUSWIN(1)

📦 version 0-unstable-2021-02, in nixos 26.05, nixpkgs unstable

💅 FOCUSWIN(1) — bestie's guide to the focus window command 🦋

okay so real talk, this is focuswin, straight out of the General Commands Manual, and it does exactly one thing but it does it so well: it moves your focus to another window. that's it. that's the whole vibe. ✨

🌸 NAME 🌸

focuswin — focus window. literally the name, no cap.

🎀 SYNOPSIS 🎀

focuswin (direction|number)

one argument, and it's either a direction or a number. pick your fighter. 💅

🔥 DESCRIPTION 🔥

focuswin focuses a window, and you tell it which window by passing an argument. iconic behaviour honestly.

that argument has to be one of the following, no improvising:

  • left — focus the closest window to the left in the current monitor. ⬅️
  • right — focus the closest window to the right in the current monitor. ➡️
  • up — focus the closest window upwards in the current monitor. ⬆️
  • down — focus the closest window downwards in the current monitor. ⬇️
  • next — focus the next window in the current monitor. 🚶‍♀️
  • previous — focus the previous window in the current monitor. 🚶‍♀️ (but backwards)
  • N — where N is a number, focus the N-th window in the current monitor. 🔢

and here's the little detail that makes it chef's kiss: focuswin gives preference to windows that are aligned with the focused window. that's lowkey the whole reason it slaps — it's super useful for focusing tiled windows. 🧚

also important, and I need you to hear me on this one: focuswin focuses only windows visible in the monitor where the currently focused window is in. so like, no sneaky hopping across monitors. stay in your lane bestie, it's a vibe. 🫶

💖 ENVIRONMENT 💖

these environment variables affect the execution of focuswin:

  • DISPLAY — the display where the window to be focused is. 🌈

⭐ EXIT STATUS ⭐

  • 0 — success. slay. we ate. 👑
  • >0 — an error occurred. 😭 not slay. try again.

🦋 SEE ALSO 🦋

focusmon(1), focusws(1)

ngl the manpage literally ends with a trailing comma after focusws(1), and I'm obsessed with the chaos of it. keeping it fr fr. 💀

okay that's the whole thing!! this little page came from the General Commands Manual and signs off as FOCUSWIN(1) — no date on this one, so consider this your cutest possible goodbye. mwah. 💜🎀✨

📦 where this page comes from