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: 1 day 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: 2024-12-26T21:20:21.000Z (about 1 month ago)
• Last Synced: 2025-01-11T20:02:27.182Z (15 days ago)
• Topics: desktop-widgets, gtk, gtk3, status-bar, wayland, widget, widgets, x11
• Language: Python
• Homepage: https://wiki.ffpy.org
• Size: 3.06 MB
• Stars: 592
• Watchers: 11
• Forks: 20
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        


Ricing, Made Easy 🍚⚡

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



---

## What is 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.

> [!NOTE]

> Fabric is still a work in progress. this means is that the API is a subject to change.

## 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 (combined)

  ![config can be found under the examples/bar and examples/side-panel directory](assets/example-files-bar-showcase.png)

## Hacking and Contributing

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