Debian Codegraph @

/

0 files · 0 symbols
README (full)

QDarkStyleSheet

The most complete dark/light style sheet for Qt applications (Qt4*, Qt5, PySide, PySide2, PySide6, PyQt4, PyQt5, PyQt6, QtPy, PyQtGraph, Qt.Py) for Python 2*/3 and C++.

Check out the complete documentation._

What is new?

Version 3

In the current version 3, `qdarkstyle` is now working as a theme framework, currently for dark/light themes, keeping styled widgets identical throughout theme colors.

The palette has been redefined and improved (UI/UX) to accept more colors and to be able to implement new themes thanks to the Spyder team_ collaboration.

The current stable version is using Python 3 (preferable 3.6+) and Qt5 (PyQt5 and PySide 2). Also in this version, an option for Qt6 (PyQt6, PySide6) was added.

The current version for use with Qt6 may still present instabilities.

[*] Python 2, as well as Qt4 (PyQt4 and PySide), will not be supported anymore. They are still there as it is, but no back compatibility, fixes, nor features will be implemented.

Version 2

We moved to QtPy to simplify your code in v2.8, thus this is a required dependency now. We included special patches in three main categories: operating system, Qt/binding version, application.

Included in that, lots of widgets' styles were included/fixed. A Qt application example (Python only) with almost all types of widgets and combinations were included to serve as a portfolio and a checklist for new styles.

We have added SCSS in v2.7, so the palette can be accessed programmatically. Also, many scripts were added to give freedom to developers who want to change the colors of our palette. All images and icons were revised, also creating SVG files for all of them.

In version 2.6 and later, a restructure stylesheet is provided. The palette has only 9 colors. Most widgets are revised and their styles were improved. We also provide a command line (script) to get info that could be used when opening issues. See the image below.

Version 1

First stable release of QDarkStyle.

Installation

Python

From PyPI: Get the latest stable version of qdarkstyle package using pip (preferable):

 pip install qdarkstyle

From code: Download/clone the project, go to qdarkstyle folder then:

  • You can use the setup script and pip install.

    .. code:: bash

    pip install .

  • Or, you can use the setup script with Python:

    .. code:: bash

    python setup.py install

C++

  • Download/clone the project and copy the following files to your

    application directory (keep the existing directory hierarchy). Substitute the all the THEME words by the currently available (dark/light) the theme you need to use.

    - qdarkstyle/THEME/THEMEstyle.qss - qdarkstyle/THEME/THEMEstyle.qrc - qdarkstyle/THEME/rc/ (the whole directory)

  • Add qdarkstyle/THEME/THEMEstyle.qrc to your .pro file as follows:

    .. code:: c++

    RESOURCES += qdarkstyle/THEME/THEMEstyle.qrc

  • Load the stylesheet:

    .. code:: c++

    QFile f(":qdarkstyle/THEME/THEMEstyle.qss");

    if (!f.exists()) { printf("Unable to set stylesheet, file not found\n"); } else { f.open(QFile::ReadOnly | QFile::Text); QTextStream ts(&f); qApp->setStyleSheet(ts.readAll()); }

Note: The ":" in the file name is necessary to define that file as a resource library. For more information see the discussion here_.

Usage in applications

If your project already uses QtPy or you need to set it programmatically, it is far more simple

 import sys
 import qdarkstyle
 import os

 # set the environment variable to use a specific wrapper
 # it can be set to pyqt, pyqt5, pyside or pyside2 (not implemented yet)
 # you do not need to use QtPy to set this variable
 os.environ['QT_API'] = 'pyqt5'

 # import from QtPy instead of doing it directly
 # note that QtPy always uses PyQt5 API
 from qtpy import QtWidgets

 # create the application and the main window
 app = QtWidgets.QApplication(sys.argv)
 window = QtWidgets.QMainWindow()

 # setup stylesheet
 # the default system in qdarkstyle uses qtpy environment variable
 app.setStyleSheet(qdarkstyle.load_stylesheet())

 # run
 window.show()
 app.exec_()

If you are using PyQt5 directly, see the complete example

 import sys
 import qdarkstyle
 from PyQt5 import QtWidgets

 # create the application and the main window
 app = QtWidgets.QApplication(sys.argv)
 window = QtWidgets.QMainWindow()

 # setup stylesheet
 app.setStyleSheet(qdarkstyle.load_stylesheet_pyqt5())
 # or in new API
 app.setStyleSheet(qdarkstyle.load_stylesheet(qt_api='pyqt5'))

 # run
 window.show()
 app.exec_()

Here is an example using PySide2

 import sys
 import qdarkstyle
 from PySide2 import QtWidgets

 # create the application and the main window
 app = QtWidgets.QApplication(sys.argv)
 window = QtWidgets.QMainWindow()

 # setup stylesheet
 app.setStyleSheet(qdarkstyle.load_stylesheet_pyside2())
 # or in new API
 app.setStyleSheet(qdarkstyle.load_stylesheet(qt_api='pyside2'))

 # run
 window.show()
 app.exec_()

If you use PyQtGraph, then the code is

 import sys
 import qdarkstyle
 import os

 # set the environment variable to use a specific wrapper
 # it can be set to PyQt, PyQt5, PySide or PySide2 (not implemented yet)
 os.environ['PYQTGRAPH_QT_LIB'] = 'PyQt5'

 # import from pyqtgraph instead of doing it directly
 # note that PyQtGraph always uses PyQt4 API
 from pyqtgraph.Qt import QtGui

 # create the application and the main window
 app = QtGui.QApplication(sys.argv)
 window = QtGui.QMainWindow()

 # setup stylesheet
 app.setStyleSheet(qdarkstyle.load_stylesheet(qt_api=os.environ['PYQTGRAPH_QT_LIB'])

 # run
 window.show()
 app.exec_()

If you are using Qt.py, which is different from qtpy, you should install qtpy then set both to the same binding.

Usage of example/portfolio

There is an example included in the package. You only need to have PySide2 or PyQt5 is installed on your system.

 # dark theme example
 $ qdarkstyle.example --palette=dark

 # light theme example
 $ qdarkstyle.example --palette=light

 # no theme/style sheet applied
 $ qdarkstyle.example --palette=none

 # check all options included
 $ qdarkstyle.example --help

Changelog

Please, see CHANGES_ file.

License

This project is licensed under the MIT license. Images contained in this project is licensed under CC-BY license.

For more information see LICENSE_ file.

Authors

For more information see AUTHORS_ file.

Contributing

Most widgets have been styled. If you find a widget that has not been style, just open an issue on the issue tracker or, better, submit a pull request.

If you want to contribute, see CONTRIBUTING_ file.

dir .github/
dir debian/
dir qdarkstyle/
dir scripts/
dir test/
file .gitattributes
file .gitignore
file .travis.yml
file AUTHORS.rst
file CHANGES.rst
file CODE_OF_CONDUCT.rst
file CONTRIBUTING.rst
file LICENSE.rst
file MANIFEST.in
file PKGBUILD
file README.rst
file makeppa.sh
file pylint.ini
file req-develop.txt
file req-doc.txt
file req-release.txt
file req-stable.txt
file req-test.txt
file ruff.toml
file setup.cfg
file setup.py
file stdeb.cfg
file tox.ini