bsp-layout

Manage layouts in bspwm (tall and wide)

BSPWM does one thing and it does it well. It is a window manager. But some workflows require layout management to some extent.

bsp-layout

Dependencies

• bash

• bspc

• bc

• man

Installation

AUR

Arch users can install it from AUR bsp-layout or bsp-layout-git ```bash

If you are using yay

yay -S bsp-layout

Or for git master

yay -S bsp-layout-git ```

Install script

Others can install it directly using the install script.

Note: Please read scripts like these before executing it on your machine

bash
curl https://raw.githubusercontent.com/phenax/bsp-layout/master/install.sh | bash -;

Clone and make

You can also clone the repo on your machine and run

sudo make install

Supported layouts

• tall

  - Master-stack with a tall window. ```

  ---

  | |_| | || | || |__|_| ```

• rtall

  - Master-stack with a reversed tall window. ```

  ---

  |_| | || | || | ||_______| ```

• wide

  - Master-stack with a wide window. ```

  ---

  | | | | |__________| |||| ```

• rwide

  - Master-stack with a reversed wide window. ```

  ---

  |_||| | | | | |___________| ```

• grid

  - Horizontal grid layout ```

  ---

  | | | | |||| | | | | |||| ```

• rgrid

  - Vertical grid layout ```

  ---

  |__|| ||| ||__| ```

• even

  - Evenly balances all window areas ```

  ---

  |||| ||_|| |||__|

OR

| | | | |_____| | | | ||_______| ```

• tiled

  - Default bspwm's tiled layout ```

  ---

  | | | | |_| | | | | |____||| ```

• monocle

  - Default bspwm's monocle layout ```

  ---

  | | | | | | |_____________| ```

Usage

• Help menu

  bash
  bsp-layout help
  

• Set a layout in desktop named 6 Not specifying the layout will apply the layout on the focused desktop

  bash
  bsp-layout set tall 6
  

• Set tall layout to desktop with a 40% split Set the master size for layout ```bash // Currently focused workspace bsp-layout set tall -- --master-size 0.4

// Workspace 6 bsp-layout set tall 6 -- --master-size 0.4 ```

• Remove layout applied to desktop named 6 This will remove any layout applied

  bash
  bsp-layout remove 6
  

• Apply a layout on your focused workspace once This will apply the layout on the current set of nodes on that workspace but newer nodes won't conform to the layout.

  bash
  bsp-layout once tall
  

• Cycle through layouts Cycle through all (or a custom list of) layouts. ```bash

  Cycle through all layouts

  bsp-layout cycle

Or to cycle through a custom list of layouts

bsp-layout cycle --layouts tall,monocle,wide

For a specific desktop

bsp-layout cycle --layouts tall,monocle,wide --desktop 4 ```

• Toggle layout

  bash
  # Toggle between monocle and tall layouts
  bsp-layout cycle tall,monocle
  

Configuration

You can configure the size of the master window in percentage in

$XDG_CONFIG_DIR/bsp-layout/layoutrc

example.layoutrc

mkdir ~/.config/bsp-layout && curl https://raw.githubusercontent.com/phenax/bsp-layout/master/example.layoutrc > ~/.config/bsp-layout/layoutrc;