34 lines
1.2 KiB
Markdown
34 lines
1.2 KiB
Markdown
|
# TinyWL
|
||
|
|
|
||
|
|
This is the "minimum viable product" Wayland compositor based on wlroots. It
|
||
|
|
aims to implement a Wayland compositor in the fewest lines of code possible,
|
||
|
|
while still supporting a reasonable set of features. Reading this code is the
|
||
|
|
best starting point for anyone looking to build their own Wayland compositor
|
||
|
|
based on wlroots.
|
||
|
|
|
||
|
|
## Building TinyWL
|
||
|
|
|
||
|
|
TinyWL is disconencted from the main wlroots build system, in order to make it
|
||
|
|
easier to understand the build requirements for your own Wayland compositors.
|
||
|
|
Simply install the dependencies:
|
||
|
|
|
||
|
|
- wlroots
|
||
|
|
- wayland-protocols
|
||
|
|
|
||
|
|
And run `make`.
|
||
|
|
|
||
|
|
## Running TinyWL
|
||
|
|
|
||
|
|
You can run TinyWL with `./tinywl`. In an existing Wayland or X11 session,
|
||
|
|
tinywl will open a Wayland or X11 window respectively to act as a virtual
|
||
|
|
display. You can then open Wayland windows by setting `WAYLAND_DISPLAY` to the
|
||
|
|
value shown in the logs. You can also run `./tinywl` from a TTY.
|
||
|
|
|
||
|
|
In either case, you will likely want to specify `-s [cmd]` to run a command at
|
||
|
|
startup, such as a terminal emulator. This will be necessary to start any new
|
||
|
|
programs from within the compositor, as TinyWL does not support any custom
|
||
|
|
keybindings. TinyWL supports the following keybindings:
|
||
|
|
|
||
|
|
- `Alt+Escape`: Terminate the compositor
|
||
|
|
- `Alt+F1`: Cycle between windows
|