2018-12-31 14:25:17 +00:00
|
|
|
kiwmi
|
|
|
|
|
=====
|
|
|
|
|
|
2019-02-14 16:38:41 +00:00
|
|
|
A client controlled Wayland compositor.
|
2018-12-31 14:25:17 +00:00
|
|
|
|
|
|
|
|
Configuration
|
|
|
|
|
-------------
|
|
|
|
|
|
|
|
|
|
Configuration languages are confusing. They are neither flexible nor easy to use. Moreover, it adds a lot of complexity to the program itself.
|
2019-02-14 16:38:41 +00:00
|
|
|
kiwmi listens to a socket and offers a basic client, kiwmic, to communicate with kiwmi. Much like how bspwm works.
|
2018-12-31 14:25:17 +00:00
|
|
|
|
|
|
|
|
This allows the user to write the configuration in any langauge, e.g. as a bash script, which allows for high flexibility.
|
|
|
|
|
|
2019-02-14 16:38:41 +00:00
|
|
|
On top of that, kiwmi barely handles anything on it's own.
|
|
|
|
|
Instead it emmits events, to which the client can subscribe and react accordingly.
|
|
|
|
|
This allows for 100% flexibility and customizability, while comming at a little effort at first.
|
|
|
|
|
As soon as they exist I'll link a few user configurations, that are likely to help you get started.
|
|
|
|
|
|
|
|
|
|
This means the user will end up using a big, monolithic frontend, or a collection of small scripts, to configure kiwmi.
|
|
|
|
|
If I get around to it I will probably create a small Python (probably) library, to make it easier to create a monolithic frontend.
|
2018-12-31 14:25:17 +00:00
|
|
|
|
|
|
|
|
Dependencies
|
|
|
|
|
------------
|
|
|
|
|
|
2019-02-14 16:38:41 +00:00
|
|
|
- https://github.com/swaywm/wlroots[wlroots]
|
|
|
|
|
- meson (build)
|
|
|
|
|
- ninja (build)
|
|
|
|
|
- git (build, optional, to fetch the version)
|
2018-12-31 14:25:17 +00:00
|
|
|
|
|
|
|
|
Building
|
|
|
|
|
--------
|
|
|
|
|
|
2019-02-14 16:38:41 +00:00
|
|
|
Make sure all dependencies are installed. Then run this.
|
|
|
|
|
|
|
|
|
|
----
|
|
|
|
|
$ meson build
|
|
|
|
|
$ ninja -C build
|
|
|
|
|
----
|
|
|
|
|
|
|
|
|
|
You can then install it like this.
|
|
|
|
|
|
2018-12-31 14:25:17 +00:00
|
|
|
----
|
2019-02-14 16:38:41 +00:00
|
|
|
# ninja -C build install
|
2018-12-31 14:25:17 +00:00
|
|
|
----
|
|
|
|
|
|
|
|
|
|
Contribution
|
|
|
|
|
------------
|
|
|
|
|
|
|
|
|
|
You want to contribute? Great!
|
|
|
|
|
|
|
|
|
|
Future requests, bug reports and PRs are always welcome.
|
|
|
|
|
Note that pull requests without a valid issue are ignored to decrease the amount of duplicate work.
|
2019-02-20 10:58:02 +00:00
|
|
|
Also read link:CONTRIBUTING.adoc[CONTRIBUTING.adoc].
|
2018-12-31 14:25:17 +00:00
|
|
|
|
|
|
|
|
If anything is unclear, feel free to contact me.
|
|
|
|
|
|
|
|
|
|
If you don't program but want to contribute to kiwmi, spread the word about kiwmi and star the repo.
|
