FAQ

Can I Make Changes While way-displays Is Running?

Yes! You can make immedatie changes by:

Changing your cfg.yaml and writing it. See Configuration: cfg.yaml

or

Using way-displays --set and --delete commands. See Configuration: cfg.yaml for syntax and examples.

What Is Preferred Mode?

Displays advertise their available modes when plugged in. Some displays specify a mode as "preferred".

The preferred mode is usually the highest resolution/refresh available and it's a good default. You shouldn't need to tweak this.

In some cases the preferred mode is a horrid "compatibility" mode e.g. 1024x768@60Hz. You could fix this by setting MODE to MAX for that display.

On Scale And Blurring

When using a display scale that is not a whole number, the result will not be a pixel perfect rendition of the unscaled content. There are no fractional pixels so there will be rounding and thus some blurring.

To ameliorate this, we always round our scale to a multiple of one eighth. This results in a nice round binary number, which minimises some of the rounding and results in a smoother image. If you're interested, our rounded scale is a wl_fixed_t.

My Display Doesn't Support VRR

You can remove the annoying HDMI-A-1: Cannot enable VRR, display or compositor may not support it. messages by disabling VRR for the display.

Add your display to VRR_OFF

This will also result in a slightly faster startup.

X11 Applications And Games Are Blurry

XWayland applications are rendered at logical size and then scaled. This is blocked on wlroots support

Workarounds:

• Temporarily disable scaling via way-displays -s SCALING off
• Using Gamescope To Fix X11 Applications and Games