0605ff3e4d
Previous name: "Make diplay info info" I believe that to be a far more concise and succinct message. Buffet voiced their concerns about informational content, which I must vehemently disagree with. The inclusion of "logging" as a concept in the commit message I see as an entirely superfluous and honestly insulting statement to the programmer's intelligence. To assume that someone would fail to infer that "making something info" is to log it as info is blatantly derogatory. Nonetheless I believe this commit to be important enough to future developer experience to contribute this despite the terrible overreach by the original developer of kiwmi. To hope that this incident is not to be forgotten. Acked-by: buffet <niclas@countingsort.com> |
||
|---|---|---|
| include | ||
| kiwmi | ||
| kiwmic | ||
| protocols | ||
| .cirrus.yml | ||
| .clang-format | ||
| .editorconfig | ||
| .gitignore | ||
| CONTRIBUTING.md | ||
| kiwmi.desktop | ||
| LICENSE | ||
| lua_docs.md | ||
| meson.build | ||
| meson_options.txt | ||
| README.md | ||
kiwmi
A fully programmable Wayland Compositor
kiwmi is a work-in-progress extensive user-configurable Wayland Compositor. kiwmi specifically does not enforce any logic, allowing for the creation of Lua-scripted behaviors, making arduous tasks such as modal window management become a breeze. New users should be aware of the steep learning curve present, however this will be reduced as the project matures.
Got any questions or want to discuss something? Join us in #kiwmi on irc.libera.chat!
Documentation
Documentation for the API can be found in lua_docs.md.
Additionally kiwmic can be used to send a single lua string to kiwmi for direct evaluation.
For example:
$ kiwmic 'return kiwmi:focused_view():id()'
94036737803088.0
Getting Started
The dependencies required are:
- wlroots
- lua or luajit
- pixman
- meson (build)
- ninja (build)
- git (build, optional)
Building
After cloning/downloading the project and ensuring all dependencies are installed, building is as easy as running
$ meson build
$ ninja -C build
If you plan to use luajit instead, use the following commands instead.
$ meson -Dlua-pkg=luajit build
$ ninja -C build
Installing is accomplished with the following command:
# ninja -C build install
Contributing
Contributions are welcomed, especially while the project is in a heavy WIP stage. If you believe you have a valid concern, read the CONTRIBUTING document and please file an issue on the issues page.
For clarifications or suggestions on anything, please don't hesitate to contact me.