Beyond Linux® From Scratch (systemd Edition) - Version r13.0-1155

Chapter 24. Graphical Environments

wayfire-0.11.0

Introduction to wayfire

Wayfire is a Wayland compositor which takes a lot of effects from the now deprecated Compiz Xorg compositor. It aims to be customizable, yet lightweight. Unlike other compositors, it is also 3D and supports multiple perspectives for seeing windows.

[Note]

Note

An Internet connection is needed for building this package. The system certificate store may need to be set up with make-ca-1.16.1 before building this package.

[Note]

Note

Development versions of BLFS may not build or run some packages properly if LFS or dependencies have been updated since the most recent stable versions of the books.

Package Information

Wayfire Dependencies

Required

GLM-1.0.3, FreeType-2.14.3, libdrm-2.4.134, libevdev-1.13.6, libinput-1.31.3, libjpeg-turbo-3.2.0, libpng-1.6.58, libxkbcommon-1.13.2, Mesa-26.1.3, nlohmann-json-3.12.0, Pango-1.58.0 (with Cairo), Pixman-0.46.4, Wayland-1.26.0, wayland-protocols-1.49, and wlroots-0.20.2

Recommended

Xorg Libraries and yyjson-0.12.0 (will be downloaded if not installed)

Optional

Doxygen-1.17.0, libnotify-0.8.8, doctest (for tests), and libinotify

Installation of Wayfire

Install Wayfire by running the following commands: 

mkdir build &&
cd    build &&

meson setup --prefix=/usr --buildtype=release .. &&
ninja

Now, as the root user: 

ninja install

Remove some useless static libraries as the root user: 

rm -vf /usr/lib/libwftouch.a \
       /usr/lib/libwayfire-{move-drag-interface,workspace-wall}.a

Copy the default configuration file to /usr/share/wayfire as the root user: 

cp -v ../wayfire.ini /usr/share/wayfire

Configuring Wayfire

Config Files

~/.config/wayfire.ini. The default version is in /usr/share/wayfire and will not be used and must be copied to ~/.config

Configuration Information

Copy the default configuration file: 

cp /usr/share/wayfire/wayfire.ini ~/.config

Now, inspect the file and make any changes to suit your workflow. If you need to know which plugins are installed, examine the list of Installed Plugins below.

Contents

Installed Programs: wayfire and wayfire-plugin
Installed Libraries: libwayfire-blur-base.so, libwf-config.so, and libwf-utils.so
Installed Plugins: alpha, animate, autostart, blur, command, cube, decoration, default-config-backend, expo, extra-gestures, ext-toplevel, fast-switcher, fisheye, foreign-toplevel, grid, gtk-shell, idle, input-method-v1, invert, ipc-rules, ipc, kde-appmenu, move, oswitch, place, preserve-output, resize, scale, scale-title-filter, security-context-v1, session-lock, shortcuts-inhibit, simple-tile, stipc, switcher, vk-color-management, vswipe, vswitch, wayfire-shell, window-rules, wm-actions, wobbly, wrot, wsets, xdg-activation, xkb-bindings, and zoom
Installed Directories: /usr/include/wayfire, /usr/lib/wayfire, and /usr/share/wayfire

Short Descriptions

wayfire

is the Wayfire compositor

wayfire-plugin

manages and installs external Wayfire plugins

libwayfire-blur-base.so

provides basic functions for blur implementations in Wayfire

libwf-config.so

provides functions that manage configuration files

libwf-utils.so

contains several functions used by Wayfire and its libraries