https://github.com/kadir014/pyqt5-custom-widgets
More useful widgets for PyQt5
https://github.com/kadir014/pyqt5-custom-widgets
gui modern pyqt5 pyside2 python ui widgets
Last synced: 5 months ago
JSON representation
More useful widgets for PyQt5
- Host: GitHub
- URL: https://github.com/kadir014/pyqt5-custom-widgets
- Owner: kadir014
- License: gpl-3.0
- Created: 2021-05-07T10:32:07.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2021-08-11T07:29:58.000Z (almost 5 years ago)
- Last Synced: 2025-09-25T01:38:03.359Z (9 months ago)
- Topics: gui, modern, pyqt5, pyside2, python, ui, widgets
- Language: Python
- Homepage:
- Size: 5.57 MB
- Stars: 423
- Watchers: 10
- Forks: 60
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# PyQt5 Custom Widgets
More useful and stylish widgets for PyQt5 such as toggle switches, animated buttons, etc..
## Table of Contents
- [Installing](#Installing)
- [Usage](#Usage)
- [Widgets](#Widgets)
- [Examples](#References)
- [Documentation](#References)
- [Styling Reference](#References)
- [Dependencies](#Dependencies)
- [TODO](#Todo)
- [License](#License)
## Installing
Install using PIP (it might be `pip3` or `python3` depending on your platform)
```
pip install pyqt5Custom
```
or
```
python -m pip install pyqt5Custom
```
Also you can also use PySide2 instead of PyQt5 with just litte changes.
## Usage
Just import `pyqt5Custom` and you're ready to go. You can check out [Examples](https://github.com/kadir014/pyqt5-custom-widgets/blob/main/examples/), one little example for StyledButton widget:
```py
from pyqt5Custom import StyledButton
...
btn = StyledButton(text="Hello!")
btn.setStyleDict({
"border-radius" : 20,
"font-family" : "Helvetica",
"font-size" : 17
})
@btn.clicked.connect
def slot():
print("Quitting!")
app.exit()
layout.addWidget(btn)
...
```
## Widgets
| 
ToggleSwitch
[Documentation](documentation.md) | 
StyledButton
[Documentation](documentation.md) |
| :---: | :---: |
| 
**ImageBox**
[Documentation](documentation.md) | 
**ColorPicker**
[Documentation](documentation.md) |
| 
**DragDropFile**
[Documentation](documentation.md) | 
**EmbedWindow**
[Documentation](documentation.md) |
| 
**CodeTextEdit**
[Documentation](documentation.md) | 
**TitleBar**
[Documentation](documentation.md) |
| 
**Spinner**
[Documentation](documentation.md) | 
**Toast**
[Documentation](documentation.md) |
## References
- See [Examples](https://github.com/kadir014/pyqt5-custom-widgets/blob/main/examples/) page for examples
- See [Documentation](documentation.md) page for documentation and detailed widget references
- See [styling reference](stylingref.md) page for styling instructions on custom widget
## Dependencies
- [PyQt5](https://pypi.org/project/PyQt5/)
- [requests](https://pypi.org/project/requests/)
## TODO
- [ ] Better styling and QSS support
- [ ] Rework animations using [Qt's animation framework](https://doc.qt.io/qtforpython/overviews/animation-overview.html)
- [ ] Optimize and complete ColorPicker widget
## License
[GPL v3](LICENSE) © Kadir Aksoy