Airblader /i3

A fork of the i3 window manager with gaps and some other features. :warning: i3-gaps has been merged into i3.

★ 5,782⑂ 311👁 2⑃ 42● 396▤ 15
CBSD-3-ClauseCreated 2014-11-21
Download: 4.21.14.21.1 ↓4.21.12022-10-28
+1
Daily
5,782
stars
311
forks
2
watchers
42
prs
396
issues
15
releases

README

i3-gaps

 Project status

:warning: :warning: :warning:

The i3-gaps project has been merged with i3. All i3-gaps features will become available with i3 4.22 (not released yet at the time of writing this).

Package maintainers are asked to replace any i3-gaps packages with the i3 package once i3 4.22 has been released. This repository will be archived and no longer be kept up to date.

 What is i3-gaps?

i3-gaps is a fork of i3wm, a tiling window manager for X11. It is kept up to date with upstream, adding a few additional features such as gaps between windows (see below for a complete list).

!i3

 How do I install i3-gaps?

Please refer to the wiki.

 Where can I get help?

For bug reports or feature requests regarding i3-gaps specifically, open an issue on GitHub. If your issue is with core i3 functionality, please report it upstream.

For support & all other kinds of questions, you can ask your question on GitHub Discussions.

 Features

 i3

 gaps

Note: In order to use gaps you need to disable window titlebars. This can be done by adding the following line to your config.


 You can also use any non-zero value if you'd like to have a border
default_border pixel 0


Gaps are the namesake feature of i3-gaps and add spacing between windows/containers. Gaps come in two flavors, inner and outer gaps wherein inner gaps are those between two adjacent containers (or a container and an edge) and outer gaps are an additional spacing along the screen edges. Gaps can be configured in your config either globally or per workspace, and can additionally be changed during runtime using commands (e.g., through i3-msg).

Note: Outer gaps are added to the inner gaps, i.e., the gaps between a screen edge and a container will be the sum of outer and inner gaps.

 Configuration

You can define gaps either globally or per workspace using the following syntax. Note that the gaps configurations should be ordered from least specific to most specific as some directives can overwrite others.


gaps [inner|outer|horizontal|vertical|top|left|bottom|right] 
workspace  gaps [inner|outer|horizontal|vertical|top|left|bottom|right] 


The inner and outer keywords are as explained above. With top, left, bottom and right you can specify outer gaps on specific sides, and horizontal and vertical are shortcuts for the respective sides.  stands for a numeric value in pixels and  for either a workspace number or a workspace name.

 Commands

Gaps can be modified at runtime with the following command syntax:


gaps inner|outer|horizontal|vertical|top|right|bottom|left current|all set|plus|minus|toggle 

 Examples
gaps inner all set 20
gaps outer current plus 5
gaps horizontal current plus 40
gaps outer current toggle 60


With current or all you can change gaps either for only the currently focused or all currently existing workspaces (note that this does not affect the global configuration itself).

You can find an example configuration in the wiki.

 Smart Gaps

Gaps can be automat

Top issues

Latest release

4.21.1 4.21.1 2022-10-28

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON