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

next-gen 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: 6 days ago
JSON representation

next-gen 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 (10 months ago)
• Default Branch: main
• Last Pushed: 2024-07-17T11:37:01.000Z (4 months ago)
• Last Synced: 2024-07-24T00:25:39.640Z (4 months ago)
• Topics: desktop-widgets, gtk, gtk3, status-bar, wayland, widget, widgets, x11
• Language: Python
• Homepage: https://ffpy.org
• Size: 2.93 MB
• Stars: 332
• Watchers: 7
• Forks: 12
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-hyprland - fabric

README

        
_**ricing made easy!**_ 🍙

> [!WARNING]

> Please use the new Fabric rewrite (mentioned at [#43](https://github.com/Fabric-Development/fabric/pull/43)), this branch is NOT going to **receive any more maintenance** until the rewrite is merged!

# What is this?

Fabric is a python widgets _~~thing~~ framework_   made for \*Nix based systems (Wayland and X11), using GTK+

Fabric aims to provide you high-level and signal-based flow, neither polling nor bash scripting is required to do **basic** stuff, old men!

Also Fabric is configured in python which make's it easier than ever!

> [!NOTE]

> Please note that Fabric is still a work in progress, also the API is a subject to change.

For discussions and questions, [join us on discord](https://discord.gg/3sDbYc9SZP)

Fabric Wiki: https://fabric-development.github.io/fabric-wiki/

### key features

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

	asking how simple actually it is?

	 \- head over to examples

1. X11 and Wayland ready!

2. All python modules are accessible to you!

3. Code  auto-completions ready!, see the stubs guide for more info: TBD

5. Less resource usage

	since everything can be written within the widget code this will no longer require you using external scripts, this will decrease the widget resource usage

---

## Showcase Section

these are some bars/widgets made using Fabric

- example files

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

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

---

# Hacking and Contributing

seek over [our wiki pages](https://fabric-development.github.io/fabric-wiki/hacking-guide.html)