Tray Themer (ru.mos.traythemer)

Виджет и фоновый D-Bus прокси для KDE Plasma 6, который заменяет вшитые в бинарные приложения значки системного лотка (IconPixmap) на системные значки из текущей темы оформления (IconName).

Решает проблему приложений на Electron, Qt и проприетарных клиентов, которые игнорируют системную тему иконок и выглядят чужеродно на панели.


Как это работает

  1. D-Bus Прокси (StatusNotifierItem + DBusMenu): Создаёт нативный объект org.kde.StatusNotifierItem со значком из темы оформления и прозрачно проксирует клики, прокрутку и контекстное меню (com.canonical.dbusmenu) оригинальному процессу.
  2. Превентивное скрытие (tray_hider): При включении виджета все известные sni_id из базы правил автоматически добавляются в hiddenItems системного лотка Plasma 6, чтобы оригинальные значки не дублировались.
  3. Независимость от 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-workspace
  • plasma6-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» в окне виджета для применения скрытия оригинальных значков.


Отладка и добавление новых приложений

  1. Создайте заготовку правила в ~/.config/ru.mos.traythemer/apps.d/myapp.json, указав имя процесса (process_name) или путь запуска (cmdline_contains), чтобы демон перехватил приложение.
  2. Остановите фоновый процесс и запустите демон в режиме отладки:
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).

  1. В консоли отобразятся точный sni_id, подсказки (tooltip) и MD5-хэши значка при смене состояний приложения. Впишите их в правило (normal_hash или hashes) и отправьте MR в репозиторий.

Лицензия

GPL-3.0