Using Wayland

Revision as of 20:28, 14 May 2019 by Duck (talk | contribs) (Compositors)


The goal of this page is to relate experiences using Wayland working implementations, software replacement from the X11 world and so on.

Duck: also please note I'm an AwesomeWM user so I'm not looking into major desktop implementations like GNOME or KDE but more on mixing interesting pieces to fit your needs better. You can have a look at my configuration in my repository (Ansible rules).


There's many Wayland compositor projects around but a lot are very experimental and many even already abandoned.

Working or prospective compositors follows.


Status: very active project, create a wlroots framework to share with other compositors, version 1.0 is usable with some glitches, seamless xwayland integration


  • DRM issues when switching VT or when going out from idle (DPMS off and on) (disappeared when switching to kernel 5.0, probably a driver issue)
  • damage tracking issues with xwayland (ugly but not not annoying with most applications)
  • contextual windows in need of relative positioning are not displayed or not at the right location (tray contextual menu, IM selections)
  • games under Wine may not draw or grab input correctly if run fullscreen (but windowed using the full screen size is fine and anyway often better especially with older games when you switch back and forth between workspaces)

Packaging: not ready in Debian yet but WIP in Salsa: wlroots builds fine, Sway 1.0 final needs a patch (added -Wno-error=date-time to build options to work around a failure because some macro uses the build time and makes the build unreproducible)


  • swaybar (display workspaces, current window title, tray, time, CPU infos…)
    • integrated with sway, can use various commands to display stuff (i3status works fine and is packaged in Debian)
    • Status: works fine but tray support is limited (icon may be missing, contextual menu not working, WIP)
  • Waybar (more fancy bar)
  • swaylock (lock screen)
    • packaged in Debian
    • Status: works fine
  • swayidle (run custom actions on idle and back from idle)
    • packaged in Debian
    • Status: works fine but stopped using it because of the DRM issues listed above
  • remote desktop

Way Cooler (spiritual successor of AwesomeWM)

Status: being rewritten on top of wlroots, far from being usable yet (as of early 2019)


Display Manager

  • lightdm:
    • packaged in Debian
    • Status: works fine to run Wayland sessions but runs on X11 itself

Application Menu Runner

  • j4-dmenu-desktop + bemenu:
    • j4-dmenu-desktop only is packaged in Debian
    • Status: works fine
    • Usage: j4-dmenu-desktop --dmenu='bemenu --list 10 --wrap --ignorecase --no-overlap --prompt "Run:" --fn "pango:DejaVu Sans Mono 12"' --term=x-terminal-emulator
  • dmenu:
    • packaged in Debian (suckless-tools)
    • Status: works fine but impossible to switch back to it if you loose focus (need to kill it in a term)
    • Usage: dmenu_path | dmenu -p "Run:" -l 10 | xargs swaymsg exec


  • mako:
    • not packaged in Debian
    • works fine
  • xfce4-notifyd:
    • packaged in Debian
    • Status: works fine but display in the middle of the screen thus not very practical

Input Method

  • fcitx4:
    • packaged in Debian
    • Status: untouched config from X11 works but completion menu is not displayed
  • fcitx5:
    • has Wayland support
    • only the core is packaged in Debian
    • Status: i was not able to make it work and quit
  • ibus:
    • packaged in Debian
    • Status: ibus-wayland is available and was switched to using a newer version of the wayland input protocol (see Debian#905001 and linked upstream BR) but Sway use an even newer version (and this one only); anyway these changes are mostly untested so I would not have too much hopes; without this plugin I was not able to make completion work at all, even when forcing the engine on the command-line

So here are the various protocols:

Screen Capture

  • grim: (screenshot)
    • packaged in Debian
    • Status: works fine

Screen Brightness

  • brightnessctl:
    • packaged in Debian (brightness-udev is needed to be usable as non-root)
    • Status: works fine