|
Name |
|
Date |
Size |
#Lines |
LOC |
| .. | | 03-May-2022 | - |
| .github/ | H | 03-Nov-2021 | - | 394 | 294 |
| AnyEvent-I3/ | H | 03-Nov-2021 | - | 1,036 | 539 |
| contrib/ | H | 03-May-2022 | - | 775 | 451 |
| debian/ | H | 03-Nov-2021 | - | 1,000 | 788 |
| docs/ | H | 03-May-2022 | - | 8,890 | 7,157 |
| etc/ | H | 03-Nov-2021 | - | 397 | 323 |
| i3-config-wizard/ | H | 03-Nov-2021 | - | 1,016 | 721 |
| i3-dump-log/ | H | 03-Nov-2021 | - | 271 | 207 |
| i3-input/ | H | 03-May-2022 | - | 2,649 | 2,366 |
| i3-msg/ | H | 03-Nov-2021 | - | 332 | 263 |
| i3-nagbar/ | H | 03-Nov-2021 | - | 674 | 474 |
| i3bar/ | H | 03-Nov-2021 | - | 5,626 | 3,642 |
| include/ | H | 03-Nov-2021 | - | 6,854 | 2,108 |
| libi3/ | H | 03-May-2022 | - | 2,675 | 1,539 |
| man/ | H | 03-May-2022 | - | 1,004 | 696 |
| meson/ | H | 03-Nov-2021 | - | 40 | 31 |
| parser-specs/ | H | 03-Nov-2021 | - | 1,244 | 930 |
| share/ | H | 03-Nov-2021 | - | 29 | 26 |
| src/ | H | 03-May-2022 | - | 27,178 | 17,972 |
| testcases/ | H | 03-Nov-2021 | - | 32,830 | 17,431 |
| travis/ | H | 03-Nov-2021 | - | 425 | 300 |
| .clang-format | H A D | 03-Nov-2021 | 651 | 14 | 13 |
| .dockerignore | H A D | 03-Nov-2021 | 5 | 2 | 1 |
| .editorconfig | H A D | 03-Nov-2021 | 158 | 12 | 9 |
| .gitignore | H A D | 03-Nov-2021 | 931 | 56 | 53 |
| DEPENDS | H A D | 03-Nov-2021 | 3.8 KiB | 45 | 38 |
| I3_VERSION | H A D | 03-Nov-2021 | 15 | 2 | 1 |
| LICENSE | H A D | 03-Nov-2021 | 1.5 KiB | 27 | 23 |
| PACKAGE-MAINTAINER | H A D | 03-Nov-2021 | 1.8 KiB | 45 | 34 |
| README.md | H A D | 03-Nov-2021 | 4.6 KiB | 115 | 73 |
| RELEASE-NOTES-4.20.1 | H A D | 03-Nov-2021 | 1.2 KiB | 28 | 19 |
| generate-command-parser.pl | H A D | 03-Nov-2021 | 8.2 KiB | 245 | 159 |
| i3-dmenu-desktop | H A D | 03-Nov-2021 | 20.1 KiB | 577 | 292 |
| i3-migrate-config-to-v4 | H A D | 03-Nov-2021 | 10.6 KiB | 364 | 261 |
| i3-save-tree | H A D | 03-Nov-2021 | 7.6 KiB | 304 | 176 |
| i3-sensible-editor | H A D | 03-Nov-2021 | 570 | 17 | 5 |
| i3-sensible-pager | H A D | 03-Nov-2021 | 658 | 19 | 5 |
| i3-sensible-terminal | H A D | 03-Nov-2021 | 1 KiB | 24 | 6 |
| meson.build | H A D | 03-Nov-2021 | 17.3 KiB | 736 | 669 |
| pseudo-doc.doxygen | H A D | 03-Nov-2021 | 4.9 KiB | 149 | 124 |
| release.sh | H A D | 03-Nov-2021 | 8.7 KiB | 237 | 171 |
README.md
1[![Build Status](https://github.com/Airblader/i3/actions/workflows/main.yml/badge.svg)](https://github.com/Airblader/i3/actions/workflows/main.yml)
2[![Issues](https://img.shields.io/github/issues/Airblader/i3.svg)](https://github.com/Airblader/i3/issues)
3[![Forks](https://img.shields.io/github/forks/Airblader/i3.svg)](https://github.com/Airblader/i3/network)
4[![Stars](https://img.shields.io/github/stars/Airblader/i3.svg)](https://github.com/Airblader/i3/stargazers)
5
6# i3-gaps
7
8## What is i3-gaps?
9
10i3-gaps is a fork of [i3wm](https://www.i3wm.org), 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).
11
12![i3](http://i.imgur.com/y8sZE6o.jpg)
13
14## How do I install i3-gaps?
15
16Please refer to the [wiki](https://github.com/Airblader/i3/wiki/installation).
17
18## Where can I get help?
19
20For bug reports or feature requests regarding i3-gaps specifically, open an issue on [GitHub](https://www.github.com/Airblader/i3). If your issue is with core i3 functionality, please report it [upstream](https://www.github.com/i3/i3).
21
22For support & all other kinds of questions, you can ask your question on [GitHub Discussions](https://github.com/i3/i3/discussions).
23
24# Features
25
26## i3
27
28### gaps
29
30*Note:* In order to use gaps you need to disable window titlebars. This can be done by adding the following line to your config.
31
32```
33# You can also use any non-zero value if you'd like to have a border
34for_window [class=".*"] border pixel 0
35```
36
37Gaps 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`).
38
39*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.
40
41#### Configuration
42
43You 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.
44
45```
46gaps [inner|outer|horizontal|vertical|top|left|bottom|right] <px>
47workspace <ws> gaps [inner|outer|horizontal|vertical|top|left|bottom|right] <px>
48```
49
50The `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. `<px>` stands for a numeric value in pixels and `<ws>` for either a workspace number or a workspace name.
51
52#### Commands
53
54Gaps can be modified at runtime with the following command syntax:
55
56```
57gaps inner|outer|horizontal|vertical|top|right|bottom|left current|all set|plus|minus|toggle <px>
58
59# Examples
60gaps inner all set 20
61gaps outer current plus 5
62gaps horizontal current plus 40
63gaps outer current toggle 60
64```
65
66With `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).
67
68You can find an example configuration in the [wiki](https://github.com/Airblader/i3/wiki/Example-Configuration).
69
70### Smart Gaps
71
72Gaps can be automatically turned on/off on a workspace in certain scenarios using the following config directives:
73
74```
75# Only enable gaps on a workspace when there is at least one container
76smart_gaps on
77
78# Only enable outer gaps when there is exactly one container
79smart_gaps inverse_outer
80```
81
82### Smart Borders
83
84Smart borders will draw borders on windows only if there is more than one window in a workspace. This feature can also be enabled only if the gap size between window and screen edge is `0`.
85
86```
87# Activate smart borders (always)
88smart_borders on
89
90# Activate smart borders (only when there are effectively no gaps)
91smart_borders no_gaps
92```
93
94### Smart Edge Borders
95
96This extends i3's `hide_edge_borders` with a new option. When set, edge-specific borders of a container will be hidden if it's the only container on the workspace and the gaps to the screen edge is `0`.
97
98```
99# Hide edge borders only if there is one window with no gaps
100hide_edge_borders smart_no_gaps
101```
102
103## i3bar
104
105### Bar Height
106
107The height of an i3bar instance can be specified explicitly by defining the `height` key in the bar configuration. If not set, the height will be calculated automatically depending on the font size.
108
109```
110bar {
111 # Height in pixels
112 height 25
113}
114```
115