Tray Themer (ru.mos.traythemer)
Виджет и фоновый D-Bus прокси для KDE Plasma 6, который заменяет вшитые в бинарные приложения значки системного лотка (IconPixmap) на системные значки из текущей темы оформления (IconName).
Решает проблему приложений на Electron, Qt и проприетарных клиентов, которые игнорируют системную тему иконок и выглядят чужеродно на панели.
Как это работает
-
D-Bus Прокси (
StatusNotifierItem+DBusMenu): Создаёт нативный объектorg.kde.StatusNotifierItemсо значком из темы оформления и прозрачно проксирует клики, прокрутку и контекстное меню (com.canonical.dbusmenu) оригинальному процессу. -
Превентивное скрытие (
tray_hider): При включении виджета все известныеsni_idиз базы правил автоматически добавляются вhiddenItemsсистемного лотка Plasma 6, чтобы оригинальные значки не дублировались. - Независимость от DPI: Приложения отдают в D-Bus фиксированные растровые ассеты, MD5-хэш которых не меняется при масштабировании экрана (100%, 150%, 200%).
База правил и доступные методы
База поддерживаемых приложений ведётся в каталоге contents/scripts/apps.d/ в формате JSON. Чтобы добавить новое приложение - откройте задачу или пришлите запрос на слияние
Пользовательские правила можно локально размещать в ~/.config/ru.mos.traythemer/apps.d/ — они имеют приоритет над встроенными и не затираются при обновлении пакета.
Доступные методы определения состояния (detection.mode)
-
auto+normal_hash— для мессенджеров и программ с точкой уведомления. Сравнивает текущий MD5-хэш значка с эталонным хэшем спокойного состояния (normal_hash). При любом отклонении (включая запуск приложения с уже непрочитанными сообщениями), изменении D-Bus статуса (NeedsAttention) или появлении счётчиков в подсказке (ToolTip/Title) выставляет значокattention. -
hash_map— для программ с несколькими конкретными состояниями. Сопоставляет каждый MD5-хэш из словаряhashesсвоему значку из темы (например, для индикации режимов подключения и активности трафика VPN-клиентов). -
static— безусловная подмена значка на один фиксированный без отслеживания изменений.
Зависимости
Для работы виджета в системе требуются:
plasma6-workspaceplasma6-plasma5support-
kf6-kconfig(kreadconfig6,kwriteconfig6) -
glib2.0-common(gdbus) -
procps-ng(pkill) hicolor-icon-theme-
python3,python3-dbus,python3-gi
Установка из исходников
git clone https://hub.mos.ru/mos/src/kde/plasma6-applet-traythemer
cd plasma6-applet-traythemer
kpackagetool6 --type Plasma/Applet --install .
install -Dm0644 contents/icons/ru.mos.traythemer.svg ~/.local/share/icons/hicolor/scalable/apps/ru.mos.traythemer.svg
Обновление установленного виджета:
kpackagetool6 --type Plasma/Applet --upgrade .
После установки добавьте Tray Themer на панель и нажмите «Рестарт Plasma» в окне виджета для применения скрытия оригинальных значков.
Отладка и добавление новых приложений
- Создайте заготовку правила в
~/.config/ru.mos.traythemer/apps.d/myapp.json, указав имя процесса (process_name) или путь запуска (cmdline_contains), чтобы демон перехватил приложение. - Остановите фоновый процесс и запустите демон в режиме отладки:
pkill -f "[d]aemon.py"
python3 /usr/share/plasma/plasmoids/ru.mos.traythemer/contents/scripts/daemon.py --debug
(Для локальной установки из исходников путь к скрипту: ~/.local/share/plasma/plasmoids/ru.mos.traythemer/contents/scripts/daemon.py).
- В консоли отобразятся точный
sni_id, подсказки (tooltip) и MD5-хэши значка при смене состояний приложения. Впишите их в правило (normal_hashилиhashes) и отправьте MR в репозиторий.
Лицензия
GPL-3.0