Skip to main content

Detect OS Dark Mode from Python

Project description

Darkdetect

This package allows to detect if the user is using Dark Mode on:

The main application of this package is to detect the Dark mode from your GUI Python application (Tkinter/wx/pyqt/qt for python (pyside)/...) and apply the needed adjustments to your interface. Darkdetect is particularly useful if your GUI library does not provide a public API for this detection (I am looking at you, Qt). In addition, this package does not depend on other modules or packages that are not already included in standard Python distributions.

Usage

import darkdetect

>>> darkdetect.theme()
'Dark'

>>> darkdetect.isDark()
True

>>> darkdetect.isLight()
False

It's that easy.

You can create a dark mode switch listener daemon thread with darkdetect.listener and pass a callback function. The function will be called with string "Dark" or "Light" when the OS switches the dark mode setting.

import threading
import darkdetect

# def listener(callback: typing.Callable[[str], None]) -> None: ...

t = threading.Thread(target=darkdetect.listener, args=(print,))
t.daemon = True
t.start()

On macOS it simply raises a NotImplementedError. PRs in this direction are more than welcome.

Install

The preferred channel is PyPI:

pip install darkdetect

Alternatively, you are free to vendor directly a copy of Darkdetect in your app. Further information on vendoring can be found here.

Notes

  • This software is licensed under the terms of the 3-clause BSD License.
  • This package can be installed on any operative system, but it will always return None unless executed on a OS that supports Dark Mode, including older versions of macOS and Windows.
  • On macOS, detection of the dark menu bar and dock option (available from macOS 10.10) is not supported.
  • Details on the detection method used on macOS.
  • Details on the experimental detection method used on Linux.

Download files

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

Source Distribution

darkdetect-0.6.0.tar.gz (6.5 kB view hashes)

Uploaded source

Built Distribution

darkdetect-0.6.0-py3-none-any.whl (7.8 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page