From Gentoo Wiki
Jump to:navigation Jump to:search

Wayfire is a Wayland compositor inspired by Compiz and based on wlroots.

Wayfire aims to create a customizable, extendable and lightweight environment without sacrificing its appearance. It features a lot of graphical effects such as the desktop cube, wobbly windows, fire animation, fish eye, workspace scale view and window rotations, among many other features.


USE flags

USE flags for gui-wm/wayfire compiz like 3D wayland compositor

X Add support for X11
debug Enable extra debug codepaths, like asserts and extra output. If you want to get meaningful backtraces see https://wiki.gentoo.org/wiki/Project:Quality_Assurance/Backtraces
gles use libglvnd to do animations more efficiently
system-wfconfig use the system-wide wf-config, else build it as a submodule. DO NOT DISABLE UNLESS YOU KNOW WHAT YOU ARE DOING.
system-wlroots use the system wide wlroots, else build it as a submodule. DO NOT DISABLE UNLESS YOU KNOW WHAT YOU ARE DOING.


root #emerge --ask gui-wm/wayfire


The default configuration file is ~/.config/wayfire.ini but Wayfire also supports loading custom configuration files. A graphical interface for configuration is provided by the optional package gui-apps/wcm.


Wayfire is only a wayland compositor and does not provide the full capabilities expected from a desktop environment. It is best used alongside gui-apps/wf-shell, which adds among other features a GTK3-based status bar and wallpaper support.

Wayfire needs additional applications which implement other parts of the XDG specifications from Freedesktop, such as desktop notifications, application launchers, screenshotting, screen recording and screen locking among other important necessities.

A list of wayland native applications is compiled and maintained at the Wayland Desktop Landscape article.



root #emerge --ask --depclean --verbose gui-wm/wayfire

See also