Need help with bsp-layout?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

phenax
139 Stars 12 Forks MIT License 105 Commits 6 Opened issues

Description

Manage layouts in bspwm (tall and wide)

Services available

!
?

Need anything else?

Contributors list

# 115,940
React
Shell
generat...
algebra...
99 commits

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
fills that gap.

Buy Me A Coffee donate button

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
in the cloned directory

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
file. An example of that file can be found in
example.layoutrc
mkdir ~/.config/bsp-layout && curl https://raw.githubusercontent.com/phenax/bsp-layout/master/example.layoutrc > ~/.config/bsp-layout/layoutrc;

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.