1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
|
# autotiling
This script uses the [i3ipc-python library](https://github.com/altdesktop/i3ipc-python)
to switch the layout splith/splitv depending on the currently focused window
dimensions. It works on both sway and i3 window managers.
Inspired by https://github.com/olemartinorg/i3-alternating-layout.
## See on YouTube:
[](https://www.youtube.com/watch?v=UWRZuhn92bQ)
## PLEASE DO READ THIS
This script does one thing: when a window is being focused, it checks it's height / width ratio, and executes
the equivalent of either `swaymsg splitv` or `swaymsg splith`. Nothing less, nothing more. Yes, it may make
stacking and tabbed layouts behave oddly. No, nothing can be done about it. If you like stacking/tabbed layouts,
you may use them on workspaces with autotiling turned off (`--workspaces` argument). Do not submit issues about it.
For instance, on my triple-headed setup (2 workspaces per output), I configured autotiling to work on odd
workspaces, but not on even:
```text
### Autostart
exec autotiling -w 1 3 5
```
## Installation
1. Install autotiling. Possible methods:
* _PyPi._
[](https://pypi.org/project/autotiling)
autotiling is available from PyPi, so you can install it with
```
pip install autotiling
```
* _Arch Linux_
[](https://repology.org/project/autotiling/versions)
For the latest development version use
[autotiling-git](https://aur.archlinux.org/packages/autotiling-git).
* _Manually_
1. Install the `python-i3ipc>=2.0.1` package (or whatever it's called in your Linux
distribution).
2. Save the `main.py` file anywhere, make executable and autostart in your
i3/sway config file: `exec /path/to/the/script/main.py` on sway or
`exec_always --no-startup-id /path/to/the/script/main.py` on i3. You can give the `main.py` file another name.
_NOTE:_ The current release and master branch is compatible with sway >= 1.5. For
lower versions you need to use the script from the [sway14
branch](https://github.com/nwg-piotr/autotiling/tree/sway14) or the [0.9
release](https://github.com/nwg-piotr/autotiling/releases/tag/v0.9).
2. Add `exec autotiling` to the `~/.config/sway/config` or `exec_always --no-startup-id
autotiling` to the `~/.config/i3/config` file.
## Usage
```text
$ autotiling -h
usage: autotiling [-h] [-d] [-v] [-w [WORKSPACES ...]]
optional arguments:
-h, --help show this help message and exit
-d, --debug Print debug messages to stderr
-v, --version display version information
-w [WORKSPACES ...], --workspaces [WORKSPACES ...]
Restricts autotiling to certain workspaces. Example: autotiling --workspaces 8 9
```
|
