updated readme
This commit is contained in:
parent
d0fcc4374e
commit
44bc1161e4
2 changed files with 29 additions and 0 deletions
22
README.md
22
README.md
|
@ -1,6 +1,28 @@
|
|||
# i3-layout-manager
|
||||
Saving, loading and managing layouts for i3wm.
|
||||
|
||||
## Preamble - dont worry, I solved all of this
|
||||
|
||||
i3 window manager supports saving and loading of window layouts, however, the features are bare-bone and partially missing.
|
||||
According to the [manual](https://i3wm.org/docs/layout-saving.html), the layout tree can be exported into a json file.
|
||||
The file contains a description of the containers of a workspace with prefilled (and commented) potential matching rules for the windows.
|
||||
User is supposed to uncomment the desierd one (and/or modify it) and delete the unsused ones.
|
||||
Moreover, user should add a surrouding root container which is missing in the file (this baffles me, why cant they save it too?).
|
||||
|
||||
So doing it manually (which I dont want) consists of following steps:
|
||||
1. export the workspace into jason using ```i3-save-tree --workspace ...```
|
||||
2. edit the json to match your desired matching rules for the windows
|
||||
3. wrap the file in a root node, which defines the root split.
|
||||
4. when needed, load the layout using ```i3-append ...```
|
||||
|
||||
However, this plan has big flaws. Its not scalable, its not automated and it loading of layout does not work when windows are already present in the current workspace.
|
||||
To fix it, I built this *layout manager*.
|
||||
Currently, its a hacky-type shell script, but feel free to contribute :-).
|
||||
|
||||
## How does it work?
|
||||
|
||||
TODO
|
||||
|
||||
## Dependencies
|
||||
|
||||
* vim/nvim
|
||||
|
|
|
@ -1,5 +1,6 @@
|
|||
#!/bin/bash
|
||||
# Author: klaxalk (klaxalk@gmail.com, github.com/klaxalk)
|
||||
#
|
||||
# Dependencies:
|
||||
# - vim/nvim : scriptable file editing
|
||||
# - jq : json manipulation
|
||||
|
@ -8,6 +9,10 @@
|
|||
# - xrandr : getting info of current monitor
|
||||
# - i3-msg : i3 tui
|
||||
# - awk+sed+cat ...
|
||||
#
|
||||
# vim foldmarks: set foldmarker=#\ #{,#\ #}
|
||||
|
||||
# #{ CHECK DEPENDENCIES
|
||||
|
||||
VIM_BIN="$(whereis -b vim | awk '{print $2}')"
|
||||
NVIM_BIN="$(whereis -b nvim | awk '{print $2}')"
|
||||
|
@ -41,6 +46,8 @@ if [ -z "$ROFI_BIN" ]; then
|
|||
exit 1
|
||||
fi
|
||||
|
||||
# #}
|
||||
|
||||
LAYOUT_PATH=~/.layouts
|
||||
|
||||
# make directory for storing layouts
|
||||
|
|
Loading…
Add table
Reference in a new issue