PyQtDarkTheme applies a flat dark theme to QtWidgets application(PySide and PyQt). There's a light theme too. Color and style balanced from a dark theme for easy viewing in daylight.
Check out the complete documentation.
Project status
Tests
- A flat dark and light theme
- Support PySide and PyQt
- Support PyInstaller
- Sync with OS's theme (Mac, Windows, Linux)
- Resolve the style differences between Qt versions
- Provide dark/light theme QPalette
- Override Qt old standard icons
- Python 3.7+
- Qt 5.15+
- PySide6, PyQt6, PyQt5 or PySide2
-
Last released version
pip install pyqtdarktheme -
Latest development version
pip install git+https://github.com/5yutan5/PyQtDarkTheme.git@main
import sys
from PySide6.QtWidgets import QApplication, QMainWindow, QPushButton
import qdarktheme
app = QApplication(sys.argv)
# Apply the complete dark theme to your Qt App.
qdarktheme.setup_theme()
main_win = QMainWindow()
push_button = QPushButton("PyQtDarkTheme!!")
main_win.setCentralWidget(push_button)
main_win.show()
app.exec()Further information can be found in our docs:
# enable_hi_dpi() must be called before instantiation of QApplication.
qdarktheme.enable_hi_dpi()
app = QApplication(sys.argv)
qdarktheme.setup_theme()For Qt6 bindings, HiDPI “just works” without using this function.
qdarktheme.setup_theme("light")qdarktheme.setup_theme("auto")
You can customize theme color.
# Customize accent color.
qdarktheme.setup_theme(custom_colors={"primary": "#D0BCFF"})Further information for customizing color can be found in our theme color docs:
You can change the corner style.
# Default is "rounded".
stylesheet = qdarktheme.setup_theme(corner_shape="sharp")You can also only load QPalette and stylesheet. qdarktheme.setup_theme uses following functions internally.
palette = qdarktheme.load_palette(theme="dark")
stylesheet = qdarktheme.load_stylesheet(theme="dark")To check all Qt widgets, run:
python -m qdarktheme.widget_gallery
The svg files for the PyQtDarkTheme are derived Material design icons(Apache License Version 2.0). Qt stylesheets are originally fork of QDarkStyleSheet(MIT License). Other files are covered by PyQtDarkTheme's MIT license.
All contributions, bug reports, bug fixes, documentation improvements, enhancements, and ideas are welcome. You can get started by reading this:
See Releases.