v0.2.0

2026-08-03 15:57:25 +00:00 · 2026-03-19 05:35:55 +10:00
parent 8f21756df6
commit 659363c474
19 changed files with 1145 additions and 254 deletions
@@ -1,98 +1,137 @@
 <p align="center">
-  <img src="data/Vual.png" alt="Vual" width="96">
+  <img src="data/Vual.png" alt="Vual" width="128">
 </p>

 <h1 align="center">Vual</h1>

 <p align="center">
-  GTK4-приложение для запуска Cheat Engine в Steam-играх через Proton
+  Запуск Cheat Engine для Steam-игр через Proton
 </p>

 <p align="center">
-  <a href="LICENSE"><img src="https://img.shields.io/badge/license-GPL--3.0-green?style=flat-square" alt="GPL-3.0"></a>
-  <img src="https://img.shields.io/badge/python-3.11+-blue?style=flat-square" alt="Python 3.11+">
-  <img src="https://img.shields.io/badge/gtk-4-4a86cf?style=flat-square" alt="GTK 4">
-  <img src="https://img.shields.io/badge/libadwaita-1-3584e4?style=flat-square" alt="Libadwaita 1">
+  <img src="https://img.shields.io/badge/GTK-4-4a86cf?style=flat-square" alt="GTK 4">
+  <img src="https://img.shields.io/badge/Libadwaita-1-3584e4?style=flat-square" alt="Libadwaita">
+  <img src="https://img.shields.io/badge/Python-3.11+-3776ab?style=flat-square" alt="Python 3.11+">
+  <a href="LICENSE"><img src="https://img.shields.io/badge/License-GPL--3.0-green?style=flat-square" alt="GPL-3.0"></a>
 </p>

-## Что это

-Vual показывает библиотеку установленных Steam-игр в виде сетки с обложками и позволяет в один клик запустить игру, включить для неё [protonhax](https://github.com/jcnils/protonhax) и открыть Cheat Engine прямо внутри Proton-контекста запущенной игры.
+## О проекте

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

 ## Возможности

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

 ## Установка

+### Stapler
+
+```
+stplr repo add lumenara https://github.com/Cheviiot/Lumenara.git
+stplr refresh && stplr install vual
+```
+
 ### Из исходников

-```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
-```
-
 <details>
 <summary><strong>Зависимости</strong></summary>

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

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

 </details>

-## Быстрый старт
-
-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
 ```

+1. При первом запуске откроется встроенный гайд
+2. Перейди в **Настройки → Cheat Engine** — скачай и распакуй CE
+3. Установи **protonhax** там же
+4. Включи переключатель у нужной игры — Vual пропишет launch options
+5. Нажми ▶ — игра запустится, CE откроется автоматически
+
+## Управление
+
+| | |
+|---|---|
+| Запуск CE | Клик по кнопке ▶ на плитке игры |
+| Поиск | Клик по полю поиска в заголовке |
+| Привязать таблицу | Правая кнопка мыши → Assign Table |
+| Вкл/выкл protonhax | Переключатель на плитке игры |
+| Массовое вкл/выкл | Кнопки Enable All / Disable All |
+| Сортировка | Меню сортировки в заголовке |
+| Настройки | Главное меню → Preferences |
+| Гайд | Главное меню → Guide |
+
+## Настройки
+
+| | | По умолчанию |
+|---|---|---|
+| Тема | Системная / Светлая / Тёмная | Системная |
+| Язык | Авто / English / Русский | Авто |
+| Размер плиток | Small / Medium / Large | Medium |
+| Сортировка | По имени / По статусу | По имени |
+| Прозрачность окна | вкл / выкл | выкл |
+| Тема Wine | Тёмная / Светлая | — |
+| Язык CE | EN / RU | — |
+
+## Данные
+
+`~/.config/vual/`
+
+| | |
+|---|---|
+| config.json | Настройки |
+
+`~/.local/share/vual/`
+
+| | |
+|---|---|
+| cheatengine/ | Cheat Engine |
+| bin/protonhax | protonhax |
+| tables/ | .CT-таблицы и привязки |
+| wine_prefix/ | Wine-префикс для тестового запуска CE |
+
+`~/.cache/vual/`
+
+| | |
+|---|---|
+| covers/ | Кэш обложек Steam |
+
 ## Участие в разработке

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

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

 ## Лицензия