Plasma Tray Icon Replacer
Фоновый D-Bus сервис для KDE Plasma 6, который заменяет вшитые в бинарные приложения значки системного лотка (IconPixmap) на системные значки из текущей темы оформления (IconName).
Решает проблему приложений на Electron, Qt и проприетарных клиентов, которые игнорируют системную тему иконок и выглядят чужеродно на панели.
Как это работает
-
Запуск до оболочки (
systemd): Юнитplasma-tray-icon-replacer.serviceстартует в пользовательской сессии строго доplasma-plasmashell.service, заранее вписываяsni_idиз базы правил вdisabledStatusNotifiersсистемного лотка. Благодаря этому оригинальные значки не появляются и не дублируются при запуске сессии. -
D-Bus Прокси (
StatusNotifierItem+DBusMenu): Создаёт нативный объектorg.kde.StatusNotifierItemсо значком из темы оформления и прозрачно проксирует клики, прокрутку и контекстное меню (com.canonical.dbusmenu) оригинальному процессу. - Независимость от 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
Отладка и добавление новых приложений
- Создайте заготовку правила в
~/.config/plasma-tray-icon-replacer/apps.d/myapp.json, указав имя процесса (process_name) или часть команды запуска (cmdline_contains), чтобы демон перехватил приложение. - Остановите фоновый сервис и запустите демон вручную в режиме отладки:
systemctl --user stop plasma-tray-icon-replacer.service
plasma-tray-icon-replacer --debug
- В консоли отобразятся точный
sni_id, подсказки (tooltip) и MD5-хэши значка при смене состояний приложения. Впишите их в правило (normal_hashилиhashes), запустите сервис обратно (systemctl --user start plasma-tray-icon-replacer.service) и отправьте MR в репозиторий.
Лицензия
GPL-3.0