From e04a59507b42bfec37d8d1055ec2244c2ba69881 Mon Sep 17 00:00:00 2001 From: Sergey Palcheh Date: Tue, 30 Sep 2025 13:49:47 +0600 Subject: [PATCH] initial README.md --- README.md | 198 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 198 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..1b771ed --- /dev/null +++ b/README.md @@ -0,0 +1,198 @@ +
+ +

WineHelper

+

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

+
+ +### Установка + +```sh + $ su - + # apt-get update && apt-get dist-upgrade + # apt-get install winehelper + # exit + ``` + +## Использование WineHelper + +### Список приложений для установки + +Вывод списка приложений, доступных к установке: +```sh + $ winehelper install list + ``` +или сокращенная команда: +```sh + $ winehelper -i + ``` + +### Запуск установки приложений + +Скрипты установки разделены на два типа: + +1. **Список программ с возможностью автоматической установки** — содержит полностью автоматизированные скрипты установок программ у который есть дистрибутивы (установщики) в свободном доступе. +Процесс полностью автоматизирован. +Пример: +```sh + $ winehelper install spravki-bk + ``` +или сокращенная команда: +```sh + $ winehelper -i spravki-bk +``` +2. **Список программ с возможностью установки из существующего дистрибутива** — содержит скрипты установок для программ, которых нет в свободном доступе. +Пример: +```sh + $ winehelper install is-record-station "/путь/до/установочного_файла" + ``` +или сокращенная команда: +```sh + $ winehelper -i is-record-station "/путь/до/установочного_файла" +``` + +### Процесс установки приложений + +При первом запуске **WineHelper** проверяются и при необходимости устанавливаются дополнительные зависимости (запрашиваются права root). + +Процесс установки приложений: +1. Отображаются лицензионные соглашения на сторонние компоненты. Для продолжения введите **y** и нажмите **Enter**. +2. Далее процесс проходит автоматически с подробным выводом в терминал: +- Загрузка и проверка хэш-суммы нужной версии Wine. +- Загрузка и проверка хэш-суммы базового префикса. +- Инициализация и подготовка префикса. +- Скачивание дистрибутива (установщика) программы с официального сайта (если применимо). +- Установка приложения. +- Создание .desktop-файла (ярлыка) на рабочем столе и в меню приложений. + +Если устанавливаемое приложение требует дополнительных действий от пользователя (ввод лицензии, настройка), это будет явно указано в терминале. + +### Удаление префикса с приложением + +Для удаления префикса выполните команду: +```sh + $ winehelper remove-prefix [имя_префикса] + ``` +Если имя префикса не указано, будет выведен список существующих префиксов: +```sh + 0 - Отмена + 1 - Префикс1 + 2 - Префикс2 + Выберите префикс (0-2): +``` +Необходимо указать номер, удаляемого префикса и нажать клавишу **Enter**. Далее потребуется подтвердить удаление префикса, вводом **y**. + +В результате будут удалены: +- сам префикс; +- установленное ПО; +- desktop-файлы (ярлыки для установленного ПО в префиксе). + +### Создание резервной копии префикса + +Команда создания резервной копии префикса: +```sh + $ winehelper backup-prefix [имя_префикса] +Если имя префикса не указано, будет выведен список существующих префиксов: + 0 - Отмена + 1 - Префикс1 + 2 - Префикс2 + Выберите префикс (0-2): + ``` +Необходимо указать номер, удаляемого префикса и нажать клавишу **Enter**. +После выбора префикса автоматически: +- Создаётся копия префикса. +- Внутри префикса сохраняется используемая версия WINE. +- Копируются иконки для ярлыков (.desktop-файлов). +- Сохраняется информация о ярлыках (.desktop-файлах) для будущей распаковки префикса. +- Резервная копия сохраняется на рабочем столе с именем: {{path|backup_имя_префикса_дата_создания.whpack}} + +### Восстановление префикса из резервной копии + +Команда восстановления префикса из резервной копии: +```sh + $ winehelper restore-prefix "путь/до/файла.whpack" +``` +Восстановление префикса не требует подключение к интернету и происходит в автоматическом режиме: +- Распаковка префикса. +- Восстановление версии WINE. +- Восстановление ярлыков (.esktop-файdлов). + +После завершения восстановления приложение доступно для запуска через меню или рабочий стол. + +### Использование команд WINE в WineHelper + +WineHelper предоставляет доступ к основным инструментам WINE: +```sh + winehelper winefile # запуск файлового менеджера wine + winehelper winecfg # запуск wine конфигуратора для префикса + winehelper winereg # запуск редактора реестра для префикса + winehelper wineconsole # запуск терминала wine (cmd.exe) + winehelper winetricks # запуск графического интерфейса winetricks + winehelper winetricks [компонент] # автоматическая установка дополнительного компонента в префикс +``` +После выполнения любой из вышеперечисленных команд отображается список существующих префиксов: + ```sh +0 - Отмена + 1 - Префикс1 + 2 - Префикс2 + Выберите префикс (0-2): + ``` +Команда выполняется в выбранном вами префиксе. + +### Запуск стороннего *.exe файла в WineHelper + +Есть 2 варианта: +1. В командной строке выполнить команду: + ```sh + $ winehelper "путь/до/файла.exe" + 0 - Отмена + 1 - Префикс1 + 2 - Префикс2 + Выберите префикс (0-2): + ``` +Файл будет запущен в выбранном префиксе. + +2. С помощью файлового менеджера WINE:''' + ```sh + $ winehelper winefile + 0 - Отмена + 1 - Префикс1 + 2 - Префикс2 + Выберите префикс (0-2): + ``` +В файловом менеджере найти и запустить нужный exe-файл. + +### Дополнительные команды + + ```sh + $ winehelper help + ``` +Вывод: +
+Использование: winehelper [команда]
+
+Команды:
+    install list                    список возможных установочных скриптов
+    install [скрипт]                запустить скрипт установки программы
+    install [скрипт] --clear-pfx    не использовать готовый префикс для установки ПО
+
+    install-dxvk [версия|none|list] установить, удалить или показать версии DXVK
+    install-vkd3d [версия|none|list] установить, удалить или показать версии VKD3D
+    change-wine [версия]            изменить версию Wine/Proton для текущего префикса
+
+    installed                       список установленных программ
+    run [программа]                 запуск программы (отладка)
+    remove-all                      удалить WineHelper и все связанные данные
+    create-prefix                   создать префикс
+    remove-prefix [имя_префикса]    удалить префикс и все связанные данные
+    backup-prefix [имя_префикса]    создать резервную копию префикса
+    restore-prefix \"путь/до/whpack\" восстановить префикс из резервной копии
+
+Параметры:
+    --help                          показать эту справку и выйти
+    --version                       показать информацию о пакете и его версии
+    --changelog                     показать историю изменений
+    --debug [команда]               включить режим логирования работы WINE
+
+ +> [!WARNING] +> Проект находится на стадии WIP (work in progress) \ No newline at end of file