Vual
GTK4-приложение для запуска Cheat Engine в Steam-играх через Proton
## Что это
Vual показывает библиотеку установленных Steam-игр в виде сетки с обложками и позволяет в один клик запустить игру, включить для неё [protonhax](https://github.com/jcnils/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-исключения, размер плитки |
## Установка
### Из исходников
```bash
git clone https://github.com/Cheviiot/vual.git
cd vual
./vual
```
### [Stapler](https://stplr.dev/)
```bash
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](LICENSE)