FAQ

Here is a non-extensive list of some common issues which arise when using Wayfire.

Table of contents

• 1. Wayfire shows just a black screen with a cursor visible
• 2. The mouse cursor is invisible

1. Wayfire shows just a black screen with a cursor visible

Wayfire itself is just a "bare-bones" compositor, similar to Mutter. If you want a background and a panel, you should also install wf-shell. In case you install to non-standard prefix and you do not use wf-install, don't forget to set the appropriate environment variables(for example, LD_LIBRARY_PATH so that the panel/background can find wf-config, and PATH).

2. The mouse cursor is invisible

This is a known problem for ex. with the nouveau driver. As a workaround, set the WLR_NO_HARDWARE_CURSORS=1 environmental variable before starting Wayfire.