Repository files navigation

KDisplay is a small display management app.It provides a simple and straightforward UI for managing an arbitrary number of displays.

• Displays can be repositioned with drag-and-drop.
• An optimal resolution and refresh rate are automatically selected.Manual override is possible.
• Displays can be seemlessly "replicated".
• The settings of a display is by default remembered globallybut can be overridden for specific combinations of displays.
• Provides additional integration for the KDE Plasma Workspace through a plasmoid and an OSDactivated by hardware key for quick configuration changes.

KDisplay works with many windowing system and compositors:

• Any X11 desktop
• Wayland:
  • Theseus' Ship and other The Compositor Modules based compositors
  • sway and other wlroots based compositors

Your distribution might provide KDisplay already as a package:

• Arch(AUR):kdisplay-kwinft
• Manjaro:sudo pacman -S kdisplay

KDisplay can also be compiled from source with following dependencies:

• Extra CMake Modules
• Qt
• Disman
• KDBusAddons
• KDeclarative
• KI18n
• Kirigami

Configure, build and install KDisplay like any other CMake based project.You can install it to your normal system directory.This will also ensure certain service filesfor integration with the KDE Plasma workspacewill be picked up correctly.

Just runkdisplay from command lineor look for the "Displays" entry in the launcher that your desktop environment provides.

On laptops the OSD can be activated by hardware key.The plasmoid is available in the systems tray.

See first the respective section inDisman's Readme.In case KDisplay is identified as being responsible for the issue you experienceand noissue ticket exists yet for this specific issue please create a new ticket.

KDisplay has been translated to the following languages already:

We use theWeblate service for localization.If you want to help us translating KDisplay to your native or other languagesplease join us there.

If you are interested in improving the KDisplay source code directly,see theCONTRIBUTING.md file on how to get started.

Issue tickets can be created for feature requests, bug reports or general discussions.For direct communication joinThe Compositor Modules Matrix room.