diff --git a/README.md b/README.md index 8816581..ae06f1d 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,25 @@

Инструмент для упрощения установки Windows-приложений на Linux. Он использует подготовленные скрипты, портативные версии Wine и изолированные префиксы, обеспечивая максимальную повторяемость на различных операционных системах основанных на Alt Linux, начиная с релиза p10 и выше.

-## Установка +

+ WineHelper GUI +

+ +## Основные возможности + +* **Простая установка**: Устанавливайте Windows-приложения с помощью готовых скриптов, как в автоматическом, так и в ручном режиме. +* **Изолированные окружения**: Каждое приложение устанавливается в свой собственный, изолированный префикс, что предотвращает конфликты. +* **Управление версиями Wine**: Легко переключайтесь между различными версиями Wine и Proton для достижения наилучшей совместимости. +* **Графический и консольный интерфейсы**: Используйте удобный GUI для повседневных задач или мощный CLI для автоматизации. +* **Резервное копирование**: Создавайте и восстанавливайте полные резервные копии ваших префиксов. +* **Встроенные утилиты**: Быстрый доступ к `winecfg`, `regedit`, `Winetricks` и другим инструментам для каждого префикса. + +--- + + + +
+ Установка ``` $ su - @@ -12,9 +30,10 @@ # apt-get install winehelper # exit ``` +
- +
Использование WineHelper (CLI) @@ -198,6 +217,7 @@ WineHelper предоставляет доступ к основным инст --changelog показать историю изменений --debug [команда] включить режим логирования работы WINE +
@@ -205,25 +225,135 @@ WineHelper предоставляет доступ к основным инст
Использование WineHelper (GUI) -### Список приложений для установки +### Вкладки «Автоматическая установка» и «Ручная установка» При использовании графического интерфейса списки приложений расположены во вкладках **Автоматическая установка** и **Ручная установка**.
+

Вкладка "Автоматическая установка"

+

Вкладка "Ручная установка"

+Для поиска нужной программы введите название в поле поиска. +
+ +

Поле поиска

+
+При выборе программы из списка слева, в правой части окна отображается подробная информация о ней: описание, иконка и ссылка на официальный сайт. +
+ +

Информация о выбранной программе

+
+Для установки программы нажмите кнопку **Установить**. +Для **ручной установки** дополнительно потребуется указать путь к установочному файлу (`.exe` или `.msi`), который вы скачали самостоятельно. +
+ +

Вкладка "Ручная установка" с указанием пути к дистрибутиву

+
+После нажатия кнопки **Установить** появится окно с лицензионным соглашением. После его принятия начнется процесс установки, который будет подробно логироваться в отдельном окне. + +
+ +

Окно с лицензионным соглашением

+
+ +
+ +

Окно установки с логом

+
+ +После установки приложения и нажатия кнопки **Закрыть** в окне установки приложения, ярлык приложения появится в списке установленных приложений во вкладке **Установленные** а также в меню приложений и на рабочем столе если это разрешено в рабочем окружении. + +### Вкладка «Установленные» + +На этой вкладке отображаются все приложения, которые были установлены с помощью WineHelper. + +
+ +

Вкладка "Установленные"

+
+ +При выборе приложения в правой панели становятся доступны следующие действия: +* **Запустить/Остановить**: Запускает или останавливает выбранное приложение. +* **Создать лог запуска программы**: Запускает приложение в режиме отладки. После закрытия приложения в вашем домашнем каталоге будет создан файл `winehelper.log`. +* **Создать резервную копию префикса**: Создает полный бэкап префикса приложения (включая версию Wine) в формате `.whpack` на вашем рабочем столе если это разрешено в рабочем окружении. +* **Удалить префикс**: Полностью удаляет приложение вместе с его префиксом и всеми связанными ярлыками. + +Также на этой вкладке доступна кнопка **«Восстановить префикс из резервной копии»**, которая позволяет восстановить любое приложение из ранее созданного `.whpack` файла. + +
+ +

Выбранное приложение во вкладке "Установленные"

+
+ +### Вкладка «Менеджер префиксов» + +Эта вкладка предоставляет мощные инструменты для управления префиксами Wine. + +
+ +

Вкладка "Менеджер префиксов"

+
+ +#### Создание нового префикса + +Нажав кнопку **«Создать новый префикс»**, вы откроете диалог, где можно задать: +* **Имя префикса**. +* **Разрядность** (32-bit или 64-bit). +* **Наполнение** (чистый префикс или с рекомендуемыми библиотеками). +* **Версию Wine/Proton** из доступного списка. + +
+ +

Диалог создания нового префикса

+
+ +#### Управление существующим префиксом + +Выбрав префикс из выпадающего списка, вы получаете доступ к панели управления, которая позволяет: + +* **Запускать стандартные утилиты Wine**: + * `Редактор настроек (winecfg)` + * `Редактор реестра (regedit)` + * `Удаление программ (uninstaller)` + * `Командная строка (cmd)` + * `Файловый менеджер (winefile)` +* **Управлять компонентами**: + * **Менеджер компонентов (Winetricks)**: Удобный интерфейс для установки и переустановки библиотек, шрифтов и настроек. + * **Управление Wine/Proton**: Смена версии Wine или Proton для выбранного префикса. + * **Управление DXVK/VKD3D**: Установка или удаление конкретных версий DXVK и VKD3D. + * **Ассоциации файлов**: Настройка открытия определенных типов файлов (например, `.pdf`, `.docx`) нативными приложениями Linux. +* **Включать/выключать ESync и FSync**. +* **Устанавливать приложения**: Установить любой `.exe` или `.msi` файл напрямую в выбранный префикс. +* **Создавать ярлыки**: Создать ярлык для любого исполняемого файла внутри префикса. +* **Удалять префикс** или **создавать из него шаблон**. + +Справа отображается подробная информация о конфигурации выбранного префикса. + +### Вкладка «Справка» + +Содержит полезную информацию о проекте: +* **Руководство**: Ссылка на официальную документацию. +* **Авторы**: Список разработчиков и участников проекта. +* **Лицензия**: Текст лицензии WineHelper и информация о сторонних компонентах. +* **История изменений**: Changelog пакета. + +
+ +

Вкладка "Справка"

+
diff --git a/image/handbook/create_prefix.png b/image/handbook/create_prefix.png new file mode 100644 index 0000000..2f66f0f Binary files /dev/null and b/image/handbook/create_prefix.png differ diff --git a/image/handbook/election_installed.png b/image/handbook/election_installed.png new file mode 100644 index 0000000..e6742c5 Binary files /dev/null and b/image/handbook/election_installed.png differ diff --git a/image/handbook/help.png b/image/handbook/help.png new file mode 100644 index 0000000..9a5a8b4 Binary files /dev/null and b/image/handbook/help.png differ diff --git a/image/handbook/info.png b/image/handbook/info.png new file mode 100644 index 0000000..2226e90 Binary files /dev/null and b/image/handbook/info.png differ diff --git a/image/handbook/installed.png b/image/handbook/installed.png new file mode 100644 index 0000000..ae97b90 Binary files /dev/null and b/image/handbook/installed.png differ diff --git a/image/handbook/license_agreement.png b/image/handbook/license_agreement.png new file mode 100644 index 0000000..7668896 Binary files /dev/null and b/image/handbook/license_agreement.png differ diff --git a/image/handbook/log.png b/image/handbook/log.png new file mode 100644 index 0000000..a7bfaec Binary files /dev/null and b/image/handbook/log.png differ diff --git a/image/handbook/manual_install_1.png b/image/handbook/manual_install_1.png new file mode 100644 index 0000000..92b9b43 Binary files /dev/null and b/image/handbook/manual_install_1.png differ diff --git a/image/handbook/prefix_manager.png b/image/handbook/prefix_manager.png new file mode 100644 index 0000000..25d0803 Binary files /dev/null and b/image/handbook/prefix_manager.png differ diff --git a/image/handbook/search.png b/image/handbook/search.png new file mode 100644 index 0000000..1c72cc3 Binary files /dev/null and b/image/handbook/search.png differ