https://github.com/Fabric-Development/fabric

The next-generation framework for building desktop widgets using Python
https://github.com/Fabric-Development/fabric

desktop-widgets gtk gtk3 status-bar wayland widget widgets x11

Last synced: 14 days ago
JSON representation

The next-generation framework for building desktop widgets using Python

• Host: GitHub
• URL: https://github.com/Fabric-Development/fabric
• Owner: Fabric-Development
• License: agpl-3.0
• Created: 2024-01-16T05:32:14.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-03-19T08:30:38.000Z (28 days ago)
• Last Synced: 2025-03-31T00:01:43.803Z (16 days ago)
• Topics: desktop-widgets, gtk, gtk3, status-bar, wayland, widget, widgets, x11
• Language: Python
• Homepage: https://wiki.ffpy.org
• Size: 3.07 MB
• Stars: 807
• Watchers: 10
• Forks: 27
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

• awesome-hyprland - fabric

README

        


Ricing, Made Easy 🍚⚡

[ 
 Wiki Pages 
 ](https://wiki.ffpy.org) [ 
 Discord Server 
 ](https://discord.gg/3sDbYc9SZP)



---

## What's Fabric?

Fabric is a Desktop Widgets System that you can customize using Python. It offers a variety of features to make the often tedious process of creating widgets much easier and more enjoyable!

Our goal is to provide a high-level, signal-based workflow—no polling or bash scripting required for even the **most basic** tasks.

## Key Features

1. **Simple** yet **Powerful**

2. Supports both **X11 and Wayland**

3. Access to **all other Python modules**

4. Excellent **Developer Experience (DevEX)** and typing support

5. **Low resource usage**

   - Built-in Python code replaces the need for resource-heavy shell scripts

## Visual Tour

A Collection of Desktop rices that muscle-show what you are able to do using Fabric!

- Example files

  ![configs could be found under the examples/bar and examples/side-panel directories](assets/example-files-bar-showcase.png)

- [Ax-Shell](https://github.com/axenide/Ax-Shell)

  ![](https://wiki.ffpy.org/showcase/axenide-ax-shell.webp)

- [HydePanel](https://github.com/rubiin/HyDePanel)

  ![](https://wiki.ffpy.org/showcase/rubiin-hydepanel.webp)

- [Spacerice](https://github.com/rubiin/HyDePanel)

  ![](https://wiki.ffpy.org/showcase/slumberdemon-spacerice.webp)

- [Fabrika - فابريكا](https://example.com)

  ![](https://wiki.ffpy.org/showcase/darsh-fabrika.png)

## Hacking and Contributing

Interested in contributing? Check out the full guide in [our wiki pages](https://wiki.ffpy.org/contributing/hacking-guide/).