aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: 26c21d6b4b18ab4800c6404f198f748db11d4ebe (plain)
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
# hi :D

this is a very simple xorg window manager written in go

to build

```sh
go build
```

there is a script that will start a xephyr server, build and run the wm too:
exit it with master+shift+q

```sh
./start.sh
```

## config

config location is `XDG_CONFIG_HOME/wm/config.toml`. On startup, if the wm doesn't find
a file at that location, it will copy `default_config.toml` there. it's read on startup,
so to apply changes you can use the restart keybind (`mod+shift+r` by default), any keys
left out will use the defaults, invalid values are logged and skipped.

binds are in `[binds]` as
`"<mods>+<key>" = "<action>"`, where `mod` is your configured mod key and an empty action unbinds.
actions: `spawn <shell command>`, `quit`, `restart`, `kill`, `zoom`, `layout <name>`,
`masters <+n|-n>`, `ratio <+0.05|-0.05>`, `view <n|all>`, `toggle <n|all>`, `tag <n|all>`.