Skip to main content
[![Build Status](https://travis-ci.org/simongarisch/qtstyles.svg?branch=master)](https://travis-ci.org/simongarisch/qtstyles)
[![Coverage Status](https://coveralls.io/repos/github/simongarisch/qtstyles/badge.svg?branch=master&service=github)](https://coveralls.io/github/simongarisch/qtstyles?branch=master)
[![PyPI version](https://badge.fury.io/py/qtstyles.svg)](https://badge.fury.io/py/qtstyles)

# qtstyles
A collection of Qt Style Sheets accompanied by useful classes.

## Installation
qtstyles is python 2 and 3 compatible.
```bash
pip install qtstyles
```

## Overview

Provided are **Two ways** to change your Qt application style sheet:

## 1. With the StylePicker class

View available styles with:
```python
from qtstyles import StylePicker

StylePicker().available_styles
```

And change the Qt application style using the get_sheet() method:
```python
from qtpy import QtWidgets
from qtstyles import StylePicker

app = QtWidgets.QApplication([])
win = QtWidgets.QMainWindow()
app.setStyleSheet(StylePicker("qdark").get_sheet()) # <-- changing the style here
win.show()
app.exec_()
```

## 2. We can also change the style sheet with an instance of StylePickerWidget (inherits from QComboBox)
```python
from qtpy import QtWidgets
from qtstyles import StylePickerWidget

app = QtWidgets.QApplication([])
win = QtWidgets.QMainWindow()
picker_widget = StylePickerWidget() # <-- this QComboBox allows the user to change style sheets
win.setCentralWidget(picker_widget)
win.show()
app.exec_()
```

See the 'Overview Notebook.ipynb' for additional details.

## Motivation
When looking for Qt ('.qss') style sheets most were scattered across different sites.
Disclaimer: I've collected these style sheets from different repositories and they are not my own work.
Attribution, links and the associated licenses have been provided at the top of each qss file.
If you'd like to add a style sheet please create a pull request and I'll be happy to take a look.

## What does it look like
The StylePickerWidget is in the bottom left hand side of this window:
![qstyles demo](https://github.com/simongarisch/qtstyles/blob/master/demo.PNG?raw=true)


Metadata

Release files for qtstyles 0.0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for qtstyles 0.0.2
File Interpreter ABI Platform Actions
qtstyles-0.0.2-py3-none-any.whl Python 3 none any Details for qtstyles-0.0.2-py3-none-any.whl
qtstyles-0.0.2-py2-none-any.whl Python 2 none any Details for qtstyles-0.0.2-py2-none-any.whl

Total release size: 206.6 kB

Release files / qtstyles-0.0.2-py3-none-any.whl

Download URL qtstyles-0.0.2-py3-none-any.whl
Size 103.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
0531cdf34fe9bcd320285885e2d032e56f398bf4468f405573ab7abe5d922d23
BLAKE2b-256 checksum
How to use checksums
65d25835a2f9c0d63165512a1da4a1242f5ea0f2613d009717115a0de96d6321
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / qtstyles-0.0.2-py2-none-any.whl

Download URL qtstyles-0.0.2-py2-none-any.whl
Size 103.3 kB
Tags Python 2
SHA-256 checksum
How to use checksums
a78e787d91561e834d9809890ce8024f452bddb8e4751e8f7e8060c623855a3d
BLAKE2b-256 checksum
How to use checksums
76744d7b9ff0b6d5085ac13d33e181ecca0eb3fad5ec91d62384d842bf8c5532
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for qtstyles 0.0.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.0.2 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page