gamescope: игровой композитор для Wayland и Steam Deck

gamescope — микро-композитор, который запускает игру внутри собственного окна или отдельного сеанса и сам управляет разрешением, масштабированием и частотой кадров. Его использует Steam Deck, но на обычном настольном Linux он тоже полезен: помогает растянуть низкое разрешение на большой экран, включить FSR, ограничить FPS и удержать игру в предсказуемом окружении. Ниже — установка, параметры запуска, масштабирование, HDR и диагностика.

Зачем нужен этот слой

Обычно игра общается напрямую с X11 или Wayland. gamescope создаёт вложенный композитор: игра видит виртуальный экран заданного размера, а gamescope выводит результат в окно рабочего стола или напрямую в DRM/KMS. Это позволяет задать внутреннее разрешение отдельно от выходного, применить фильтр масштабирования и ограничить частоту кадров независимо от настроек игры.

Дополнительно gamescope изолирует игру от рабочего стола: окна и уведомления не мешают. На Steam Deck тот же механизм отвечает за интерфейс, HDR и переключение частоты обновления. На настольной системе чаще используют вложенный режим, потому что он не требует выхода из текущего сеанса.

Установка

sudo apt install gamescope
sudo dnf install gamescope
sudo pacman -S gamescope
gamescope --help | head -n 40

Пакет есть в репозиториях большинства дистрибутивов. Версии в стабильных ветках могут отставать, поэтому перед настройкой новых фильтров проверьте список опций именно своей сборки. Для NVIDIA нужен достаточно свежий проприетарный драйвер и включённый режим KMS; на старых драйверах возможны чёрный экран и проблемы с захватом курсора.

Запуск в Steam

В параметрах запуска игры gamescope ставится перед %command%. Размеры задаются двумя парами: строчными буквами — внутреннее разрешение игры, заглавными — размер выходного окна.

gamescope -W 2560 -H 1440 -w 1280 -h 720 -f -- %command%
gamescope -w 1920 -h 1080 -f -r 60 -- %command%
gamescope -W 1920 -H 1080 -w 960 -h 540 -S integer -f -- %command%
gamescope --mangoapp -f -- %command%

Первый пример рисует игру в 1280×720 и выводит на 2560×1440. Второй задаёт внутреннее разрешение 1080p и ограничивает игру 60 кадрами. Третий включает целочисленное масштабирование: пиксель превращается в ровный квадрат 2×2, что важно для пиксельной графики. Четвёртый добавляет оверлей MangoHud через mangoapp; обычный mangohud внутри gamescope не поддерживается.

Флаг -f включает полноэкранный режим, -b создаёт окно без рамки, -o задаёт лимит кадров для неактивного окна. Для сглаживания при повышении разрешения используйте -F fsr или -F nis. FSR строит изображение из меньшего буфера и добавляет резкость; NIS делает похожее на стороне NVIDIA. Оба фильтра не заменяют настройки игры и лучше всего работают при разнице разрешений в 1,5–2 раза.

Запуск вне Steam

gamescope -w 1280 -h 720 -W 1920 -H 1080 -F fsr -- ./game
gamescope -f -r 120 -- vkcube
gamescope -e -f -- steam -tenfoot
gamescope --backend=wayland -f -- ./game

Для нативных игр команда отделяется двумя дефисами. Если игра запускается через скрипт, убедитесь, что аргументы передаются именно ей, а не обёртке. Режим -e включает интеграцию со Steam, а -tenfoot запускает интерфейс Big Picture. Вложенный композитор можно принудительно перевести на Wayland-бэкенд, если сеанс работает на Wayland.

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

Масштабирование и HDR

Ключевая пара — внутреннее и внешнее разрешение. Если игра не тянет 4K, задайте 1920×1080 внутри и 3840×2160 снаружи, затем выберите фильтр. Для старых игр с фиксированным разрешением помогает integer, для современных — fsr или nis. Режим -S fit вписывает картинку с сохранением пропорций и добавляет чёрные поля, -S stretch заполняет окно без сохранения пропорций.

HDR включается флагом —hdr-enabled. Он работает только при HDR-дисплее, поддержке со стороны композитора и корректно настроенном сеансе; в вложенном режиме результат зависит от рабочего стола. Если картинка выглядит блёклой, сначала проверьте, что HDR включён в системе, а затем сравните с выключенным флагом.

gamescope --hdr-enabled -f -- %command%
gamescope -F fsr -W 2560 -H 1440 -w 1706 -h 960 -f -- %command%
gamescope -S stretch -W 1920 -H 1080 -w 1440 -h 1080 -f -- %command%
gamescope -b -W 1600 -H 900 -w 1600 -h 900 -- %command%

Диагностика

• Игра не стартует: проверьте, что %command% стоит после двух дефисов и не заключён в лишние кавычки.
• Чёрный экран или мигание: попробуйте другой бэкенд, отключите HDR и проверьте драйвер.
• Курсор уходит за пределы окна: включите —force-grab-cursor.
• Нет оверлея: для gamescope нужен mangoapp, а не обычный mangohud.
• Низкая плавность: ограничьте FPS через -r и сравните 1% low, а не только средний показатель.

Проверить окружение можно командами echo $XDG_SESSION_TYPE и vulkaninfo —summary. Для быстрого теста без игры запустите vkcube внутри gamescope: если тестовое окно работает, проблема скорее в параметрах конкретной игры или лаунчера. Логи сеанса удобно смотреть через journalctl —user -b и искать сообщения gamescope.

Производительность

Любая композиция добавляет кадр обработки, поэтому gamescope нецелесообразно включать там, где всё работает. Выигрыш появляется, когда он заменяет неэффективное масштабирование силами игры или монитора, а также когда ограничение FPS снижает нагрев и шум. На слабой видеокарте FSR из 720p в 1080p обычно даёт больше плавности, чем нативный рендер с просадками.

gamescope -w 1280 -h 720 -W 1920 -H 1080 -F nis -r 60 -- %command%
gamescope -w 1706 -h 960 -W 2560 -H 1440 -F fsr -- %command%

Измеряйте результат, а не верьте обещаниям: сравните средний FPS, 1% low и температуру с одинаковыми настройками. Для портативных устройств важнее стабильные 40–60 кадров и низкое энергопотребление, чем максимальная цифра в углу экрана.

Чек-лист

• Пакет установлен, справка выводится, драйвер поддерживает KMS.
• Внутреннее и внешнее разрешение заданы осознанно.
• Фильтр масштабирования выбран под жанр игры.
• Лимит кадров выставлен через -r, а не только в игре.
• HDR проверен на совместимом дисплее и отключён при проблемах.

Итог

gamescope — удобный инструмент для управления разрешением и частотой кадров, который особенно полезен на портативных консолях, телевизорах и мониторах с нестандартным соотношением сторон. Он не ускоряет железо, но помогает стабилизировать кадры на слабой видеокарте. Начните с простого окна и лимита FPS, затем добавляйте FSR и HDR.