kitchen/kiwmi
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
kiwmi/README.md

70 lines
2.4 KiB
Markdown
Raw Normal View History

Replaced README and CONTRIBUTING files The previous README and CONTRIBUTING were both text, the readme being non-intriguing with nothing to really hook a user looking at the project. This doesn't need to be accepted, however I'd recommend using it as a reference or similar for a future rework of the readme. HTML can also be used if you don't want to use Markdown.
2019-12-22 02:36:48 +00:00
<h1 align="center">kiwmi</h1>
Overhaul readme
2019-12-22 16:50:08 +00:00
<p align="center"><i>A fully programmable Wayland Compositor</i></p>
Replaced README and CONTRIBUTING files The previous README and CONTRIBUTING were both text, the readme being non-intriguing with nothing to really hook a user looking at the project. This doesn't need to be accepted, however I'd recommend using it as a reference or similar for a future rework of the readme. HTML can also be used if you don't want to use Markdown.
2019-12-22 02:36:48 +00:00
<hr><p align="center">
<img alt="Stars" src="https://img.shields.io/github/stars/buffet/kiwmi.svg?label=Stars&style=flat" />
Add build passing shield Looks good
2021-08-18 18:43:25 +00:00
<a href="https://cirrus-ci.com/github/buffet/kiwmi"><img alt="Build Status" src="https://api.cirrus-ci.com/github/buffet/kiwmi.svg"></a>
<a href="https://github.com/buffet/kiwmi/issues"><img alt="GitHub Issues" src="https://img.shields.io/github/issues/buffet/kiwmi.svg"/></a>
<a href="https://github.com/buffet/kiwmi/graphs/contributors"><img alt="GitHub Contributors" src="https://img.shields.io/github/contributors/buffet/kiwmi"></a>
Replaced README and CONTRIBUTING files The previous README and CONTRIBUTING were both text, the readme being non-intriguing with nothing to really hook a user looking at the project. This doesn't need to be accepted, however I'd recommend using it as a reference or similar for a future rework of the readme. HTML can also be used if you don't want to use Markdown.
2019-12-22 02:36:48 +00:00
</p>
Overhaul readme
2019-12-22 16:50:08 +00:00
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.
Replaced README and CONTRIBUTING files The previous README and CONTRIBUTING were both text, the readme being non-intriguing with nothing to really hook a user looking at the project. This doesn't need to be accepted, however I'd recommend using it as a reference or similar for a future rework of the readme. HTML can also be used if you don't want to use Markdown.
2019-12-22 02:36:48 +00:00
Add note about the IRC channel
2021-09-13 11:23:50 +00:00
Got any questions or want to discuss something? Join us in [#kiwmi on irc.libera.chat](https://web.libera.chat/gamja/?channels=#kiwmi)!
Replaced README and CONTRIBUTING files The previous README and CONTRIBUTING were both text, the readme being non-intriguing with nothing to really hook a user looking at the project. This doesn't need to be accepted, however I'd recommend using it as a reference or similar for a future rework of the readme. HTML can also be used if you don't want to use Markdown.
2019-12-22 02:36:48 +00:00
Add link to docs to the readme
2021-08-09 18:58:16 +00:00
## Documentation
Documentation for the API can be found in [lua_docs.md](lua_docs.md).
Add note about kiwmic
2021-08-12 16:47:06 +00:00
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
```
Replaced README and CONTRIBUTING files The previous README and CONTRIBUTING were both text, the readme being non-intriguing with nothing to really hook a user looking at the project. This doesn't need to be accepted, however I'd recommend using it as a reference or similar for a future rework of the readme. HTML can also be used if you don't want to use Markdown.
2019-12-22 02:36:48 +00:00
## Getting Started
The dependencies required are:
Fix link to wlroots repository It has been quite some time since wlroots migrated to the FDO gitlab instance.
2022-01-13 20:35:40 +00:00
- [wlroots](https://gitlab.freedesktop.org/wlroots/wlroots)
Add lua dependency
2021-08-11 17:39:42 +00:00
- lua or luajit
Add hacky lazy damage tracking implementation
2021-08-14 19:44:20 +00:00
- pixman
Add lua dependency
2021-08-11 17:39:42 +00:00
- meson (build)
- ninja (build)
Overhaul readme
2019-12-22 16:50:08 +00:00
- git (build, optional)
Replaced README and CONTRIBUTING files The previous README and CONTRIBUTING were both text, the readme being non-intriguing with nothing to really hook a user looking at the project. This doesn't need to be accepted, however I'd recommend using it as a reference or similar for a future rework of the readme. HTML can also be used if you don't want to use Markdown.
2019-12-22 02:36:48 +00:00
### Building
After cloning/downloading the project and ensuring all dependencies are installed, building is as easy as running
```
$ meson build
$ ninja -C build
```
Allow user to change their lua version
2020-05-11 15:11:23 +00:00
If you plan to use luajit instead, use the following commands instead.
```
$ meson -Dlua-pkg=luajit build
$ ninja -C build
```
Replaced README and CONTRIBUTING files The previous README and CONTRIBUTING were both text, the readme being non-intriguing with nothing to really hook a user looking at the project. This doesn't need to be accepted, however I'd recommend using it as a reference or similar for a future rework of the readme. HTML can also be used if you don't want to use Markdown.
2019-12-22 02:36:48 +00:00
Installing is accomplished with the following command:
```
Overhaul readme
2019-12-22 16:50:08 +00:00
# ninja -C build install
Replaced README and CONTRIBUTING files The previous README and CONTRIBUTING were both text, the readme being non-intriguing with nothing to really hook a user looking at the project. This doesn't need to be accepted, however I'd recommend using it as a reference or similar for a future rework of the readme. HTML can also be used if you don't want to use Markdown.
2019-12-22 02:36:48 +00:00
```
## Contributing
Overhaul readme
2019-12-22 16:50:08 +00:00
Contributions are welcomed, especially while the project is in a heavy WIP stage.
If you believe you have a valid concern, read the [CONTRIBUTING](https://github.com/buffet/kiwmi/blob/master/CONTRIBUTING.md) document and please file an issue on the [issues page](https://github.com/buffet/kiwmi/issues/new).
Replaced README and CONTRIBUTING files The previous README and CONTRIBUTING were both text, the readme being non-intriguing with nothing to really hook a user looking at the project. This doesn't need to be accepted, however I'd recommend using it as a reference or similar for a future rework of the readme. HTML can also be used if you don't want to use Markdown.
2019-12-22 02:36:48 +00:00
Overhaul readme
2019-12-22 16:50:08 +00:00
For clarifications or suggestions on anything, please don't hesitate to contact me.
Reference in a new issue Copy permalink