PySide6-Fluent-Widgets-Pro

A fluent design widgets library based on PyQt-Fluent-Widgets

English | 简体中文

📌 Introduction

This repository is based on the free version of QFluentWidgets (PySide6 port) and aims to restore / re-implement some components and behaviors from the Pro version.

Only a subset has been restored so far. The goal is to provide a drop-in, developer-friendly widget library for PySide6 with a Fluent Design look & feel.

✨ Status

• [scope] Partial restoration (work in progress)
• [target] Restore commonly used Pro widgets/components first
• [compatibility] Python 3.9+ / Windows, macOS, Linux

🧩 Restored Components (49)

The following components have been restored or extended in this repo (the list will be updated continuously):

HyperlinkToolButton FilledPushButton FilledToolButton TextPushButton TextToolButton LuminaPushButton OutlinedPushButton OutlinedToolButton RoundPushButton RoundToolButton Chip Tag SubtitleCheckBox SubtitleRadioButton ToolTipSlider RangeSlider Pager FilledProgressBar MultiSegmentProgressRing RadialGauge DropMultiFilesWidget DropSingleFileWidget TopFluentWindow ChartWidget Splitter PinBox LabelLineEdit StepProgressBar RoundTableWidget RoundTableView LineTableWidget LineTableView DropSingleFolderWidget DropMultiFoldersWidget MultiSelectComboBox RoundListWidget RoundListView TransparentRoundListWidget TransparentRoundListView CategoryCardListWidget CategoryCardListView Toast FontComboBox ExclusiveLiteFilter OutlinedExclusiveLiteFilter MultiSelectionLiteFilter OutlinedMultiSelectionLiteFilter WaterfallLayout TopNavigationBar

🚀 Installation

This repository is intended to be used as a source dependency.

Option 1: Clone and run the demo

git clone https://github.com/<your-name>/PySide6-Fluent-Widgets-Extend.git
python main.py

Option 2: Use in your own project

Copy the qfluentwidgets_pro folder into your project (or add this repo to your Python path), then:

from qfluentwidgets_pro import FluentWidget

Dependencies:

• PySide6 (Qt for Python)

🧪 Quick Start

from PySide6.QtWidgets import QApplication, QVBoxLayout
from qfluentwidgets_pro import FluentWidget, FluentIcon, ToolTipSlider, RangeSlider, HyperlinkToolButton


class Window(FluentWidget):
    def __init__(self):
        super().__init__()
        layout = QVBoxLayout(self)

        layout.addWidget(ToolTipSlider())

        rs = RangeSlider()
        rs.setRange(0, 100)
        rs.setValues(20, 80)
        layout.addWidget(rs)

        layout.addWidget(HyperlinkToolButton(FluentIcon.LINK, "https://github.com"))


app = QApplication([])
w = Window()
w.show()
app.exec()

📁 Project Structure

• qfluentwidgets_pro/
  • Main package (free base + restored components)
• main.py
  • Demo / playground
• docs/
  • Documentation assets

⚠️ Disclaimer

• This is a community-driven restoration/extension project.
• This repository is not affiliated with the official QFluentWidgets Pro team.
• Please respect the original project's license and commercial terms.

🧮 Acknowledgments

• Pager DropMultiFilesWidget DropSingleFileWidget Splitter PinBox LabelLineEdit Toast component implementation references PySide6-Fluent-UI by HiyorinI

🗺️ Roadmap

• Improve widget API consistency and documentation
• Restore more Pro widgets/components (prioritized by community needs)
• Add more examples and screenshots

🤝 Contributing

Contributions are welcome! Please feel free to submit issues and pull requests.

🏆 Contributors