4.8 KiB
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.
Быстрый старт
- Запустите
./vual - Откройте настройки (☰ → Настройки)
- На вкладке Cheat Engine скачайте и распакуйте CE
- Установите protonhax если он ещё не установлен
- Включите переключатель у нужной игры — Vual пропишет launch options
- Нажмите ▶ у игры — после запуска 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 приветствуются: исправление ошибок, новые функции, переводы, плагины.