Plasma Tray Icon Replacer

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

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


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

  1. Запуск до оболочки (systemd): Юнит plasma-tray-icon-replacer.service стартует в пользовательской сессии строго до plasma-plasmashell.service, заранее вписывая sni_id из базы правил в disabledStatusNotifiers системного лотка. Благодаря этому оригинальные значки не появляются и не дублируются при запуске сессии.
  2. D-Bus Прокси (StatusNotifierItem + DBusMenu): Создаёт нативный объект org.kde.StatusNotifierItem со значком из темы оформления и прозрачно проксирует клики, прокрутку и контекстное меню (com.canonical.dbusmenu) оригинальному процессу.
  3. Независимость от DPI: Приложения отдают в D-Bus фиксированные растровые ассеты, MD5-хэш которых не меняется при масштабировании экрана (100%, 150%, 200%).

База правил и доступные методы

База поддерживаемых приложений ведётся в каталоге apps.d/ в формате JSON. Чтобы добавить новое приложение, откройте задачу (Issue) или пришлите запрос на слияние (MR)

Пользовательские правила можно локально размещать в ~/.config/plasma-tray-icon-replacer/apps.d/ — они имеют приоритет над встроенными и не затираются при обновлении пакета.

Доступные методы определения состояния (detection.mode)

  • auto + normal_hash — для мессенджеров и программ с точкой уведомления. Сравнивает текущий MD5-хэш значка с эталонным хэшем спокойного состояния (normal_hash). При любом отклонении (включая запуск приложения с уже непрочитанными сообщениями), изменении D-Bus статуса (NeedsAttention) или появлении счётчиков в подсказке (ToolTip/Title) выставляет значок attention.
  • hash_map — для программ с несколькими конкретными состояниями. Сопоставляет каждый MD5-хэш из словаря hashes своему значку из темы (например, для индикации режимов подключения и активности трафика VPN-клиентов).
  • static — безусловная подмена значка на один фиксированный без отслеживания изменений.

Зависимости

Для работы сервиса в системе требуются:

  • plasma6-workspace
  • kf6-kconfig (kreadconfig6, kwriteconfig6)
  • python3, python3-dbus, python3-gi
  • systemd
  • make (для установки из исходников)

Установка и удаление

Установка из исходников

git clone https://hub.mos.ru/mos/src/kde/plasma-tray-icon-replacer
cd plasma-tray-icon-replacer
sudo make install

systemctl --user daemon-reload
systemctl --user enable --now plasma-tray-icon-replacer.service

(Для применения скрытия значков в уже запущенной сессии перезапустите plasmashell).

Отключение и удаление

Чтобы остановить сервис, вернуть стандартные значки приложений в системный лоток и удалить файлы:

systemctl --user disable --now plasma-tray-icon-replacer.service
plasma-tray-icon-replacer --restore
sudo make uninstall

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

  1. Создайте заготовку правила в ~/.config/plasma-tray-icon-replacer/apps.d/myapp.json, указав имя процесса (process_name) или часть команды запуска (cmdline_contains), чтобы демон перехватил приложение.
  2. Остановите фоновый сервис и запустите демон вручную в режиме отладки:
systemctl --user stop plasma-tray-icon-replacer.service
plasma-tray-icon-replacer --debug
  1. В консоли отобразятся точный sni_id, подсказки (tooltip) и MD5-хэши значка при смене состояний приложения. Впишите их в правило (normal_hash или hashes), запустите сервис обратно (systemctl --user start plasma-tray-icon-replacer.service) и отправьте MR в репозиторий.

Лицензия

GPL-3.0