How to use PyQtDarkTheme

Apply dark theme to your Application

PyQtDarkTheme applies a flat theme to your Qt applications using Qt stylesheets system.

1. PySide6

   import sys
   
   from PySide6.QtWidgets import QApplication, QMainWindow, QPushButton
   
   import qdarktheme
   
   app = QApplication(sys.argv)
   main_win = QMainWindow()
   push_button = QPushButton("PyQtDarkTheme!!")
   main_win.setCentralWidget(push_button)
   
   # Apply dark theme
   app.setStyleSheet(qdarktheme.load_stylesheet())
   
   main_win.show()
   
   app.exec()
   

2. PyQt6

   import sys
   
   from PyQt6.QtWidgets import QApplication, QMainWindow, QPushButton
   
   import qdarktheme
   
   app = QApplication(sys.argv)
   main_win = QMainWindow()
   push_button = QPushButton("PyQtDarkTheme!!")
   main_win.setCentralWidget(push_button)
   
   # Apply dark theme
   app.setStyleSheet(qdarktheme.load_stylesheet())
   
   main_win.show()
   
   app.exec()
   

3. PySide2

   import sys
   
   from PyQt5.QtWidgets import QApplication, QMainWindow, QPushButton
   
   import qdarktheme
   
   app = QApplication(sys.argv)
   main_win = QMainWindow()
   push_button = QPushButton("PyQtDarkTheme!!")
   main_win.setCentralWidget(push_button)
   
   # Apply dark theme
   app.setStyleSheet(qdarktheme.load_stylesheet())
   
   main_win.show()
   
   app.exec_()
   

4. PyQt5

   import sys
   
   from PyQt5.QtWidgets import QApplication, QMainWindow, QPushButton
   
   import qdarktheme
   
   app = QApplication(sys.argv)
   main_win = QMainWindow()
   push_button = QPushButton("PyQtDarkTheme!!")
   main_win.setCentralWidget(push_button)
   
   # Apply dark theme
   app.setStyleSheet(qdarktheme.load_stylesheet())
   
   main_win.show()
   
   app.exec()
   

5. pyqtgraph

   import pyqtgraph as pg
   from pyqtgraph.Qt.QtGui import QMainWindow, QPushButton
   
   import qdarktheme
   
   app = pg.mkQApp()
   main_win = QMainWindow()
   push_button = QPushButton("PyQtDarkTheme!!")
   main_win.setCentralWidget(push_button)
   
   # Apply dark theme
   app.setStyleSheet(qdarktheme.load_stylesheet())
   
   main_win.show()
   
   pg.exec()
   

Toggle dark/light Theme

You can easily switch between light and dark theme.

import sys

from PyQt6.QtCore import pyqtSlot
from PyQt6.QtWidgets import QApplication, QComboBox, QHBoxLayout, QMainWindow, QWidget

import qdarktheme

app = QApplication(sys.argv)
main_win = QMainWindow()
combobox = QComboBox()


@pyqtSlot(str)
def toggle_theme(theme) -> None:
    stylesheet = qdarktheme.load_stylesheet(theme)
    QApplication.instance().setStyleSheet(stylesheet)


combobox.addItems(qdarktheme.get_themes())
combobox.currentTextChanged.connect(toggle_theme)

layout = QHBoxLayout()
layout.addWidget(combobox)

central_widget = QWidget()
central_widget.setLayout(layout)
main_win.setCentralWidget(central_widget)

# Apply dark theme
app.setStyleSheet(qdarktheme.load_stylesheet())

main_win.show()

app.exec()

On some operating systems we can detect if a dark or light mode is selected system-wide. By using darkdetect, You can easily sync your application theme with this operating system theme.

import sys

import darkdetect
from PySide6.QtCore import Slot
from PySide6.QtWidgets import QApplication, QLabel, QMainWindow

import qdarktheme

app = QApplication(sys.argv)
main_win = QMainWindow()
theme_label = QLabel()

main_win.setCentralWidget(theme_label)


@Slot()
def sync_theme_with_system() -> None:
    theme = darkdetect.theme().lower()
    theme_label.setText(f"Theme: {theme}")
    stylesheet = qdarktheme.load_stylesheet(theme)
    QApplication.instance().setStyleSheet(stylesheet)


app.paletteChanged.connect(sync_theme_with_system)
sync_theme_with_system()

main_win.show()

app.exec()

Toggle dark/light Theme with pyqtgraph

You can also switch between light and dark theme with pyqtgraph.

import sys

import pyqtgraph as pg
from PySide6.QtCore import Slot
from PySide6.QtWidgets import QApplication, QComboBox, QMainWindow, QVBoxLayout, QWidget

import qdarktheme

app = QApplication(sys.argv)
main_win = QMainWindow()
combobox = QComboBox()
plot_widget = pg.PlotWidget()


@Slot(str)
def toggle_theme(theme) -> None:
    stylesheet = qdarktheme.load_stylesheet(theme)
    QApplication.instance().setStyleSheet(stylesheet)
    plot_widget.setBackground("k" if theme == "dark" else "w")


combobox.addItems(qdarktheme.get_themes())
combobox.currentTextChanged.connect(toggle_theme)

layout = QVBoxLayout()
layout.addWidget(combobox)
layout.addWidget(plot_widget)

central_widget = QWidget()
central_widget.setLayout(layout)
main_win.setCentralWidget(central_widget)

# Apply dark theme
app.setStyleSheet(qdarktheme.load_stylesheet())

main_win.show()

app.exec()

previous

Installation Guide

next

API Reference