vkSumi

Разработчик под ником reakjra представил сообществу проект, который решает давнюю боль Linux-геймеров, привыкших к тонкой настройке изображения «на лету». vkSumi — это не просто очередной Vulkan-слой, а продуманная и удобная замена устаревшему vkBasalt.

Что умеет vkSumi?

Слой внедряется в любую Vulkan-игру (нативную или работающую через Proton/DXVK) и позволяет в реальном времени управлять следующими параметрами:

• Базовые: Яркость, контрастность, насыщенность (от 0 до обесцвечивания), экспозиция (в EV stop).
• Цветовые: Оттенок (hue, -180°...+180°), гамма (осветление средних тонов), цветовая температура (теплее/холоднее), тинт (маджента/зелёный).
• Поканальные усиления: Отдельно для красного, зелёного и синего каналов (RGB gain).
• Трёхполосная коррекция: Раздельная настройка теней, средних тонов и светов (3-band lift/gain).

Важная особенность: Все параметры имеют значение «0 = без изменений», что упрощает чтение конфигурационных файлов и понимание того, какие именно настройки были применены.

Простота использования

vkSumi активируется только при установленной переменной окружения ENABLE_VKSUMI=1. Это позволяет легко включать и выключать слой для конкретных игр, не затрагивая остальные приложения.

Запуск нативных Vulkan-игр:

env ENABLE_VKSUMI=1 some-vulkan-game

Запуск игр в Steam (Proton/DXVK): В свойствах игры → Launch Options добавляется строка:

ENABLE_VKSUMI=1 %command%

Для экстренного отключения (например, если игра не запускается или работает некорректно) предусмотрена переменная DISABLE_VKSUMI=1, которая имеет приоритет над включением.

Гибкая настройка и горячая перезагрузка

Конфигурация хранится в текстовых файлах с простым синтаксисом:

• Глобальный конфиг: ~/.config/vkSumi/vkSumi.conf.
• Игровые конфиги: ~/.config/vkSumi/games/<exe-name>.conf (автоматически создаются при первом запуске игры).

Принцип работы: игровые настройки накладываются поверх глобальных, и вы указываете только те параметры, которые хотите изменить для конкретной игры.

«Горячая перезагрузка»: Вы можете редактировать конфигурационный файл прямо во время игры, сохранить его — и изменения применятся мгновенно. Никаких перезапусков!

Горячие клавиши (два способа)

1. Внутри слоя (через X11/XWayland): Подходит для Wine/Proton-игр. В конфиге прописывается комбинация клавиш, например:

toggle_keys = Shift_R+F9

При нажатии этой комбинации в окне игры слой включается/выключается.

2. Скрипт + биндинг в композиторе: Для окружений, где внутрислойный метод не работает (например, нативных Wayland-игр). Скрипт vksumi-toggle переключает параметр enabled в конфиге, а inotify-механизм ловит изменение и перезагружает настройки.

# Пример для Hyprland (~/.config/hypr/hyprland.conf) bind = SHIFT, F9, exec, vksumi-toggle

Известные ограничения

• HDR: Слой обнаруживает HDR-режим и пропускает кадры без изменений. Корректная цветокоррекция на PQ/scRGB потребует отдельного шейдерного пути — эта функция в разработке.
• Нативные Wayland-игры: Встроенные горячие клавиши не работают из-за ограничений Wayland (клиенты не могут перехватывать нажатия глобально). Используйте скриптовый метод через биндинги в композиторе.

Установка

vkSumi собирается из исходников с помощью Meson:

meson setup builddir --prefix="$HOME/.local" ninja -C builddir meson install -C builddir

Скрипт установки размещает .so в ~/.local/lib/, манифест слоя в ~/.local/share/vulkan/implicit_layer.d/, а скрипт переключения в ~/.local/bin/.

Для пользователей Arch Linux: пакет уже доступен в AUR:

yay -S vksumi

Отладка

Если что-то пошло не так, запустите слой с отладочным выводом:

ENABLE_VKSUMI=1 VKSUMI_DEBUG=1 some-game

Это выведет все вызовы Vulkan-слоя в stderr.

Лицензия и благодарности

Проект распространяется под лицензией MIT. Архитектура vkSumi основана на кодовой базе vkBasalt (покойся с миром), а реализация некоторых сложных моментов была подсмотрена в коде MangoHud.

vkSumi — это именно тот инструмент, которого так не хватало Linux-геймерам для быстрой и удобной настройки изображения «на лету». Простой, лёгкий, без лишних зависимостей и с горячей перезагрузкой конфигов. Автор активно развивает проект — последний релиз 0.0.6 вышел 20 мая 2026 года. Если вы любите подкрутить цвета в играх, обязательно попробуйте vkSumi.

Ссылка на проект: GitHub – reakjra/vkSumi.