SWAYKBDD(1)

📦
version 1.4 · 2 versions
, in alpine 3.24, nixos 26.05, nixpkgs unstable

💅 SWAYKBDD(1) — the Swaykbdd manual, but make it cute 🎀

okay so bestie, welcome to swaykbdd — literally the glow-up your Sway keyboard situation has been waiting for ✨ (yes this is the Swaykbdd manual, and yes you're gonna slay it)

✨ NAME ✨

swaykbdd — keyboard layout switcher for Sway 🦋

✨ SYNOPSIS ✨

swaykbdd [OPTIONS...]

✨ DESCRIPTION ✨

so the swaykbdd utility is the icon that automatically changes your keyboard layout on a per-window or per-tab basis 💅 like, each window gets its own vibe, no cap.

and if you want it to just start on its own every time (main character energy fr), add this command to your Sway config file:

exec swaykbdd

that's it, that's the whole ritual 🫶

🌸 OPTIONS 🌸

  • -h, --help — shows you the help message 💖 your little built-in bestie.
  • -v, --version — spills the version information 🎀.
  • -d, --default=ID — sets the default keyboard layout for new windows. ID is literally the index of the layout, the default is 0, and there's a special value -1 you can pass to disable setting the layout for new windows entirely (in that case the currently active layout gets used instead) 🙈.
  • -t, --timeout=MS — the ignored time between a layout change and focus-lost events, measured in milliseconds ⏱️. the default value is 50.
  • -a, --tabapps=IDS — a comma-separated list of tab-enabled application IDs, where each tab gets its own keyboard layout 🗂️✨. the default value is "firefox,chrome". pass an empty string ("") to disable this feature completely, zero notes.
  • -V, --verbose — enables verbose output, aka the event trace 🔍 (iykyk, it's giving debug detective).

🌈 ENVIRONMENT 🌈

  • SWAYSOCK — path to the socket file used for Sway IPC 🔌. that's the lil connection, don't lose it.

💀 BUGS 💀

for suggestions, comments, bug reports etc., visit the project homepage 🫶 no gatekeeping, they wanna hear from you.

ngl bestie, read the -d -1 thing twice before you use it — "currently active layout will be used instead" is doing a Lot of work in that sentence 💅

and that's the whole page, periodt 💜 — this was swaykbdd, from the Swaykbdd manual, dated 2022-03-17, closing out as SWAYKBDD(1) 🌟 mwah, go switch some layouts 🎀

📦 where this page comes from