WineHelper

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

Основные возможности

• Простая установка: Устанавливайте Windows-приложения с помощью готовых скриптов, как в автоматическом, так и в ручном режиме.
• Изолированные окружения: Каждое приложение устанавливается в свой собственный, изолированный префикс, что предотвращает конфликты.
• Управление версиями Wine: Легко переключайтесь между различными версиями Wine для достижения наилучшей совместимости.
• Графический и консольный интерфейсы: Используйте удобный GUI для повседневных задач или мощный CLI для автоматизации.
• Резервное копирование: Создавайте и восстанавливайте полные резервные копии ваших префиксов.
• Встроенные утилиты: Быстрый доступ к winecfg, regedit, Winetricks и другим инструментам для каждого префикса.

---

Установка

 $ su -
 # apt-get update && apt-get dist-upgrade
 # apt-get install winehelper
 # exit

Использование WineHelper (CLI)

Список приложений для установки

Вывод списка приложений, доступных к установке:

 $ winehelper install list

или сокращенная команда:

 $ winehelper -i

Запуск установки приложений из списка скриптов

Скрипты установки разделены на два типа:

1. Список программ с возможностью автоматической установки — содержит полностью автоматизированные скрипты установок программ у которых есть дистрибутивы (установщики) в свободном доступе. Процесс полностью автоматизирован. Пример:

 $ winehelper install ksamu

или сокращенная команда:

 $ winehelper -i ksamu

2. Список программ с возможностью установки из существующего дистрибутива — содержит скрипты установок для программ, которых нет в свободном доступе. Пример:

 $ winehelper install is-record-station "/путь/до/установочного_файла"

или сокращенная команда:

 $ winehelper -i is-record-station "/путь/до/установочного_файла"

3. Установка из стороннего скрипта — можно передать путь к собственному скрипту установки, подготовленному по шаблону WineHelper. Пример:

 $ winehelper -i "/путь/до/скрипта_установки"

Процесс установки приложений из списка скриптов

При первом запуске WineHelper проверяются и при необходимости устанавливаются дополнительные зависимости (запрашиваются права root).

Процесс установки приложений:

1. Отображаются лицензионные соглашения на сторонние компоненты. Для продолжения введите y и нажмите Enter.
2. Далее процесс проходит автоматически с подробным выводом в терминал:

• Загрузка и проверка хэш-суммы нужной версии Wine.
• Загрузка и проверка хэш-суммы базового префикса.
• Инициализация и подготовка префикса.
• Скачивание дистрибутива (установщика) программы с официального сайта (если применимо).
• Установка приложения.
• Создание .desktop-файла (ярлыка) на рабочем столе и в меню приложений.

Если устанавливаемое приложение требует дополнительных действий от пользователя (ввод лицензии, настройка), это будет явно указано в терминале.

Установка своего приложения

Для установки своего приложения (не из списка готовых скриптов) выполните следующие шаги:

Этап 1: Создание префикса Создайте новый префикс с использованием wine-wow64 (рекомендуется для новых приложений):

$ winehelper create-prefix

Выберите wine-wow64 версию и разрядность 64-bit.

Note

Всегда сначала пробуйте wine-wow64, это упрощает настройку и избавляет от 32-битных зависимостей.

Этап 2: Запуск установщика Запустите установочный файл в созданном префиксе:

$ winehelper "/путь/до/установочного_файла.exe"

Выберите префикс из списка (введите номер и нажмите Enter).

Удаление префикса с приложением

Для удаления префикса выполните команду:

 $ winehelper remove-prefix [имя_префикса]

Если имя префикса не указано, будет выведен список существующих префиксов:

 0 - Отмена
 1 - Префикс1
 2 - Префикс2
 Выберите префикс (0-2):

Необходимо указать номер удаляемого префикса и нажать клавишу Enter. Далее потребуется подтвердить удаление префикса вводом y.

В результате будут удалены:

• сам префикс;
• установленное ПО;
• desktop-файлы (ярлыки для установленного ПО в префиксе).

Cоздание резервной копии префикса

Команда создания резервной копии префикса:

 $ winehelper backup-prefix [имя_префикса]

Если имя префикса не указано, будет выведен список существующих префиксов:

 0 - Отмена
 1 - Префикс1
 2 - Префикс2
 Выберите префикс (0-2):

Необходимо указать номер удаляемого префикса и нажать клавишу Enter. После выбора префикса автоматически:

• Создаётся копия префикса.
• Внутри префикса сохраняется используемая версия WINE.
• Копируются иконки для ярлыков (.desktop-файлов).
• Сохраняется информация о ярлыках (.desktop-файлах) для будущей распаковки/восстановления префикса.
• Резервная копия сохраняется на рабочем столе с именем: {{path|backup_имя_префикса_дата_создания.whpack}}

Восстановление префикса из резервной копии

Команда восстановления префикса из резервной копии:

 $ winehelper restore-prefix "путь/до/файла.whpack"

Восстановление префикса не требует подключение к интернету и происходит в автоматическом режиме:

• Распаковка префикса.
• Восстановление версии WINE.
• Восстановление ярлыков (.desktop-файлов).

После завершения восстановления приложение будет доступно для запуска через меню или рабочий стол.

Использование команд WINE в WineHelper

WineHelper предоставляет доступ к основным инструментам WINE:

 winehelper winefile                  # запуск файлового менеджера wine
 winehelper winecfg                   # запуск wine конфигуратора для префикса
 winehelper winereg                   # запуск редактора реестра для префикса
 winehelper wineconsole               # запуск терминала wine (cmd.exe)
 winehelper winetricks [компонент]    # автоматическая установка дополнительного компонента в префикс

После выполнения любой из вышеперечисленных команд отображается список существующих префиксов:

0 - Отмена
1 - Префикс1
2 - Префикс2
Выберите префикс (0-2):

Команда выполняется в выбранном вами префиксе.

Запуск стороннего *.exe файла в WineHelper

Есть два варианта:

1. В командной строке выполнить команду:

$ winehelper "путь/до/файла.exe"
0 - Отмена
1 - Префикс1
2 - Префикс2
Выберите префикс (0-2):

Файл будет запущен в выбранном префиксе.

2. С помощью файлового менеджера WINE:

$ winehelper winefile
0 - Отмена
1 - Префикс1
2 - Префикс2
Выберите префикс (0-2):

В файловом менеджере найти и запустить нужный exe-файл.

Дополнительные команды

$ winehelper help

Вывод:

Использование: winehelper [команда]

Команды:
    install list                    список возможных установочных скриптов
    install [скрипт]                запустить скрипт установки программы
    install [скрипт] --clear-pfx    не использовать готовый префикс для установки ПО
    install "путь/до/скрипта"       запустить сторонний скрипт установки

    install-dxvk [версия|none|list] установить, удалить или показать версии DXVK
    install-vkd3d [версия|none|list] установить, удалить или показать версии VKD3D
    change-wine [версия]            изменить версию Wine для текущего префикса

    installed                       список установленных программ
    run [программа]                 запуск программы
    debug [флаги] [программа]       запуск программы в отладчике winedbg
                                    Флаги:
                                      --auto, -a                 автоматический backtrace
                                      --gdb, -g                  режим gdb
                                      --interactive, -i          интерактивный режим
    remove-all                      удалить WineHelper и все связанные данные
    create-prefix                   создать префикс
    remove-prefix [имя_префикса]    удалить префикс и все связанные данные
    backup-prefix [имя_префикса]    создать резервную копию префикса
    restore-prefix \"путь/до/whpack\" восстановить префикс из резервной копии
    clear-winetricks-cache          очистить кэш Winetricks

    winecfg                         запуск wine конфигуратора для префикса
    winereg                         запуск редактора реестра для префикса
    winefile                        запуск файлового менеджера wine
    wineconsole                     запуск терминала wine (cmd.exe)
    control                         запуск панели управления wine
    uninstaller                     запуск удаления программ wine
    winetricks [компонент]          автоматическая установка дополнительного компонента в префикс
    killall                         остановить все процессы Wine
    run-in-prefix <префикс> <файл>  запустить файл в указанном префиксе

Параметры:
    --help                          показать эту справку и выйти
    --version                       показать информацию о пакете и его версии
    --changelog                     показать историю изменений

Использование WineHelper (GUI)

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

При использовании графического интерфейса списки приложений расположены во вкладках Автоматическая установка и Ручная установка.

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

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

Также на вкладке Автоматическая установка есть чекбокс с тестовыми версиями скриптов установки которые еще не прошли полную проверку на зависимости и совместимость, но уже можно попробовать в работе.

Тестовые версии скриптов установки

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

Поле поиска

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

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

Для установки программы нажмите кнопку Установить.

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

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

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

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

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

После установки приложения и нажатия кнопки Закрыть в окне установки приложения, ярлык приложения появится в списке установленных приложений во вкладке Установленные а также в меню приложений и на рабочем столе если это разрешено в рабочем окружении.

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

На этой вкладке отображаются все приложения, которые были установлены с помощью WineHelper.

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

При выборе приложения в правой панели становятся доступны следующие действия:

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

Также на этой вкладке доступна кнопка «Восстановить префикс из резервной копии», которая позволяет восстановить любое приложение из ранее созданного .whpack файла.

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

Расположения лога запуска программы а также резервной копии префикса можно просмотреть с помощью кнопки «Открыть папку с логом/резервной копией префикса» которая появляется автоматически после создания лога или резервной копии.

Кнопка "Открыть папку с логом/резервной копией префикса"

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

Эта вкладка предоставляет мощные инструменты для управления префиксами Wine.

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

Создание нового префикса

Нажав кнопку «Создать новый префикс», вы откроете диалог, где можно задать:

• Имя нового префикса.
• Разрядность (32-bit или 64-bit).
• Шаблон префикса (чистый префикс или с рекомендуемыми библиотеками).
• Версию Wine из доступного списка.

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

Установка своего приложения

Для установки своего приложения (не из списка готовых скриптов) выполните следующие шаги:

Этап 1: Создание префикса

1. Вкладка «Менеджер префиксов»
2. Нажмите «Создать новый префикс»
3. Задайте имя префикса
4. Выберите wine-wow64 версию (рекомендуется)
5. Выберите разрядность 64-bit

Note

Всегда сначала пробуйте wine-wow64, это упрощает настройку и избавляет от 32-битных зависимостей.

Этап 2: Установка приложения

1. Выберите созданный префикс из выпадающего списка
2. Нажмите кнопку «Запустить файл в префиксе», выберите файл для установки
3. Нажмите кнопку «Создать ярлык для приложения в префиксе», выберите установленный файл в префиксе

Управление существующим префиксом

Выбрав префикс из выпадающего списка, вы получаете доступ к панели управления, которая позволяет:

• Управлять компонентами:
  • Менеджер компонентов (Winetricks): Удобный интерфейс для установки и переустановки библиотек, шрифтов и настроек.
• Запускать стандартные утилиты Wine:
  • Редактор настроек (winecfg)
  • Редактор реестра (regedit)
  • Удаление программ (uninstaller)
  • Командная строка (cmd)
  • Файловый менеджер (winefile)
  • Панель управления (control)
• Управлять версиями Wine:
  • Управление версией Wine: Смена версии Wine для выбранного префикса. Диалог выбора позволяет как выбрать уже установленную версию, так и скачать новую из списков, сгруппированных по архитектуре.
• Управлять дополнительными настройками:
  • Управление DXVK/VKD3D: Установка или удаление конкретных версий DXVK и vkd3d-proton.
  • Ассоциации файлов: Настройка открытия определенных типов файлов (например, .pdf, .docx) нативными приложениями Linux, чтобы избежать их открытия внутри Wine.
  • Включать/выключать ESync и FSync: Включение/выключение методов оптимизации синхронизации потоков в Windows-приложениях при запуске через Wine.
  • Включать/выключать CPCSP_PROXY: Поддержка КриптоПро CSP (электронная подпись). Включайте только для приложений, требующих ЭП.
• Устанавливать приложения: Установить любой .exe или .msi файл напрямую в выбранный префикс.
• Создавать ярлыки: Создать ярлык для любого исполняемого файла внутри префикса.
• Удалять префикс или создавать из него шаблон.

Справа отображается подробная информация о конфигурации выбранного префикса.

В самом низу вкладки находится кнопка «Удалить все данные WineHelper».

Caution

Эта функция полностью и безвозвратно удаляет все префиксы, настройки, кэш и ярлыки, созданные WineHelper. Используйте с осторожностью! Программа запросит двойное подтверждение для предотвращения случайного удаления.

Вкладка «Справка»

Содержит полезную информацию о проекте:

• Общее: Ссылка на официальную документацию.
• Авторы: Список разработчиков и участников проекта.
• Лицензия: Текст лицензии WineHelper и информация о сторонних компонентах.
• История изменений: Changelog пакета.

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

Примечание

Warning

Проект находится на стадии WIP (work in progress)