diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1b771ed
--- /dev/null
+++ b/README.md
@@ -0,0 +1,198 @@
+<div align="center">
+  <img src="image/gui/winehelper.svg" width="64">
+  <h1 align="center">WineHelper</h1>
+  <p align="center">Инструмент для упрощения установки Windows-приложений на Linux. Он использует подготовленные скрипты, портативные версии Wine и изолированные префиксы, обеспечивая максимальную повторяемость на различных системах, начиная с релиза [[p10]] и выше.</p>
+</div>
+
+### Установка
+
+```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
+ ```
+Вывод:
+<pre>
+Использование: 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
+</pre>
+
+> [!WARNING]
+> Проект находится на стадии WIP (work in progress)
\ No newline at end of file