Skip to main content

Dynamics layouts for i3wm

Project description

i3-layouts

pipy

i3-layouts is a small program that enforces dynamic layout on i3 workspace. Each layout implemented comes with its own set of parameters.

i3-layouts comes with 5 configurable layouts:

  • vstack: one main windows with a vertical stack of windows. vstack
  • hstack: one main windows with an horizontal stack of windows. hstack
  • spiral: each new windows split the previous one, split direction alternates between horizontal and vertical.
    spiral
  • 3columns: one main windows with two vertical stacks of windows. 3columns
  • companion: each columns is made of one main window and one smaller window. companion

The Layout section details the parameters for each one of these layouts.

Installation

Requirements

Before installing i3-layouts be sure to have the following installed on your system:

Installation with pip

To install, simply use pip

$ pip install --user i3-layouts

Run

To start i3-layouts, simply type i3-layouts in a terminal, or better yet, launch it from the i3 config file:

exec i3-layouts

Configuration

Configuration is done directly in the i3 config file (usually $HOME/.config/i3/config).

i3-layouts reads the entire config file, filter all $i3l variables and keeps the associated values as configuration. Note that user defined variables can be used in $i3l variables, as they will be replaced by their own value.

Assigning a layout to a workspace

Use the name of the layout as value for the $i3l variable, followed by its parameters and then the targeted workspace name.

Note that parameters are optional. However, if given, they must respect the order described in the Layouts section.

Syntax:

set $i3l [vstack|hstack|spiral|3columns] <param> ... to workspace [workspace name]

Examples:

set $ws1 1
...
set $i3l vstack to workspace $ws1
set $i3l hstack 0.6 up to workspace $ws2
set $i3l spiral 0.6 to workspace $ws3
set $i3l 3columns 0.66 0.5 2 left to workspace $ws4

Switching layout

It possible to dynamically switch the current workspace layout by sending a send_tick message with i3-msg. The message must start with i3-layouts followed by one of the layout name or none:

  • If a layout name is given, and windows are already present, they will be rearranged to match the selected layout.
  • If none is given, i3-layouts will stop managing this workspace layout.

Syntax:

i3-msg -t send_tick "i3-layouts [vstack|hstack|spiral|3columns|none] <param> ..."

Examples:

i3-msg -t send_tick "i3-layouts vstack 0.6"

You can also use a keyboard binding in your i3 config file, for example:

bindsym $mod+s exec i3-msg -t send_tick "i3-layouts vstack 0.6"

Layouts

Each layout accept some specific parameters. These parameters must be given is the order described below.

vstack

One main windows with a vertical stack of windows.

  • main stack ratio (float between 0 and 1, default 0.5): ratio of screen width used by the main stack
  • secondary stack position (right or left, default right): vertical stack position relative to the main stack

hstack

One main windows with an horizontal stack of windows.

  • main stack ratio (float between 0 and 1, default 0.5): ratio of screen height used by the main stack
  • secondary stack position (up or down, default down): horizontal stack position relative to the main stack

spiral

Each new windows split the previous one, split direction alternates between horizontal and vertical.

  • split ratio (float between 0 and 1, default 0.5): ratio of width or height used by the previous container at each split, the remaining is used by the new container.
  • screen direction (inside or outside, default inside): whether new container should be added towards the inside of the screen or the outside.

3columns

One main windows with two vertical stacks of windows.

  • main stack ratio [two columns] (float between 0 and 1, default 0.5): ratio of screen width used by the main stack when only two columns are present
  • main stack ratio [three columns] (float between 0 and 1, default 0.5): ratio of screen width used by the main stack when three columns are present. Width left is distributed equally between the second and third columns
  • max number of row in the second columns (int, default 0): the third columns is created only when the second column reach this number of container. If 0 is given new container position alternate between the second and third columns.
  • second columns position (right or left, default right): second column position relative to the main stack. Note that the third column will have the opposite position (if the second columns is on the left of the main stack, the third one will be on the right of the main stack)

companion

Each columns is made of one main window and one smaller window (called companion container below).

  • odd companion ratio (float between 0 and 1, default 0.3): ratio of screen height used by the companion container for odd column index
  • even companion ratio (float between 0 and 1, default 0.3): ratio of screen height used by the companion container for even column index
  • companion position (up, down, alt-up, alt-down, default up): position of the companion container relative to the main window. alt-up and alt-down alternate this position for each column, starting respectively at up and down for the first column.

Limitations

  • User actions (split and move): i3-layouts do its best to manage the workspace layout, but if you manually split or move a container (with split vertical|horizontal for example), new container may be misplaced.
  • Redraw: when container are closed, or moved between workspace, i3-layouts needs to reposition some if not all containers of a given workspace. Right now, i3-layouts use xdotool to simulate the recreation of these containers, which is not ideal.
  • Marks: to keep track of container position, i3-layouts use i3wm marks. More precisely, i3-layouts marks the first and last container of each workspace.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

i3-layouts-0.7.1.tar.gz (9.2 kB view hashes)

Uploaded Source

Built Distribution

i3_layouts-0.7.1-py3-none-any.whl (11.2 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page