arti/wdisplays
1
0
Fork 0
mirror of https://github.com/artizirk/wdisplays.git synced 2024-12-22 04:20:16 +02:00
Code Issues Projects Releases Wiki Activity
58 Commits 1 Branch 3 Tags 410 KiB
C 96.4%
Meson 3.3%
CSS 0.3%
0683283fa5
Go to file
redtide 0683283fa5
Updated desktop file 
- Removed Version key: it's the version of the Desktop Entry Specification, not the application version and it's not required (see Table 2. Standard Keys in the specification)
- Set a real Name to display in menu for the application, with GenericName and Comment (same page as above)
- Italian translation strings
2023-07-01 12:45:24 +02:00
.reuse Create WdHeadForm class 2020-05-09 13:37:18 -04:00
LICENSES Relicense to GPL3+, add REUSE compliance 2020-05-08 20:10:27 -04:00
protocol Relicense to GPL3+, add REUSE compliance 2020-05-08 20:10:27 -04:00
resources Updated desktop file 2023-07-01 12:45:24 +02:00
src Move the output name overlay to the bottom left 2022-02-25 17:37:46 +01:00
.clang-format Added .editorconfig and .clang-format 2023-07-01 12:35:38 +02:00
.editorconfig Added .editorconfig and .clang-format 2023-07-01 12:35:38 +02:00
.gitignore Ignore QtCreator files 2023-07-01 12:34:46 +02:00
COPYING Relicense to GPL3+, add REUSE compliance 2020-05-08 20:10:27 -04:00
meson.build Bump to current development version, use semver 2023-07-01 12:37:16 +02:00
README.md Update README 2020-05-09 15:42:15 -04:00
wdisplays.png Update screenshot 2019-08-27 11:21:03 -04:00

README.md

wdisplays

License: GPL 3.0 or later

wdisplays is a graphical application for configuring displays in Wayland compositors. It borrows some code from kanshi. It should work in any compositor that implements the wlr-output-management-unstable-v1 protocol. Compositors that are known to support the protocol are Sway and Wayfire. The goal of this project is to allow precise adjustment of display settings in kiosks, digital signage, and other elaborate multi-monitor setups.

Screenshot

Installation

Repology

Check your distro for a wdisplays package. Known distro packages:

Building

Build requirements are:

  • meson
  • GTK+3
  • epoxy
  • wayland-client
meson build
ninja -C build
sudo ninja -C build install

Usage

Displays can be moved around the virtual screen space by clicking and dragging them in the preview on the left panel. By default, they will snap to one another. Hold Shift while dragging to disable snapping. You can click and drag with the middle mouse button to pan. Zoom in and out either with the buttons on the top left, or by holding Ctrl and scrolling the mouse wheel. Fine tune your adjustments in the right panel, then click apply.

There are some options available by clicking the menu button on the top left:

  • Automatically Apply Changes: Makes it so you don't have to hit apply. Disable this for making minor adjustments, but be careful, you may end up with an unusable setup.
  • Show Screen Contents: Shows a live preview of the screens in the left panel. Turn off to reduce energy usage.
  • Overlay Screen Names: Shows big names in the corner of all screens for easy identification. Disable if they get in the way.

FAQ

What is this?

It's intended to be the Wayland equivalent of an xrandr GUI, like ARandR.

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. Integration with that and other external daemons is planned.

How do I add support to my compositor?

A minimal amount of code (approximately 150-200 LOC) is currently required to get support for this in wlroots compositors. See the diff here for a sample implementation on top of tinywl: tinywl-output-management.