---
id: qt-material
version: "2.17"
license: BSD-2-Clause
license_treatment: permissive
maintenance: aging
---

# qt-material — Material inspired stylesheet for PySide6 and PyQt6.

License: permissive · Maintenance: aging · Downloads: 124.5K/mo

## What it is and what it does

Qt-Material is a stylesheet package that brings Material Design aesthetics to applications using PySide6 and PyQt6. It ships with pre-built dark and light themes and lets you apply them to your entire application with a single function call. The package depends only on Jinja2 and works as a pure Python wheel, making it lightweight to install.

Beyond the built-in themes, you can customize colors, fonts, button accent colors, and CSS properties either at startup or at runtime. The package supports theme switching mid-application, exporting themes to standalone QSS files for use in non-Python Qt projects, and creating entirely new themes through an interactive editor. Environment variables expose the current theme's colors for programmatic access.

Use it for:

- Apply a consistent Material Design look to a desktop application without writing custom stylesheets.
- Switch between dark and light themes at runtime based on user preference or system settings.
- Create a custom theme using Material Design colors and export it as a standalone QSS file.
- Add accent colors (danger, warning, success) to buttons and other widgets by setting class properties.
- Extend a built-in theme with custom CSS overrides for application-specific styling needs.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Applies a Material Design stylesheet to PySide6 and PyQt6 applications, providing pre-built dark and light themes with customizable colors and fonts.

Yes, if you are building a PySide6 or PyQt6 application and want Material Design styling without writing stylesheets from scratch. The package is stable, permissively licensed, and has low install friction. The aging maintenance status (480 days since last release) is a minor concern but not a blocker—the codebase is mature and the repository remains active. No known security vulnerabilities.

## Install

pip install qt-material
uv add qt-material
poetry add qt-material

## Installing qt-material

Before you install: Low install friction; pure Python wheel with only Jinja2 as a runtime dependency. Maintenance is aging—last release was 480 days ago, though the repository remains active with recent commits.

License in practice: BSD-2-Clause is permissive; you can use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.

Quickstart:

pip install qt-material

from qt_material import apply_stylesheet, list_themes

themes = list_themes()
apply_stylesheet(app, theme='dark_teal.xml')

Requires PySide6, PyQt6, or PyQt5 to be installed separately; qt_material must be imported after the Qt framework.

Verify before relying:

- Exact count of pre-built themes available in the package.
- Whether runtime theme switching (QtStyleTools) works reliably across all supported Qt versions.
- Performance impact of applying stylesheets to large, complex UIs.
- Compatibility with custom Qt plugins or extensions beyond standard widgets.

## Package facts

- License: BSD-2-Clause (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 124.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

pyside6 material design theme, pyqt6 stylesheet material, qt dark theme, material design qt, pyside6 styling, qt custom stylesheet, pyqt6 ui theme, ui-theming, material-design, qt-stylesheet

[View on SkillFed](https://skillfed.io/packages/qt-material) · [View on PyPI](https://pypi.org/project/qt-material/)