Vual

GTK4-приложение для запуска Cheat Engine в Steam-играх через Proton

Что это

Vual показывает библиотеку установленных Steam-игр в виде сетки с обложками и позволяет в один клик запустить игру, включить для неё protonhax и открыть Cheat Engine прямо внутри Proton-контекста запущенной игры.

Приложение самостоятельно скачивает и распаковывает Cheat Engine, управляет protonhax, настраивает тему Wine для всех Proton-префиксов и поддерживает русский язык — как собственного интерфейса, так и Cheat Engine.

Возможности

🎮 Библиотека	Сетка игр с обложками из Steam CDN, поиск, сортировка по имени и статусу
▶️ Запуск	Запуск игры через Steam URI, автоматическое подключение CE к запущенной Proton-игре
🔧 protonhax	Переключатель launch options для каждой игры и массовое включение/отключение
📦 Cheat Engine	Скачивание с cheatengine.org, распаковка через Wine из Proton, тестовый запуск
🎨 Тема Wine	Тёмная и светлая тема для всех Proton-префиксов разом
🌐 Локализация	Язык приложения (EN/RU), язык CE, установка русской локализации CE
⚙️ Настройки	Путь к Steam, шаблон LaunchOptions, regex-исключения, размер плитки

Установка

Из исходников

git clone https://github.com/Cheviiot/vual.git
cd vual
./vual

Stapler (ALT Linux)

stplr repo add lumenara https://github.com/Cheviiot/Lumenara
stplr refresh && stplr install vual

Зависимости

Дистрибутив	Команда
ALT Linux	apt-get install python3-module-pygobject3 libgtk4 libadwaita
Fedora	dnf install python3-gobject gtk4 libadwaita
Arch	pacman -S python-gobject gtk4 libadwaita
Debian / Ubuntu	apt install python3-gi gir1.2-gtk-4.0 gir1.2-adw-1

Также необходим Proton (установленный через Steam) — для распаковки CE и работы protonhax.

Быстрый старт

1. Запустите ./vual
2. Откройте настройки (☰ → Настройки)
3. На вкладке Cheat Engine скачайте и распакуйте CE
4. Установите protonhax если он ещё не установлен
5. Включите переключатель у нужной игры — Vual пропишет launch options
6. Нажмите ▶ у игры — после запуска CE откроется автоматически

Структура данных

~/.config/vual/
└── config.json              # Настройки приложения

~/.local/share/vual/
├── cheatengine/             # Установленный Cheat Engine
├── bin/protonhax            # Управляемый скрипт protonhax
└── wine_prefix/             # Префикс Wine для тестового запуска CE

~/.cache/vual/
└── covers/                  # Кэш обложек Steam

Участие в разработке

Это личный проект. Vual создаётся одним человеком для собственного использования при помощи ИИ.

Код полностью открыт. Если хотите помочь — Pull Request и Issue приветствуются: исправление ошибок, новые функции, переводы, плагины.

Лицензия

GPL-3.0-or-later