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 hashes)

Uploaded Python 3

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

Uploaded Python 2

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