<p align="center">
<img width="18%" align="center" src="https://raw.githubusercontent.com/zhiyiYo/PyQt-Fluent-Widgets/master/docs/source/_static/logo.png" alt="logo">
</p>
<h1 align="center">
PySide2-Fluent-Widgets
</h1>
<p align="center">
A fluent design widgets library based on PySide2
</p>
<div align="center">
[](https://pypi.org/project/PyQt-Fluent-Widgets)
[]()
[](LICENSE)
[]()
</div>
<p align="center">
English | <a href="docs/README_zh.md">简体中文</a>
</p>
## Install
To install lite version (`AcrylicLabel` is not available):
```shell
pip install PySide2-Fluent-Widgets -i https://pypi.org/simple/
```
Or install full-featured version:
```shell
pip install "PySide2-Fluent-Widgets[full]" -i https://pypi.org/simple/
```
The [Pro version](https://qfluentwidgets.com/pages/pro) library contains more advance components. You can download `PyQt-Fluent-Widgets-Pro-Gallery.zip` from the [release page](https://github.com/zhiyiYo/PyQt-Fluent-Widgets/releases) for preview purposes.
C++ QFluentWidgets require purchasing a license from the [official website](https://qfluentwidgets.com/price). You can also download the compiled demo `C++_QFluentWidgets.zip` from the [release page](https://github.com/zhiyiYo/PyQt-Fluent-Widgets/releases).
> [!Warning]
> Don't install PyQt-Fluent-Widgets, PyQt6-Fluent-Widgets, PySide2-Fluent-Widgets and PySide6-Fluent-Widgets at the same time, because their package names are all `qfluentwidgets`.
## Run Example
After installing PySide2-Fluent-Widgets package using pip, you can run any demo in the examples directory, for example:
```shell
cd examples/gallery
python demo.py
```
If you encounter `ImportError: cannot import name 'XXX' from 'qfluentwidgets'`, it indicates that the package version you installed is too low. You can replace the mirror source with https://pypi.org/simple and reinstall again.
## Documentation
Want to know more about PySide2-Fluent-Widgets? Please read the [help document](https://qfluentwidgets.com) 👈
## License
PySide2-Fluent-Widgets adopts dual licenses. Non-commercial usage is licensed under [GPLv3](./LICENSE). For commercial purposes, please purchase [commercial license](https://qfluentwidgets.com/price) to support the development of this project.
Copyright © 2021 by zhiyiYo.
## Work with Designer
[Fluent Client](https://www.youtube.com/watch?v=7UCmcsOlhTk) integrates designer plugins, supporting direct drag-and-drop usage of QFluentWidgets components in Designer. You can purchase the client from [TaoBao](https://item.taobao.com/item.htm?ft=t&id=767961666600) or [Afdian](https://afdian.com/item/6726fcc4247311ef8c6852540025c377).
## See Also
Here are some projects based on PyQt-Fluent-Widgets:
* [**zhiyiYo/Fluent-M3U8**: A cross-platform m3u8 downloader](https://fluent-m3u8.org)
* [**zhiyiYo/Groove**: A cross-platform music player based on PyQt5](https://github.com/zhiyiYo/Groove)
* [**zhiyiYo/Alpha-Gobang-Zero**: A gobang robot based on reinforcement learning](https://github.com/zhiyiYo/Alpha-Gobang-Zero)
## Reference
* [**Windows design**: Design guidelines and toolkits for creating native app experiences](https://learn.microsoft.com/zh-cn/windows/apps/design/)
* [**Microsoft/WinUI-Gallery**: An app demonstrates the controls available in WinUI and the Fluent Design System](https://github.com/microsoft/WinUI-Gallery)
Raw data
{
"_id": null,
"home_page": "https://qfluentwidgets.com",
"name": "PySide2-Fluent-Widgets",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "pyside2 fluent widgets",
"author": "zhiyiYo",
"author_email": "shokokawaii@outlook.com",
"download_url": "https://files.pythonhosted.org/packages/0e/b2/a1e056e0741230a7fdd568da77448173da70cfbf0658694db4334585a9d8/pyside2_fluent_widgets-1.8.6.tar.gz",
"platform": null,
"description": "<p align=\"center\">\n <img width=\"18%\" align=\"center\" src=\"https://raw.githubusercontent.com/zhiyiYo/PyQt-Fluent-Widgets/master/docs/source/_static/logo.png\" alt=\"logo\">\n</p>\n <h1 align=\"center\">\n PySide2-Fluent-Widgets\n</h1>\n<p align=\"center\">\n A fluent design widgets library based on PySide2\n</p>\n\n<div align=\"center\">\n\n[](https://pypi.org/project/PyQt-Fluent-Widgets)\n[]()\n[](LICENSE)\n[]()\n\n</div>\n\n\n<p align=\"center\">\nEnglish | <a href=\"docs/README_zh.md\">\u7b80\u4f53\u4e2d\u6587</a>\n</p>\n\n\n\n\n## Install\nTo install lite version (`AcrylicLabel` is not available):\n```shell\npip install PySide2-Fluent-Widgets -i https://pypi.org/simple/\n```\nOr install full-featured version:\n```shell\npip install \"PySide2-Fluent-Widgets[full]\" -i https://pypi.org/simple/\n```\n\n\nThe [Pro version](https://qfluentwidgets.com/pages/pro) library contains more advance components. You can download `PyQt-Fluent-Widgets-Pro-Gallery.zip` from the [release page](https://github.com/zhiyiYo/PyQt-Fluent-Widgets/releases) for preview purposes.\n\nC++ QFluentWidgets require purchasing a license from the [official website](https://qfluentwidgets.com/price). You can also download the compiled demo `C++_QFluentWidgets.zip` from the [release page](https://github.com/zhiyiYo/PyQt-Fluent-Widgets/releases).\n\n> [!Warning]\n> Don't install PyQt-Fluent-Widgets, PyQt6-Fluent-Widgets, PySide2-Fluent-Widgets and PySide6-Fluent-Widgets at the same time, because their package names are all `qfluentwidgets`.\n\n\n## Run Example\nAfter installing PySide2-Fluent-Widgets package using pip, you can run any demo in the examples directory, for example:\n```shell\ncd examples/gallery\npython demo.py\n```\n\nIf you encounter `ImportError: cannot import name 'XXX' from 'qfluentwidgets'`, it indicates that the package version you installed is too low. You can replace the mirror source with https://pypi.org/simple and reinstall again.\n\n## Documentation\nWant to know more about PySide2-Fluent-Widgets? Please read the [help document](https://qfluentwidgets.com) \ud83d\udc48\n\n\n## License\nPySide2-Fluent-Widgets adopts dual licenses. Non-commercial usage is licensed under [GPLv3](./LICENSE). For commercial purposes, please purchase [commercial license](https://qfluentwidgets.com/price) to support the development of this project.\n\nCopyright \u00a9 2021 by zhiyiYo.\n\n\n## Work with Designer\n[Fluent Client](https://www.youtube.com/watch?v=7UCmcsOlhTk) integrates designer plugins, supporting direct drag-and-drop usage of QFluentWidgets components in Designer. You can purchase the client from [TaoBao](https://item.taobao.com/item.htm?ft=t&id=767961666600) or [Afdian](https://afdian.com/item/6726fcc4247311ef8c6852540025c377).\n\n\n\n\n## See Also\nHere are some projects based on PyQt-Fluent-Widgets:\n* [**zhiyiYo/Fluent-M3U8**: A cross-platform m3u8 downloader](https://fluent-m3u8.org)\n* [**zhiyiYo/Groove**: A cross-platform music player based on PyQt5](https://github.com/zhiyiYo/Groove)\n* [**zhiyiYo/Alpha-Gobang-Zero**: A gobang robot based on reinforcement learning](https://github.com/zhiyiYo/Alpha-Gobang-Zero)\n\n## Reference\n* [**Windows design**: Design guidelines and toolkits for creating native app experiences](https://learn.microsoft.com/zh-cn/windows/apps/design/)\n* [**Microsoft/WinUI-Gallery**: An app demonstrates the controls available in WinUI and the Fluent Design System](https://github.com/microsoft/WinUI-Gallery)\n",
"bugtrack_url": null,
"license": "GPLv3",
"summary": "A fluent design widgets library based on PySide2",
"version": "1.8.6",
"project_urls": {
"Bug Tracker": "https://github.com/zhiyiYo/PyQt-Fluent-Widgets/issues",
"Documentation": "https://qfluentwidgets.com/",
"Homepage": "https://qfluentwidgets.com",
"Source Code": "https://github.com/zhiyiYo/PyQt-Fluent-Widgets/tree/PySide2"
},
"split_keywords": [
"pyside2",
"fluent",
"widgets"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "ac035059c569a3e9611eda02849dac88990a87ea1211f6031f79208cab577c92",
"md5": "9981002ad7420974dbf0d5d10ea01dee",
"sha256": "b30dd686a6ba8929d7563fab6c7e866ecd09cd20495c9f1b5f4daec47387f294"
},
"downloads": -1,
"filename": "pyside2_fluent_widgets-1.8.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9981002ad7420974dbf0d5d10ea01dee",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 1536116,
"upload_time": "2025-08-04T14:46:41",
"upload_time_iso_8601": "2025-08-04T14:46:41.964723Z",
"url": "https://files.pythonhosted.org/packages/ac/03/5059c569a3e9611eda02849dac88990a87ea1211f6031f79208cab577c92/pyside2_fluent_widgets-1.8.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "0eb2a1e056e0741230a7fdd568da77448173da70cfbf0658694db4334585a9d8",
"md5": "c5e08df43fcbf0ba65d7619b4b7572cc",
"sha256": "c54179f7abfa2c3bb8f26b27b9d4b1c91aa5f92e8d132c3df3ff890788f98823"
},
"downloads": -1,
"filename": "pyside2_fluent_widgets-1.8.6.tar.gz",
"has_sig": false,
"md5_digest": "c5e08df43fcbf0ba65d7619b4b7572cc",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 1442824,
"upload_time": "2025-08-04T14:46:44",
"upload_time_iso_8601": "2025-08-04T14:46:44.493865Z",
"url": "https://files.pythonhosted.org/packages/0e/b2/a1e056e0741230a7fdd568da77448173da70cfbf0658694db4334585a9d8/pyside2_fluent_widgets-1.8.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-04 14:46:44",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "zhiyiYo",
"github_project": "PyQt-Fluent-Widgets",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "PyQt5",
"specs": [
[
">=",
"5.15.0"
]
]
},
{
"name": "PyQt5-Frameless-Window",
"specs": [
[
">=",
"0.4.0"
]
]
},
{
"name": "darkdetect",
"specs": []
},
{
"name": "colorthief",
"specs": []
},
{
"name": "scipy",
"specs": []
},
{
"name": "pillow",
"specs": []
}
],
"lcname": "pyside2-fluent-widgets"
}
JSON
