Darkdetect

此软件包允许检测用户是否在

• macOS 10.14+
• Windows 10 1607+
• Linux使用深色GTK主题。

此软件包的主要应用是从您的GUI Python应用程序（Tkinter/wx/pyqt/qt for python (pyside)/...）检测深色模式，并对您的界面进行必要的调整。Darkdetect特别有用，如果您的GUI库没有提供公共API进行此检测（我在看着你，Qt）。此外，此软件包不依赖于标准Python发行版中未包含的其他模块或软件包。

用法

import darkdetect

>>> darkdetect.theme()
'Dark'

>>> darkdetect.isDark()
True

>>> darkdetect.isLight()
False

非常简单。

您可以使用darkdetect.listener创建一个深色模式切换监听器守护线程，并传递一个回调函数。当操作系统切换深色模式设置时，该函数将以字符串“Dark”或“Light”调用。

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

安装

首选渠道是PyPI

pip install darkdetect

或者，您可以直接在您的应用程序中提供Darkdetect的副本。有关供应商的更多信息，请参阅此处。

可选安装

要启用macOS监听器，需要额外的组件，这些可以通过以下方式安装

pip install darkdetect[macos-listener]

注释

• 此软件按照3条款BSD许可证的条款进行许可。
• 此软件包可在任何操作系统上安装，但除非在支持暗黑模式的操作系统上执行，包括较旧的macOS和Windows版本，否则它总是会返回None。
• 在macOS上，不支持检测暗黑模式菜单栏和坞栏选项（从macOS 10.10开始提供）。
• 关于macOS上使用的检测方法的详细信息。
• 关于Linux上使用的实验性检测方法的详细信息。