FAQs

Note

If you’re using Fabric inside a virtual environment managed by something other than the venv module included by python and you’re getting import errors (and all dependencies exist), try using Fabric in a virtual environment generated by python -m venv venv.

General

Audio service/widget is not working

libcvc is probably missing. Install the cinnamon-desktop package (not to be confused with the cinnamon package which’s a desktop environment.)

If cinnamon-desktop wasn’t packaged for your system, use the install script found in scripts/libcvc of the git repository.

My window does not show up

Try the following debugging steps:

• Check that you don’t have any blocking code that runs before Fabric (e.g doing web requests.)
• Check if the window is shown using the show_all function or the all_visible=True parameter.

---

Wayland

My window size goes crazy for a second and then goes back to normal

This is a known issue when showing an empty gtk-layer-shell window on wlroots based compositors.

A workaround is to make sure not to show any empty windows; you can set the visible parameter to False until you add a child to the window. You can use the .show_all() method to show the window once you do.

My window shows up as a normal window, not a layer

This might happen if the GDK_BACKEND environment variable is set to x11 or anything other than wayland; this may also happen if your compositor does not support the layer-shell protocol (e.g. GNOME is refusing to implement the protocol)

If your compositor supports the protocol, you can fix this issue by setting the GDK_BACKEND variable to wayland (e.g. env GDK_BACKEND=wayland python config.py.)

Double check your import module. Make sure you import the correct module

# Wrong ❌
from fabric.widgets.window import Window

# Correct ✅
from fabric.widgets.wayland import WaylandWindow as Window

My eventbox isn’t eventboxing properly

If you’re on Hyprland, this is a known issue with hyprland layer surfaces. (last known version to be working fine is 0.28.0)

If you’re not on Hyprland, provide more information through a GitHub issue or our Discord server.

My widget isn’t blurring its background on Hyprland

Add these lines to your Hyprland config based on the version you have…

For Hyprland < v0.53.0:

layerrule = blur, fabric.*
layerrule = ignorezero, fabric.*

For Hyprland >= v0.53.0:

layerrule = blur on, match:namespace fabric.*
layerrule = ignore_alpha 0, match:namespace fabric.*

And for Lua:

hl.layer_rule({
    match = { namespace = "^fabric.*" },
    blur = true,
    ignorealpha = 0,
})

Make sure to change the snippet if you’ve changed your Fabric’s window namespace.

---

X11/Xorg

Note

Fabric’s X11/Xorg backends are still experimental; issues might occur.

I can’t add margin to my window

Try setting the window type to "popup".

My window has rounded corners that I didn’t set

Check your compositor configuration; it may be setting rounded corners for Fabric windows.

When I set my window to have transparency, I get a black background color

This may be caused due to you being having no running compositor; check out picom or compton (no longer maintained).