Baike.dev
All toolsOnline toolsAI codingTrendingOpen sourceNewsSubmit
Log in
< Back to tools
W

way-displays

> 编程语言
Open source

way-displays: Auto Manage Your Wayland Displays

375 stars0 likes0 views
WebsiteGitHub

About

way-displays: Auto Manage Your Wayland Displays

New Release 2026-08-17: 2.0.0

See Version 2.0.0 Changes

Packagers: libyaml dependency replaces yaml-cpp

way-displays: Auto Manage Your Wayland Displays

  1. Set resolution/refresh: preferred, highest or custom

  2. Enable VRR / adaptive sync

  3. Arrange in a row or a column

  4. Auto scale based on DPI: 96 is a scale of 1

  5. Update when displays plugged/unplugged with optionally defined conditions

  6. Update when laptop lid closed/opened

Works out of the box: no configuration required.

Communicates verbosely via logs/stdout and notifications.

Wayland successor to xlayoutdisplay, inspired by kanshi.

Requirements

A wlroots based compositor that supports the WLR Output Management protocol version 4+.

way-displays is blessed for the sway, river and river-classic compositors. It may work on others; please tell me of your experiences!

Hpyrland already provides all the features of way-displays. It may function, however it is explicitly not supported and you will likely experience problems. Please do not raise issues.

way-displays must be run as a daemon, a background server process. It will respond to your configuration changes as well as state changes such as plugging in a monitor or closing the lid.

User should be a member of the input UNIX group for querying laptop lid state.

Documentation

man way-displays for server and CLI details.

man 5 way-displays for cfg.yaml config file reference.

wiki: Recipes

wiki: IPC

wiki: Troubleshooting

Quick Start

Start the way-displays server:

Sway
Remove any output commands from your sway config file and add the following:

bash
exec way-displays > /tmp/way-displays.${XDG_VTNR}.${USER}.log 2>&1

River
Add the following to your River Window Manager’s init script or similar:

bash
exec way-displays > /tmp/way-displays.${XDG_VTNR}.${USER}.log 2>&1

River Classic
Add the following to your ${XDG_CONFIG_HOME}/river/init:

bash
way-displays > /tmp/way-displays.${XDG_VTNR}.${USER}.log 2>&1 &

Configure

Restart the compositor and run way-displays -g or look at /tmp/way-displays.${XDG_VTNR}.${USER}.log

way-displays will communicate verbosely via the logs - you might want to tail -f /tmp/way-displays.${XDG_VTNR}.${USER}.log whilst you are tweaking.

Tweak cfg.yaml to your liking and save it, see man 5 way-displays. Changes will be immediately applied.

Alternatively, use the CLI to make your changes then persist them with way-displays -w

Installation

Package Manager

From Source

master is unstable, a release tag is recommended for a stable experience. See CONTRIBUTING for a list of the dependencies you'll need.

Install / Uninstall

bash
sudo make install
sudo make uninstall

Issues

Please collect debug logs, create a github issue and attach your log.

Questions, Ideas And Contributions

Please raise a github issue

Contributions are most gratefully received, see Milestones for prioritised issues.

Issues· 0 open

View all issuesOpen on GitHub

No open issues yet, or sync has not completed.

> Tags

C

No comments yet. Be the first to share.

> Details

PublishedAug 1, 2026
UpdatedSep 17, 2026
Category编程语言
PricingOpen source

> Related tools

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言