A fully programmable Wayland Compositor
Find a file
2018-11-08 22:59:10 +01:00
misc Removed trailing period after config 2018-10-31 17:48:05 +01:00
src Added a small comment hashtagdocumentation 2018-11-08 22:59:10 +01:00
.gitignore Added basic Makefile 2018-10-30 23:47:29 +01:00
config.mk Updoozled config.mk 2018-10-25 22:53:52 +02:00
CONTRIBUTING.adoc Added contributing guidelines 2018-09-28 17:46:23 +02:00
LICENSE Initial commit 2018-09-27 16:42:20 +02:00
Makefile Added manpage to clean target 2018-11-06 15:04:16 +01:00
README.adoc Clean up readme 2018-11-04 00:08:29 +05:30

kiwmi

A fully manual tiling window manager for the X window system.

Concepts

Most manual window managers arent truly manual. They behave like a dynamic one sometimes. However, kiwmi is fully manual. It doesnt become dynamic all of a sudden.

When a window is spawned without allocating space, its put in an invisible queue. Then you allocate space for the window; when the window is pulled from the queue, it goes into the aforementioned space. This solves the classic problem with regular window managers, where the window with a longer start time will spawn in the current tag (workspace) instead of the one in which it was opened in.

In kiwmi, empty spaces available for windows behave like a normal window does. You can resize and move around them. Ergo, you dont need to re-learn how a tiling window manager behaves and works.

Configuration

Configuration languages are confusing. They are neither flexible nor easy to use. Moreover, it adds a lot of complexity to the program itself. kiwmi listens to a socket and offers a basic client, seed, to communicate with kiwmi. Much like how bspwm works.

This allows the user to write the configuration in any language, while also removing the need to have a custom hotkey manager since you can use external tools like sxhkd instead.

Dependencies

  • libxcb

  • pkgconfig (make)

Building

For the most part, configuration is done in config.mk.

  1. Make sure to have the dependencies installed.

  2. make

  3. sudo make install

Contribution

You want to contribute? Great!

Future requests, bug reports and PRs are always welcome. Make sure you read the CONTRIBUTING.adoc. Note that pull requests without a valid issue are ignored to decrease the amount of duplicate work.

If anything is unclear, feel free to contact me.

If you dont program but want to contribute to kiwmi, spread the world about kiwmi and star the repo.