wdisplays_github/README.md

49 lines
1.5 KiB
Markdown
Raw Normal View History

2019-08-01 17:33:45 +03:00
# wdisplays
2019-07-06 05:51:52 +03:00
2019-08-01 17:33:45 +03:00
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://spdx.org/licenses/MIT.html)
2019-07-06 05:51:52 +03:00
2019-08-01 17:33:45 +03:00
wdisplays is a graphical application for configuring displays in Wayland
compositors. It borrows some code from [kanshi]. It should work in any
2019-08-15 14:39:33 +03:00
compositor that implements the wlr-output-management-unstable-v1 protocol,
including [sway].
2019-07-06 05:51:52 +03:00
2019-08-01 17:33:45 +03:00
![Screenshot](wdisplays.png)
# Building
Build requirements are:
- GTK+3
- epoxy
- wayland-client
```sh
meson build
ninja -C build
sudo ninja -C build install
```
2019-07-06 05:51:52 +03:00
2019-08-15 14:39:33 +03:00
# FAQ (Fervently Anticpiated Quandaries)
### What is this?
It's intended to be the Wayland equivalent of an xrandr GUI, like [ARandR].
### Help, I get errors and/or crashes!
Make sure your wlroots and sway are up-to-date. Particularly, you need a git
revision of wlroots from [this commit](https://github.com/swaywm/wlroots/commit/724b5e1b8d742a8429f4431ae1a55d7d26cb92ae)
(or later) or your compositor may crash when adding/removing displays.
Alternatively, you can try to disable the "Show Screen Contents" option.
### I'm using Sway, why aren't my display settings saved when I log out?
Sway, like i3, doesn't save any settings unless you put them in the config
file. See man `sway-output`. If you want to have multiple configurations
depending on the monitors connected, you'll need to use an external program
like [kanshi].
2019-07-06 05:51:52 +03:00
[kanshi]: https://github.com/emersion/kanshi
2019-08-01 17:33:45 +03:00
[sway]: https://github.com/swaywm/sway
2019-08-15 14:39:33 +03:00
[ARandR]: https://christian.amsuess.com/tools/arandr/