v0.3.0: split modules, screenshots, localization, icons, version check

README.md

@@ -18,8 +18,8 @@
 
 ## О проекте
 
-Vual — приложение для запуска Cheat Engine в Steam-играх, работающих через Proton.
-Показывает библиотеку Steam, управляет protonhax и launch options, скачивает и
+Vual — приложение для запуска [Cheat Engine](https://github.com/cheat-engine/cheat-engine) в Steam-играх, работающих через Proton.
+Показывает библиотеку Steam, управляет [protonhax](https://github.com/jcnils/protonhax) и launch options, скачивает и
 распаковывает CE автоматически, запускает его в нужном Wine-префиксе — всё из одного
 окна.
 
@@ -35,6 +35,15 @@ Vual — приложение для запуска Cheat Engine в Steam-игр
 - **Прозрачность окна** — полупрозрачный фон в стиле frosted glass
 - **Гайд** — встроенная страница быстрого старта при первом запуске и из меню
 
+## Скриншоты
+
+<p align="center">
+  <img src="data/screenshots/main_page.png" alt="Главная" height="300">
+  <img src="data/screenshots/pref_app.png" alt="Внешний вид" height="300">
+  <img src="data/screenshots/pref_steam.png" alt="Steam" height="300">
+  <img src="data/screenshots/pref_ce.png" alt="Cheat Engine" height="300">
+</p>
+
 ## Установка
 
 ### Stapler
@@ -55,12 +64,12 @@ cd vual
 <details>
 <summary><strong>Зависимости</strong></summary>
 
-| Дистрибутив | Команда |
-|---|---|
-| 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` |
+| Дистрибутив      | Команда                                                                         |
+|------------------|---------------------------------------------------------------------------------|
+| 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.
 
@@ -68,63 +77,62 @@ cd vual
 
 ## Использование
 
-```
-./vual
-```
+### Перед началом
 
-1. При первом запуске откроется встроенный гайд
-2. Перейди в **Настройки → Cheat Engine** — скачай и распакуй CE
-3. Установи **protonhax** там же
-4. Включи переключатель у нужной игры — Vual пропишет launch options
-5. Нажми ▶ — игра запустится, CE откроется автоматически
+- Установи или скачай Cheat Engine в настройках
+- Проверь, что путь к Steam указывает на правильную библиотеку
+- Закрой Steam перед массовым изменением launch options
+
+### Как работает Vual
+
+| Шаг | | |
+|---|---|---|
+| **1** | **Выбери игру** | Найди игру в библиотеке и включи переключатель на её плитке |
+| **2** | **Запусти через Steam** | Steam запустит игру с protonhax и подготовит нужное окружение |
+| **3** | **Открой Cheat Engine** | Используй меню плитки, чтобы запустить CE для работающей игры |
+| **4** | **Привяжи таблицу** | Привяжи .CT-файл один раз — Vual будет передавать его в CE автоматически |
+
+### Полезно знать
+
+- Поиск в заголовке быстро фильтрует большие библиотеки
+- Кнопка меню на каждой плитке содержит действия CE и привязку таблиц
+- Прозрачность окна включается в настройках внешнего вида
 
 ## Управление
 
-| | |
-|---|---|
-| Запуск CE | Клик по кнопке ▶ на плитке игры |
-| Поиск | Клик по полю поиска в заголовке |
-| Привязать таблицу | Правая кнопка мыши → Assign Table |
-| Вкл/выкл protonhax | Переключатель на плитке игры |
-| Массовое вкл/выкл | Кнопки Enable All / Disable All |
-| Сортировка | Меню сортировки в заголовке |
-| Настройки | Главное меню → Preferences |
-| Гайд | Главное меню → Guide |
+| Действие           | Как                                     |
+|--------------------|-----------------------------------------|
+| Запуск CE          | Кнопка ▶ на плитке игры                 |
+| Поиск              | Поле поиска в заголовке                 |
+| Привязать таблицу  | Меню плитки → Привязать таблицу         |
+| Вкл/выкл protonhax| Переключатель на плитке                 |
+| Массовое вкл/выкл  | Включить все / Отключить все           |
+| Сортировка         | Меню сортировки в заголовке             |
+| Настройки          | ☰ → Настройки                          |
+| Гайд               | ☰ → Гайд                               |
 
 ## Настройки
 
-| | | По умолчанию |
-|---|---|---|
-| Тема | Системная / Светлая / Тёмная | Системная |
-| Язык | Авто / English / Русский | Авто |
-| Размер плиток | Small / Medium / Large | Medium |
-| Сортировка | По имени / По статусу | По имени |
-| Прозрачность окна | вкл / выкл | выкл |
-| Тема Wine | Тёмная / Светлая | — |
-| Язык CE | EN / RU | — |
+| Параметр           | Варианты                     | По умолчанию |
+|--------------------|------------------------------|--------------|
+| Тема               | Системная / Светлая / Тёмная | Системная    |
+| Язык               | Авто / Английский / Русский  | Авто         |
+| Размер плиток      | Маленький / Средний / Большой| Средний      |
+| Сортировка         | По имени / По статусу        | По имени     |
+| Прозрачность окна  | вкл / выкл                   | выкл         |
+| Тема Wine          | Системная / Тёмная / Светлая | Системная    |
+| Язык CE            | Системный / Русский          | Системный    |
 
 ## Данные
 
-`~/.config/vual/`
-
-| | |
-|---|---|
-| config.json | Настройки |
-
-`~/.local/share/vual/`
-
-| | |
-|---|---|
-| cheatengine/ | Cheat Engine |
-| bin/protonhax | protonhax |
-| tables/ | .CT-таблицы и привязки |
-| wine_prefix/ | Wine-префикс для тестового запуска CE |
-
-`~/.cache/vual/`
-
-| | |
-|---|---|
-| covers/ | Кэш обложек Steam |
+| Путь                              | Содержимое                          |
+|-----------------------------------|-------------------------------------|
+| `~/.config/vual/config.json`      | Настройки                           |
+| `~/.local/share/vual/cheatengine/`| Cheat Engine                        |
+| `~/.local/share/vual/bin/protonhax`| protonhax                          |
+| `~/.local/share/vual/tables/`     | .CT-таблицы и привязки              |
+| `~/.local/share/vual/wine_prefix/`| Wine-префикс для тестового запуска  |
+| `~/.cache/vual/covers/`           | Кэш обложек Steam                  |
 
 ## Участие в разработке