-
Notifications
You must be signed in to change notification settings - Fork 172
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #1127 from PolyMeilex/compositors-list-in-readme
Update README & Add compositors list
- Loading branch information
Showing
2 changed files
with
60 additions
and
31 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,42 @@ | ||
# Anvil | ||
|
||
A compositor used as a testing ground for new smithay features. | ||
For a simple example compositor consider reading [smallvil](https://github.com/Smithay/smithay/tree/master/smallvil) | ||
|
||
## Dependencies | ||
|
||
You'll need to install the following dependencies (note, that those package | ||
names may vary depending on your OS and linux distribution): | ||
|
||
- `libwayland` | ||
- `libxkbcommon` | ||
|
||
#### These are needed for the "Udev/DRM backend" | ||
|
||
- `libudev` | ||
- `libinput` | ||
- `libgbm` | ||
- [`libseat`](https://git.sr.ht/~kennylevinsen/seatd) | ||
|
||
If you want to enable X11 support (to run X11 applications within anvil), | ||
then you'll need to install the following packages as well: | ||
- `xwayland` | ||
|
||
## Build and run | ||
|
||
You can run it with cargo after having cloned this repository: | ||
|
||
``` | ||
cd anvil; | ||
cargo run -- --{backend} | ||
``` | ||
|
||
The currently available backends are: | ||
|
||
- `--x11`: start anvil as an X11 client. This allows you to run the compositor inside an X11 session or any compositor supporting XWayland. Should be preferred over the winit backend where possible. | ||
- `--winit`: start anvil as a [Winit](https://github.com/tomaka/winit) application. This allows you to run it | ||
inside of an other X11 or Wayland session. | ||
- `--tty-udev`: start anvil in a tty with udev support. This is the "traditional" launch of a Wayland | ||
compositor. Note that this requires you to start anvil as root if your system does not have logind | ||
available. |