BSP-LAYOUT(1)

📦 version 2022-06, in nixos 26.05, nixpkgs unstable

bsp-layout(1) — General Commands Manual 💖 okay bestie, welcome in! This is the page for the dynamic layout manager for bspwm, and I’m gonna walk you through it like we’re gossiping in the group chat.

✨ NAME ✨

bsp-layout — A dynamic layout manager for bspwm

🌸 SYNOPSIS 🌸

bsp-layout
[set|once|get|previous|next|remove|layouts|reload|version|help]

💅 DESCRIPTION 💅

okay so bsp-layout is a dynamic layout manager for bspwm, written in bash. It provides layout options to fit most workflows. periodt. 🫶

🎀 OPTIONS 🎀

here’s the command menu, bestie — every option is literally right here:

  • set <layout> [desktop_name] -- [layout options] — Apply the layout to the selected desktop. This will re-calculate layout when a node is added or removed. If desktop_name is not passed, it will apply layout to the currently focused desktop.
  • once <layout> [desktop_name] -- [layout options] — Apply the layout to the selected desktop only once. This re-arranges the nodes in the desktop once and changes will not re-calculate layout. If desktop_name is not passed, it will apply layout to the currently focused desktop.
  • previous <layout> [--layouts tall,wide] [--desktop <desktop_name>] — Switch to the previous in a list of layouts. If layouts is not passed, the program will go through all available layouts. If desktop is not passed, it will apply layout to the currently focused desktop.
  • next <layout> [--layouts tall,wide] [--desktop <desktop_name>] — Switch to the next in a list of layouts. If layouts is not passed, the program will go through all available layouts. If desktop is not passed, it will apply layout to the currently focused desktop.
  • get <desktop_name> — Get the name of the layout running on a given desktop.
  • remove <desktop_selector> — Disable the layout on a given desktop.
  • layouts — List all available layout options.
  • reload — Reload layouts for all desktops.
  • version — Find what version of bsp-layout you have installed.
  • help — Opens this manpage.

🦋 LAYOUTS 🦋

each layout has its own little ASCII vibe check, so you can literally see what’s going on 👑

💖 tall 💖

A master-stack layout with nodes stacked vertically to the right of master.

_______________
|        |____|
|        |____|
|        |____|
|________|____|
  • --master-size <percentage> — The percentage width taken up by the master window in the layout.

💖 wide 💖

A master-stack layout with nodes stacked horizontally below master.

_______________
|             |
|             |
|_____________|
|____|____|___|
  • --master-size <percentage> — The percentage height taken up by the master window in the layout.

💖 rtall 💖

(Reverse tall) A master-stack layout with nodes stacked vertically to the left of master.

_______________
|____|        |
|____|        |
|____|        |
|____|________|
  • --master-size <percentage> — The percentage width taken up by the master window in the layout.

💖 rwide 💖

(Reverse wide) A master-stack layout with nodes stacked horizontally above master.

_______________
|____|____|___|
|             |
|             |
|_____________|
  • --master-size <percentage> — The percentage height taken up by the master window in the layout.

💖 grid 💖

A 2 row grid pattern (horizontal).

_____________
|   |   |   |
|___|___|___|
|   |   |   |
|___|___|___|

💖 rgrid 💖

(Reverse grid) A 2 column grid pattern (vertical).

_____________
|_____|_____|
|_____|_____|
|_____|_____|

💖 even 💖

Distributes all node areas in a desktop evenly.

_______________
|___|____|____|
|___|____|____|
|___|____|____|

OR

_______________
|    |        |
|    |________|
|    |        |
|____|________|

💖 tiled 💖

The default tiled layout provided by bspwm.

_______________
|        |    |
|        |____|
|        |  | |
|________|__|_|

💖 monocle 💖

The default monocle layout provided by bspwm.

_______________
|             |
|             |
|             |
|_____________|

💀 BUGS 💀

Report issues to https://github.com/phenax/bsp-layout/issues — no cap, that’s the spot for the tea.

👑 AUTHOR 👑

Akshay Nair <phenax5@gmail.com>

Homepage: https://github.com/phenax/bsp-layout

okay that’s the whole page, bestie — signing off with source/version bsp-layout-0.0.10-1 and manual BSP-LAYOUT(1); the footer didn’t list a date, so that’s the whole footer situation 💅✨🫶

📦 where this page comes from