Skip to main content

A collection of Qt style sheets and helpful classes for applying them.

Project description

[![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)


Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

qtstyles-0.0.2-py3-none-any.whl (103.3 kB view details)

Uploaded Python 3

qtstyles-0.0.2-py2-none-any.whl (103.3 kB view details)

Uploaded Python 2

File details

Details for the file qtstyles-0.0.2-py3-none-any.whl.

File metadata

File hashes

Hashes for qtstyles-0.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 0531cdf34fe9bcd320285885e2d032e56f398bf4468f405573ab7abe5d922d23
MD5 5292115820d5d7c1cf7f1d2e41f4bc2a
BLAKE2b-256 65d25835a2f9c0d63165512a1da4a1242f5ea0f2613d009717115a0de96d6321

See more details on using hashes here.

File details

Details for the file qtstyles-0.0.2-py2-none-any.whl.

File metadata

File hashes

Hashes for qtstyles-0.0.2-py2-none-any.whl
Algorithm Hash digest
SHA256 a78e787d91561e834d9809890ce8024f452bddb8e4751e8f7e8060c623855a3d
MD5 e8465007fc72a2e67c83de402be291ff
BLAKE2b-256 76744d7b9ff0b6d5085ac13d33e181ecca0eb3fad5ec91d62384d842bf8c5532

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page