kiwmi/README.adoc

51 lines
1.9 KiB
Text
Raw Normal View History

2018-10-02 23:29:47 +02:00
kiwmi
=====
2018-09-27 16:42:20 +02:00
A fully manual tiling window manager for the X window system.
Why?
----
There's not enough so called "manual" tiling window managers and none of the existing ones is *fully* manual.
When a new window opens, without having space assigned, I don't want my WM to suddenly be dynamic and just put it _somewhere_ or even on top something that's already existing.
Concepts
--------
I don't know what you expect to find here.
It's a window manager: there's tags (workspaces), windows and they get arranged.
So what happens when a window is created when there's no space yet?
It's put in a queue, from where it can be popped into available space (which is also getting a cool name soon).
This also solves the problem of creating a window and moving the focus before it spawns, since you can assign future queue positions to available space.
I plan on having available space behave like a window, so that you don't have to think about stuff, but we'll see about that.
Configuration
-------------
Configuration languages suck and they add a lot of complexity to a program.
2018-10-02 23:29:47 +02:00
`kiwmi` listens to a socket and offers a basic client (called `seed`) to communicate with the WM.
2018-09-27 16:42:20 +02:00
This allows you to write your configuration in any language you want, while also removing the task of listening to keybinds for me, since you can use tools like https://github.com/baskerville/sxhkd[sxhkd] to do that.
2018-09-28 18:06:34 +02:00
Building
--------
Configuration can be done mostly in link:config.mk[config.mk].
2018-10-16 21:25:52 +02:00
. Be sure to have the dependencies installed (libxcb).
2018-09-28 18:06:34 +02:00
. `make`
. `sudo make install`
2018-09-27 16:42:20 +02:00
Contribution
------------
2018-09-28 17:46:23 +02:00
You want to contribute? Great!
2018-10-01 13:14:48 +02:00
Future requests, bug reports and PRs are welcome. Be sure to read the link:CONTRIBUTING.adoc[CONTRIBUTING.adoc]. Note that pull requests without a valid issue they reference are ignored, to decrease the amount of duplicate work.
2018-09-28 17:46:23 +02:00
If anything is unclear, feel free to reach out to me.