QDarkStyle

What it is and what it does

QDarkStyle is a stylesheet library that applies professionally designed dark and light themes to Qt applications. It abstracts away the complexity of loading stylesheets across different Qt bindings and wrapper libraries, providing functions to retrieve the appropriate stylesheet for your binding, which you then pass to your application's setStyleSheet() method.

The library is mature and widely adopted (3081 GitHub stars, 243635 monthly downloads), but maintenance is aging—the last release was in November 2023. It carries no known security vulnerabilities and has a permissive MIT license. Its single runtime dependency is qtpy, keeping installation friction low. Python 2 and Qt4 support have been formally deprecated, though the code remains in place.

Use it for:

• Apply a dark theme to a desktop application without writing custom stylesheets.
• Build a cross-platform Qt application that maintains consistent styling across multiple Qt bindings.
• Quickly prototype a GUI application with a professional dark mode appearance.
• Switch between dark and light themes by loading different stylesheets via load_stylesheet functions.
• Use QtPy's environment-based Qt binding detection to automatically load the correct stylesheet.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

QDarkStyle provides pre-built dark and light stylesheets for Qt applications across multiple Python Qt bindings and wrapper libraries, with a single function call to load the appropriate stylesheet.

Yes, if you are building a Qt application and want a polished dark or light theme without custom stylesheet work. The package is stable, widely used, and carries no security issues. The aging maintenance (last release 990 days ago) is a minor concern for new features but not a blocker for theme application. Install it if your project uses a Qt binding; skip it if you prefer full control over styling or are using a non-Qt framework.

Install

qdarkstyle on PyPI

pip install qdarkstyle

uv add qdarkstyle

poetry add qdarkstyle

Installing QDarkStyle

Before you install

Low install friction with a single runtime dependency (qtpy). Maintenance status is aging—last release was 2023-11-28, over 990 days ago—but the repository remains active and unarchived with 3081 stars, suggesting the package is stable and widely used despite infrequent updates.

License in practice

MIT license is permissive, allowing use in commercial and proprietary projects with minimal restrictions; you must include a copy of the license but face no copyleft obligations.

Quickstart

pip install qdarkstyle

import qdarkstyle

dark_stylesheet = qdarkstyle.load_stylesheet()
# Then pass to your Qt application's setStyleSheet() method

Requires a Qt binding (PyQt5, PyQt6, PySide2, or PySide6) to be installed separately; QDarkStyle itself does not bundle Qt.

Verify before relying

• Whether the package actively maintains compatibility with the latest PyQt6 and PySide6 releases given the aging maintenance status.
• Whether light theme support is as complete and well-maintained as dark theme support.

Package facts

Evidence: QDarkStyle-3.2.3-py2.py3-none-any.whl

Tags

More Application Frameworks packages