Goverlay — графическая оболочка для MangoHud и vkBasalt. Сама по себе она не ускоряет игры и не заменяет драйверы: программа даёт окно с галочками и полями, а результат записывает в стандартные конфиги MangoHud и vkBasalt. Тем, кто устал править десятки строк вручную и хочет видеть, как оверлей выглядит, это экономит вечер настройки.
Что именно делает Goverlay
MangoHud — слой, который рисует поверх игры счётчик кадров, график времени кадра, температуры, загрузку процессора и видеопамяти. Настраивается он файлом ~/.config/MangoHud/MangoHud.conf, где несколько десятков опций. Goverlay показывает их списком и группирует по смыслу, чтобы не держать в голове имена параметров.
Отдельная вкладка относится к vkBasalt — слою постобработки Vulkan: сглаживание и повышение резкости. Goverlay умеет включать эффекты и задавать их параметры, но сам пакет vkBasalt не устанавливает. Это важно понимать: пустая вкладка при отсутствии компонента — не ошибка программы.
В последних версиях с сайта проекта появились и дополнительные разделы: установка слоя afmf-linux для интерполяции кадров AMD и экспериментальные параметры запуска. Это уже вмешательство в рендеринг, а не оформление оверлея, поэтому такие функции включайте по одной и проверяйте стабильность игры.
Установка
В Debian и Ubuntu пакет goverlay есть в репозиториях, в Arch — в extra. Если в вашем выпуске его нет, на странице релизов проекта выложены сборки в форматах deb, rpm, AppImage и Flatpak — выбирайте ту, что соответствует дистрибутиву.
sudo apt install goverlay mangohud
sudo dnf install goverlay mangohud
sudo pacman -S goverlay mangohud lib32-mangohud
mangohud --version
Для 32-битных игр в Arch нужен lib32-mangohud, иначе оверлей не появится в старых приложениях. Goverlay пишет конфиг в ~/.config/MangoHud, поэтому обычные игры его видят. Flatpak-Steam — отдельный случай: sandbox не читает домашний каталог без явного разрешения, об этом ниже.
Первый запуск и проверка окружения
При старте Goverlay ищет MangoHud и vkBasalt в системе. Если вкладка пустая или сообщает, что компонент не найден, проверьте пути и слой Vulkan.
which goverlay mangohud
ls /usr/share/vulkan/implicit_layer.d/ | grep -i mango
MANGOHUD=1 vkcube
vkcube входит в пакет vulkan-tools. Если при запуске появился оверлей, слой работает и проблема только в настройках игры. На Wayland MangoHud тоже работает через Vulkan-слой, но в приложении без Vulkan или OpenGL оверлей не появится — это ограничение самой технологии, а не Goverlay.
Разумный набор полей
Не включайте все счётчики сразу: каждый из них читает данные и занимает место на экране. Начните с минимального набора, который отвечает на вопрос «почему нестабильно».
- FPS и frametime — средняя частота и время кадра.
- Загрузка и температура GPU, объём видеопамяти.
- Загрузка CPU и температура процессора.
- Занятая оперативная память.
- Положение оверлея, размер шрифта и прозрачность фона.
График времени кадра важнее среднего FPS: ровные 60 кадров с редкими провалами ощущаются хуже стабильных 55. Включите frametime graph и посмотрите на пики, а не на среднее значение.
Клавиша показа по умолчанию — Right Shift+F12; в конфиге она записывается как toggle_hud=Shift_R+F12. Если комбинация занята игрой, назначьте другую прямо в Goverlay.
Как сохраняются настройки
Кнопка сохранения перезаписывает файл конфигурации. Перед экспериментами сделайте копию: набор галочек легко потерять, а восстановить нужный вид потом долго. Сброс выполняется удалением файла или соответствующей кнопкой в интерфейсе.
cp ~/.config/MangoHud/MangoHud.conf ~/.config/MangoHud/MangoHud.conf.bak
cat ~/.config/MangoHud/MangoHud.conf
# типичный результат работы Goverlay
fps
frametime
gpu_temp
cpu_load
position=top-left
font_size=18
background_alpha=0.4
Отдельный профиль для конкретной игры задаётся переменной MANGOHUD_CONFIGFILE. В параметрах запуска Steam это выглядит так: MANGOHUD_CONFIGFILE=/home/user/.config/MangoHud/game.conf mangohud %command%. Путь должен быть абсолютным, иначе игра его не найдёт.
Запуск игр в Steam
Самый простой способ — добавить mangohud %command% в параметры запуска. Для проверки запустите игру и нажмите Right Shift+F12: оверлей должен появиться и исчезнуть. Если этого не происходит, проверьте, что игра действительно использует Vulkan или OpenGL, а не нативный Wayland-клиент.
В Flatpak-Steam переменные окружения задаются через flatpak override --user --env=..., а сам MangoHud должен быть доступен внутри sandbox. Проще установить расширение org.freedesktop.Platform.VulkanLayer.MangoHud из того же remote, что и runtime.
flatpak override --user --env=MANGOHUD=1 com.valvesoftware.Steam
flatpak run --command=sh com.valvesoftware.Steam -c 'ls ~/.config/MangoHud'
Последняя команда показывает, видит ли sandbox ваш конфиг. Если каталог пуст, добавьте доступ: flatpak override --user --filesystem=~/.config/MangoHud:ro com.valvesoftware.Steam.
vkBasalt: сглаживание и резкость
vkBasalt применяет эффекты после того, как игра отрисовала кадр. В Goverlay доступны cas, fxaa и smaa; для каждого задаётся интенсивность. Включать всё сразу смысла нет — эффекты конкурируют друг с другом и съедают кадры.
ENABLE_VKBASALT=1 mangohud %command%
cat ~/.config/vkBasalt/vkBasalt.conf
ls /usr/share/vulkan/implicit_layer.d/ | grep -i basalt
Слой активируется переменной ENABLE_VKBASALT=1; переключение на лету — клавишей Home. В сетевых играх с античитами сторонние слои могут привести к блокировке, поэтому там лучше обойтись без постобработки.
Диагностика
- Goverlay не видит MangoHud: пакет не установлен или запущена Flatpak-версия, изолированная от системных файлов.
- Оверлея нет в игре: проверьте
vkcube, параметры запуска и то, что игра не рисует через нативный Wayland. - Температуры пустые: драйвер не отдаёт сенсоры, проверьте вывод
sensors. - Игра падает при старте: отключите vkBasalt и обновите драйвер.
- Настройки не применяются: проверьте, что конфиг читается — временные опции задаются через
MANGOHUD_CONFIG.
sensors | grep -E "Tctl|Core|edge"
MANGOHUD_CONFIG=fps,frametime mangohud vkcube
MANGOHUD_CONFIGFILE=~/.config/MangoHud/game.conf mangohud vkcube
Строка с MANGOHUD_CONFIG удобна для проверки: опции действуют только на один запуск и не портят основной файл. Если оверлей появился с ними, но не появляется без них, проблема в конфиге, а не в слое.
Чек-лист
- MangoHud установлен, для 32-битных игр — lib32-пакет.
- Оверлей проверен на vkcube до запуска игры.
- Набор полей минимальный, frametime включён.
- Конфиг сохранён и продублирован в резервную копию.
- Для Flatpak-Steam настроен доступ к каталогу конфига.
- vkBasalt включается отдельно и отключается при проблемах.
Итог
Goverlay — удобная оболочка, а не самостоятельный инструмент: всё, что она делает, сводится к записи конфигов MangoHud и vkBasalt. Зато она снимает главную боль новичка — необходимость помнить имена опций и проверять результат вслепую. Настройте минимальный набор полей, убедитесь, что оверлей работает на тестовом приложении, и только потом включайте постобработку. Тогда диагностика проблем с производительностью займёт минуты, а не часы.