PyQtDarkTheme

Dark theme for PySide, PyQt and Qt Designer.

This python module applies a theme to a Qt applications(PySide6, PyQt6, PyQt5 and PySide2) using a qt stylesheets system.
There's a Light Theme too. Color and style balanced from the Dark theme for easy viewing in daylight.

Dark Theme

Light Theme

Requirements

• Python 3.7+
• PySide6, PyQt6, PyQt5 or PySide2

Installation Method

From PyPi

• Last released version

  pip install pyqtdarktheme
  

• Latest development version

  pip install git+https://github.com/5yutan5/PyQtDarkTheme
  

From conda

• Last released version

  conda install -c qt_theme pyqtdarktheme
  

Usage

import sys

import qdarktheme
from PySide6.QtWidgets import QApplication, QMainWindow, QPushButton

app = QApplication(sys.argv)
main_win = QMainWindow()
push_button = QPushButton("PyQtDarkTheme!!")
main_win.setCentralWidget(push_button)

app.setStyleSheet(qdarktheme.load_stylesheet())

main_win.show()

app.exec()

⚠ The quality of image may be low on Qt5(PyQt5, PySide2) due to the use of svg. You can add the following attribute to improve the quality of images.

app.setAttribute(Qt.ApplicationAttribute.AA_UseHighDpiPixmaps)

Light theme

app.setStyleSheet(qdarktheme.load_stylesheet("light"))

Check common widgets

Input the following command in a terminal to check common widgets.

python -m qdarktheme.examples.widget_gallery

Custom Properties

This module provides several custom properties.
You can use setProperty() of the widget object to apply a modern style.

For example, if you set the QToolbar type property to sidebar, the style for the sidebar will be applied.

sidebar = QToolBar()
sidebar.setProperty("type", "sidebar")

Support Qt Designer

This module support Qt Designer.

How to use PyQtDarktheme with Qt Designer.

1. Run the following command in the terminal to launch the app that creates the template for the designer.

   python -m qdarktheme.designer_supporter
   

2. Select a theme(dark or light) and press the Create button to create a template in any folder.
3. Copy the style sheet displayed in the text box.
4. Start Qt designer and save the ui file in the root of the template you created.
5. Paste the copied stylesheet into the top-level widget.
6. Register the resource file(.qrc) in the template to the resource browser.

⚠ Support for Qt’s resource system has been removed in PyQt6. Therefore, if you want to use Qt Designer in PyQt6, you need to delete the stylesheet in the ui file and load the stylesheet using load_stylesheet().

License

The icons used in the demo code are sourced from the Material design icons(Apache License Version 2.0).
Any file not listed the NOTICE.md file is covered by PyQtDarkTheme's MIT license.