# zhiyiyo/pyqt-fluent-widgets

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/zhiyiyo-pyqt-fluent-widgets).**

7,651 stars · 741 forks · Python · gpl-3.0

## Links

- GitHub: https://github.com/zhiyiYo/PyQt-Fluent-Widgets
- Homepage: https://qfluentwidgets.com
- awesome-repositories: https://awesome-repositories.com/repository/zhiyiyo-pyqt-fluent-widgets.md

## Topics

`custom` `fluent` `fluent-design` `fluentui` `gui` `modern` `pyqt5` `pyqt6` `pyside2` `pyside6` `python` `qt` `qt5` `qt6` `software` `ui` `widgets` `win11` `winui` `winui3`

## Description

PyQt-Fluent-Widgets is a Python GUI component library and framework extension that provides a set of pre-styled UI components following modern Fluent design standards. It replaces standard PyQt controls with a specialized widget set designed for building contemporary desktop applications.

The library distinguishes itself by offering advanced layout patterns, such as waterfall grids, loading skeleton screens, and split-view application shells. It provides a comprehensive collection of high-level interface elements, including navigation menu systems, configuration setting cards, and complex view composites like carousels and paginated lists.

The toolkit covers a broad range of functional areas, including data visualization through interactive charts and gauges, media handling tools for image cropping and audio waveform visualization, and specialized communication components for chat interfaces. It also includes a variety of user input fields, date and time pickers, and temporary overlays such as flyouts and dialogs.

## Tags

### Part of an Awesome List

- [GUI Components](https://awesome-repositories.com/f/awesome-lists/devtools/gui-components.md) — Provides a comprehensive library of specialized interface elements including data charts and chat boxes.
- [Configuration UI Cards](https://awesome-repositories.com/f/awesome-lists/devtools/configuration-ui-cards.md) — Provides standardized configuration cards for managing colors, shortcuts, and combo box settings. ([source](https://qfluentwidgets.com/pages/pro))
- [Layout Pattern Extensions](https://awesome-repositories.com/f/awesome-lists/devtools/desktop-ui-frameworks/layout-pattern-extensions.md) — Extends desktop UI capabilities with advanced patterns like waterfall grids and loading skeleton screens.

### User Interface & Experience

- [Fluent Design Component Libraries](https://awesome-repositories.com/f/user-interface-experience/fluent-design-component-libraries.md) — Provides a comprehensive library of Python widgets that implement the modern Fluent Design system. ([source](https://cdn.jsdelivr.net/gh/zhiyiyo/pyqt-fluent-widgets@master/README.md))
- [Application Shells](https://awesome-repositories.com/f/user-interface-experience/application-window-managers/application-shells.md) — Provides pre-configured application shells with split-views and top-navigation layouts. ([source](https://qfluentwidgets.com/pages/pro))
- [Styled Widget Sets](https://awesome-repositories.com/f/user-interface-experience/custom-widget-frameworks/custom-widget-implementation/styled-widget-sets.md) — Offers a specialized set of interface elements that replace standard PyQt controls with modern styles.
- [Custom Widget Rendering](https://awesome-repositories.com/f/user-interface-experience/custom-widget-rendering.md) — Implements custom painting using the Qt Painter API to achieve modern vector-like graphics and rounded corners.
- [Desktop Design Systems](https://awesome-repositories.com/f/user-interface-experience/desktop-design-systems.md) — Implements a consistent and contemporary visual language following modern Fluent design standards for PyQt.
- [Input Controls](https://awesome-repositories.com/f/user-interface-experience/input-field-enhancements/input-field-initializers/styled-input-fields/input-controls.md) — Ships a comprehensive set of styled input fields, push buttons, and multi-selection combo boxes. ([source](https://qfluentwidgets.com/pages/pro))
- [Navigation Bars](https://awesome-repositories.com/f/user-interface-experience/navigation-components/navigation-bars.md) — Implements persistent navigation bars and menu systems for structured application movement. ([source](https://qfluentwidgets.com/pages/pro))
- [Python GUI Frameworks](https://awesome-repositories.com/f/user-interface-experience/ui-architecture/gui-toolkits/python-gui-frameworks.md) — Provides a reusable set of widgets for building complex desktop interfaces using Python.
- [Date and Time Pickers](https://awesome-repositories.com/f/user-interface-experience/date-and-time-pickers.md) — Provides advanced calendar and time picker components for precise scheduling in desktop applications. ([source](https://qfluentwidgets.com/pages/pro))
- [Dialogs](https://awesome-repositories.com/f/user-interface-experience/dialogs.md) — Includes various overlay components such as drawers, waiting dialogs, and color pickers for focused interactions. ([source](https://qfluentwidgets.com/pages/pro))
- [Theme Propagators](https://awesome-repositories.com/f/user-interface-experience/dynamic-content-updaters/theme-propagators.md) — Features a global theme object that propagates visual style updates to all active widgets at runtime.
- [Waterfall Layouts](https://awesome-repositories.com/f/user-interface-experience/grid-layouts/waterfall-layouts.md) — Features a waterfall layout manager to arrange widgets of varying sizes in a fluid grid. ([source](https://qfluentwidgets.com/pages/pro))
- [Data Visualizations](https://awesome-repositories.com/f/user-interface-experience/high-volume-data-rendering/data-visualizations.md) — Renders complex datasets via interactive charts, gauges, and themed tables in a desktop environment.
- [Application Shell Composition](https://awesome-repositories.com/f/user-interface-experience/layout-composition-frameworks/application-shell-composition.md) — Provides architectural shells and navigation views by assembling modular styled components into complex application layouts.
- [Loading Skeletons](https://awesome-repositories.com/f/user-interface-experience/loading-skeletons.md) — Implements placeholder skeleton screens to maintain visual stability during asynchronous data loading. ([source](https://qfluentwidgets.com/pages/pro))
- [Chat Interface Components](https://awesome-repositories.com/f/user-interface-experience/prebuilt-ui-components/chat-interface-components.md) — Ships messaging components featuring typewriter effects and specialized text input boxes for real-time communication. ([source](https://qfluentwidgets.com/pages/pro))
- [Progress Indicators](https://awesome-repositories.com/f/user-interface-experience/progress-indicators.md) — Offers diverse visual feedback components including progress bars, radial gauges, and toast notifications. ([source](https://qfluentwidgets.com/pages/pro))
- [Qt Style Sheet Styling](https://awesome-repositories.com/f/user-interface-experience/styling-theming-systems/content-styling/styling-architectures/styling-systems/class-based-styling/css-class-based-styling/qt-style-sheet-styling.md) — Decouples visual aesthetics from functional logic through external CSS-like QSS files.
- [Text Editing Components](https://awesome-repositories.com/f/user-interface-experience/text-editing-components.md) — Provides specialized text input widgets, including code editors and token-based line edits. ([source](https://qfluentwidgets.com/pages/pro))
- [State-Driven Animations](https://awesome-repositories.com/f/user-interface-experience/ui-animations/state-driven-animations.md) — Manages visual transitions and hover effects by interpolating properties through a dedicated animation controller.
- [User Preference Settings](https://awesome-repositories.com/f/user-interface-experience/user-preference-settings.md) — Provides organized configuration menus and specialized setting cards for managing user preferences.
- [Composite](https://awesome-repositories.com/f/user-interface-experience/view-layouts/composite.md) — Implements complex composites such as carousels, paginated lists, and themed table widgets. ([source](https://qfluentwidgets.com/pages/pro))

### Development Tools & Productivity

- [Custom Widget Inheritance](https://awesome-repositories.com/f/development-tools-productivity/qt-framework-integrations/custom-widget-inheritance.md) — Extends base Qt classes to implement custom behavior while preserving native event handling and layout logic.

### Operating Systems & Systems Programming

- [PyQt Application Frameworks](https://awesome-repositories.com/f/operating-systems-systems-programming/desktop-environment-frameworks/desktop-environment-components/desktop-application-development/pyqt-application-frameworks.md) — Enables the creation of functional desktop software using a wide array of pre-styled PyQt widgets.

### Data & Databases

- [Data Visualization Charts](https://awesome-repositories.com/f/data-databases/data-visualization-charts.md) — Provides various chart types for visualizing complex datasets through direct or object-oriented configuration. ([source](https://qfluentwidgets.com/pages/pro))
