added a minimal GUI description

This commit is contained in:
Sergey Palcheh
2025-10-01 11:11:36 +06:00
parent 15432ace98
commit 07e220794d
11 changed files with 133 additions and 3 deletions

136
README.md
View File

@@ -4,7 +4,25 @@
<p align="center">Инструмент для упрощения установки Windows-приложений на Linux. Он использует подготовленные скрипты, портативные версии Wine и изолированные префиксы, обеспечивая максимальную повторяемость на различных операционных системах основанных на Alt Linux, начиная с релиза p10 и выше.</p>
</div>
## Установка
<p align="center">
<img src="image/handbook/auto_install.png" alt="WineHelper GUI" width="80%">
</p>
## Основные возможности
* **Простая установка**: Устанавливайте Windows-приложения с помощью готовых скриптов, как в автоматическом, так и в ручном режиме.
* **Изолированные окружения**: Каждое приложение устанавливается в свой собственный, изолированный префикс, что предотвращает конфликты.
* **Управление версиями Wine**: Легко переключайтесь между различными версиями Wine и Proton для достижения наилучшей совместимости.
* **Графический и консольный интерфейсы**: Используйте удобный GUI для повседневных задач или мощный CLI для автоматизации.
* **Резервное копирование**: Создавайте и восстанавливайте полные резервные копии ваших префиксов.
* **Встроенные утилиты**: Быстрый доступ к `winecfg`, `regedit`, `Winetricks` и другим инструментам для каждого префикса.
---
<!-- Описание установки WineHelper-->
<details>
<summary style="font-size: 35px; font-weight: bold;">Установка</summary>
```
$ su -
@@ -12,9 +30,10 @@
# apt-get install winehelper
# exit
```
</details>
<!-- Описание использования GUI -->
<!-- Описание использования CLI -->
<details>
<summary style="font-size: 35px; font-weight: bold;">Использование WineHelper (CLI)</summary>
@@ -198,6 +217,7 @@ WineHelper предоставляет доступ к основным инст
--changelog показать историю изменений
--debug [команда] включить режим логирования работы WINE
</pre>
</details>
@@ -205,25 +225,135 @@ WineHelper предоставляет доступ к основным инст
<details>
<summary style="font-size: 35px; font-weight: bold;">Использование WineHelper (GUI)</summary>
### Список приложений для установки
### Вкладки «Автоматическая установка» и «Ручная установка»
При использовании графического интерфейса списки приложений расположены во вкладках **Автоматическая установка** и **Ручная установка**.
<div align="center">
<img src="image/handbook/auto_install.png">
<p><em>Вкладка "Автоматическая установка"</em></p>
</div>
<div align="center">
<img src="image/handbook/manual_install.png">
<p><em>Вкладка "Ручная установка"</em></p>
</div>
Для поиска нужной программы введите название в поле поиска.
<div align="center">
<img src="image/handbook/search.png">
<p><em>Поле поиска</em></p>
</div>
При выборе программы из списка слева, в правой части окна отображается подробная информация о ней: описание, иконка и ссылка на официальный сайт.
<div align="center">
<img src="image/handbook/info.png">
<p><em>Информация о выбранной программе</em></p>
</div>
Для установки программы нажмите кнопку **Установить**.
Для **ручной установки** дополнительно потребуется указать путь к установочному файлу (`.exe` или `.msi`), который вы скачали самостоятельно.
<div align="center">
<img src="image/handbook/manual_install_1.png">
<p><em>Вкладка "Ручная установка" с указанием пути к дистрибутиву</em></p>
</div>
После нажатия кнопки **Установить** появится окно с лицензионным соглашением. После его принятия начнется процесс установки, который будет подробно логироваться в отдельном окне.
<div align="center">
<img src="image/handbook/license_agreement.png">
<p><em>Окно с лицензионным соглашением</em></p>
</div>
<div align="center">
<img src="image/handbook/log.png">
<p><em>Окно установки с логом</em></м</em></p>
</div>
После установки приложения и нажатия кнопки **Закрыть** в окне установки приложения, ярлык приложения появится в списке установленных приложений во вкладке **Установленные** а также в меню приложений и на рабочем столе если это разрешено в рабочем окружении.
### Вкладка «Установленные»
На этой вкладке отображаются все приложения, которые были установлены с помощью WineHelper.
<div align="center">
<img src="image/handbook/installed.png">
<p><em>Вкладка "Установленные"</em></p>
</div>
При выборе приложения в правой панели становятся доступны следующие действия:
* **Запустить/Остановить**: Запускает или останавливает выбранное приложение.
* **Создать лог запуска программы**: Запускает приложение в режиме отладки. После закрытия приложения в вашем домашнем каталоге будет создан файл `winehelper.log`.
* **Создать резервную копию префикса**: Создает полный бэкап префикса приложения (включая версию Wine) в формате `.whpack` на вашем рабочем столе если это разрешено в рабочем окружении.
* **Удалить префикс**: Полностью удаляет приложение вместе с его префиксом и всеми связанными ярлыками.
Также на этой вкладке доступна кнопка **«Восстановить префикс из резервной копии»**, которая позволяет восстановить любое приложение из ранее созданного `.whpack` файла.
<div align="center">
<img src="image/handbook/election_installed.png">
<p><em>Выбранное приложение во вкладке "Установленные"</em></p>
</div>
### Вкладка «Менеджер префиксов»
Эта вкладка предоставляет мощные инструменты для управления префиксами Wine.
<div align="center">
<img src="image/handbook/prefix_manager.png">
<p><em>Вкладка "Менеджер префиксов"</em></p>
</div>
#### Создание нового префикса
Нажав кнопку **«Создать новый префикс»**, вы откроете диалог, где можно задать:
* **Имя префикса**.
* **Разрядность** (32-bit или 64-bit).
* **Наполнение** (чистый префикс или с рекомендуемыми библиотеками).
* **Версию Wine/Proton** из доступного списка.
<div align="center">
<img src="image/handbook/create_prefix.png">
<p><em>Диалог создания нового префикса</em></p>
</div>
#### Управление существующим префиксом
Выбрав префикс из выпадающего списка, вы получаете доступ к панели управления, которая позволяет:
* **Запускать стандартные утилиты Wine**:
* `Редактор настроек (winecfg)`
* `Редактор реестра (regedit)`
* `Удаление программ (uninstaller)`
* `Командная строка (cmd)`
* `Файловый менеджер (winefile)`
* **Управлять компонентами**:
* **Менеджер компонентов (Winetricks)**: Удобный интерфейс для установки и переустановки библиотек, шрифтов и настроек.
* **Управление Wine/Proton**: Смена версии Wine или Proton для выбранного префикса.
* **Управление DXVK/VKD3D**: Установка или удаление конкретных версий DXVK и VKD3D.
* **Ассоциации файлов**: Настройка открытия определенных типов файлов (например, `.pdf`, `.docx`) нативными приложениями Linux.
* **Включать/выключать ESync и FSync**.
* **Устанавливать приложения**: Установить любой `.exe` или `.msi` файл напрямую в выбранный префикс.
* **Создавать ярлыки**: Создать ярлык для любого исполняемого файла внутри префикса.
* **Удалять префикс** или **создавать из него шаблон**.
Справа отображается подробная информация о конфигурации выбранного префикса.
### Вкладка «Справка»
Содержит полезную информацию о проекте:
* **Руководство**: Ссылка на официальную документацию.
* **Авторы**: Список разработчиков и участников проекта.
* **Лицензия**: Текст лицензии WineHelper и информация о сторонних компонентах.
* **История изменений**: Changelog пакета.
<div align="center">
<img src="image/handbook/help.png">
<p><em>Вкладка "Справка"</em></p>
</div>
</details>

Binary file not shown.

After

Width:  |  Height:  |  Size: 153 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 110 KiB

BIN
image/handbook/help.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 91 KiB

BIN
image/handbook/info.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 227 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 133 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 236 KiB

BIN
image/handbook/log.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 336 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 144 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 160 KiB

BIN
image/handbook/search.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 93 KiB