# Fabric-Development/fabric

The next-generation framework for building desktop widgets using Python

Repository: https://github.com/Fabric-Development/fabric
Canonical: https://ross.abutalabs.com/products/fabric-development-fabric
Homepage: https://wiki.ffpy.org
Language: Python
License: AGPL-3.0
License Family: copyleft
Topics: desktop-widgets, gtk, gtk3, status-bar, wayland, widget, widgets, x11
Last push: 2026-08-24T09:04:04+00:00

## Health v2 (maintenance only)
Score: 80/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 99, release rhythm 63, longevity 68
- inputs: {"age_days": 960, "days_push": 9, "days_rel": 32, "gap_med": 628, "n_releases_24m": 2}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1363, forks 47 (observed 2026-08-28T04:04:30.365718+00:00)

## What it is
Fabric is a Python framework for building customizable desktop widgets (bars, panels, shells) on Linux using GTK3 via PyGObject. It provides a high-level, signal-based workflow supporting both X11 and Wayland, inspired by tools like eww, ags, and Waybar.

## Use cases
- build a custom status bar for Hyprland
- create desktop widgets with Python instead of shell scripts
- make a side panel or shell for my Linux rice
- replace eww or ags with a Python-based widget system
- build a Wayland-compatible system bar
- customize my Linux desktop with low-resource widgets

## When to choose
- you know Python and want to build desktop widgets or bars on Linux
- you need X11 and Wayland support, including native Hyprland integration
- you want typed, auto-completed development with signal-based event handling
- you want to avoid resource-heavy shell scripting and polling

## When to avoid
- you need a cross-platform GUI framework for Windows or macOS apps
- you want GTK4 or a non-GTK widget toolkit
- you need a ready-made desktop environment rather than a build-it-yourself widget framework
- your project requires a permissive license since Fabric is AGPL-3.0

## Facets
- artifact type: framework
- maturity: active
- function: ui-components, gui, desktop-framework
- domain: desktop-applications, developer-tools, cross-platform
- platform: python
- tags: desktop-widgets, gtk3, ricing, status-bar, hyprland, pygobject, waybar-alternative, eww-alternative, linux, x11, wayland

## Member repositories
- Fabric-Development/fabric (main) score 80

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:30.365718+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:41:23.266316+00:00, confidence not recorded.
  - readme: https://github.com/Fabric-Development/fabric (fetched 2026-08-28T04:04:30.365718+00:00, sha e20b4fd314fd)
  - homepage: https://wiki.ffpy.org (fetched 2026-08-29T11:58:53.134366+00:00, sha 3917c187aaa6)
  - site_page: https://wiki.ffpy.org/getting-started/introduction (fetched 2026-08-29T11:58:53.143415+00:00, sha bfe5b371b2ba)
- Data as of 2026-08-30T08:39:29.467469+00:00.
