diff --git a/README.md b/README.md
index 85c36f7..5fce4b3 100644
--- a/README.md
+++ b/README.md
@@ -1,92 +1,92 @@
-# Ventoy for PARAVIS Flash
+# Ventoy для флешки PARAVIS
 
-Ventoy 1.1.18 sources and Paravis changes used on the PARAVIS multiboot USB
-flash.
+Исходники Ventoy 1.1.18 и изменения Paravis, используемые на
+мультизагрузочной флешке PARAVIS.
 
-The PARAVIS flash uses a non-standard partition layout, so Ventoy has to be
-patched to find the data (ISO) partition dynamically instead of assuming
-partition 1:
+На флешке PARAVIS нестандартная разметка, поэтому Ventoy приходится
+патчить: раздел с данными (ISO) определяется динамически, а не считается
+первым.
 
-| # | Size | File system | Label | Purpose |
-|---|------|-------------|-------|---------|
-| 1 | 16 GB | FAT32 | `PARAVIS` | main boot partition (bootmgr / g4d) |
-| 2 | 32 MB | FAT | `VTOYEFI` | Ventoy EFI partition |
-| 3 | rest − 3 MB | exFAT | `DATA` | images and data |
+| # | Размер | ФС | Метка | Назначение |
+|---|--------|-----|-------|------------|
+| 1 | 16 ГБ | FAT32 | `PARAVIS` | основной загрузочный раздел (bootmgr / g4d) |
+| 2 | 32 МБ | FAT | `VTOYEFI` | раздел Ventoy EFI |
+| 3 | остальное − 3 МБ | exFAT | `DATA` | образы и данные |
 
-The data partition is detected by the marker file `/ISO/Ventoy/NOT.DEL`.
+Раздел с данными определяется по файлу-маркеру `/ISO/Ventoy/NOT.DEL`.
 
-## Repository layout
+## Структура репозитория
 
 ```
-Ventoy-src/                 upstream Ventoy 1.1.18 source tree (GPLv3)
+Ventoy-src/                 исходники Ventoy 1.1.18 (GPLv3)
 paravis/
-  patch_ventoy_layout.py    GRUB2 source patches for the custom layout
-  patch_ventoy_grubcfg.py   grub.cfg patch (marker-based data partition)
-  patch_ventoy_hook.py      initramfs hook patch for non-partition-1 data
-  patch_vtoyjump.py         vtoyjump32/64 MBr marker check bypass
-  patch-ventoy-lang.sh      default menu language -> ru_RU
-  build-theme-main.py       builds the GRUB theme from a PSD layout
-  theme/                    GRUB theme assets and ventoy.json
-  ventoy_grub.cfg           "return to main menu" entry
-  ventoy_grub-f7.cfg        F7 entry back to the main Paravis GRUB menu
+  patch_ventoy_layout.py    патчи исходников GRUB2 под нестандартную разметку
+  patch_ventoy_grubcfg.py   патч grub.cfg (поиск раздела данных по маркеру)
+  patch_ventoy_hook.py      патч initramfs hook для раздела данных не 1
+  patch_vtoyjump.py         обход проверки MBR в vtoyjump32/64
+  patch-ventoy-lang.sh      язык меню по умолчанию → ru_RU
+  build-theme-main.py       сборка темы GRUB из PSD-макета
+  theme/                    ресурсы темы GRUB и ventoy.json
+  ventoy_grub.cfg           пункт «возврат в главное меню»
+  ventoy_grub-f7.cfg        пункт F7 — возврат в главное меню Paravis
 ```
 
-## Applying the patches
+## Применение патчей
 
-The scripts take explicit paths, so they can be run from any checkout.
+Скрипты принимают пути явно, поэтому работают из любого каталога.
 
 ```sh
-# 1. GRUB2 sources (run inside the Ventoy build tree)
+# 1. Исходники GRUB2 (в дереве сборки Ventoy)
 python3 paravis/patch_ventoy_layout.py GRUB2/SRC/grub-2.04/grub-core/ventoy
 
-# 2. VTOYEFI grub.cfg
+# 2. grub.cfg в VTOYEFI
 python3 paravis/patch_ventoy_grubcfg.py vtoyefi/grub/grub.cfg
 
 # 3. initramfs hook
 python3 paravis/patch_ventoy_hook.py ventoy.cpio ventoy.cpio
 
 # 4. vtoyjump32.exe / vtoyjump64.exe
-python3 paravis/patch_vtoyjump.py <dir-with-vtoyjump-binaries>
+python3 paravis/patch_vtoyjump.py <каталог-с-бинарниками-vtoyjump>
 
-# 5. default menu language
+# 5. язык меню по умолчанию
 ./paravis/patch-ventoy-lang.sh vtoyefi/grub/grub.cfg
 ```
 
-`patch_vtoyjump.py` patches compiled binaries; it is safe to re-run and
-skips files that are already patched.
+`patch_vtoyjump.py` патчит скомпилированные бинарники; его можно запускать
+повторно — уже пропатченные файлы пропускаются.
 
-## Theme
+## Тема
 
-`paravis/theme/` contains `theme.txt`, `ventoy.json`, the background and
-widget PNGs and `paravis.pf2` (Montserrat converted to GRUB format).
+В `paravis/theme/` лежат `theme.txt`, `ventoy.json`, фон, PNG-элементы
+интерфейса и `paravis.pf2` (Montserrat в формате GRUB).
 
-`ventoy.json` refers to `tahoma20.pf2`, `tahoma16.pf2`, `tahoma-bold16.pf2`
-and `tahoma-bold14.pf2`. Those files are **not** part of this repository
-because they are derived from Microsoft fonts. Provide them locally when
-deploying the theme, or generate replacements from a font you are allowed to
-use:
+`ventoy.json` ссылается на `tahoma20.pf2`, `tahoma16.pf2`,
+`tahoma-bold16.pf2` и `tahoma-bold14.pf2`. Этих файлов **нет** в
+репозитории, потому что они являются производными шрифтов Microsoft.
+Добавьте их локально при развёртывании темы или соберите замену из
+шрифта, который разрешено использовать:
 
 ```sh
 grub-mkfont -s 20 -o tahoma20.pf2 YourFont.ttf
 ```
 
-`build-theme-main.py` renders the background and a preview from a layered
-PSD file; it needs `psd-tools`, `Pillow` and the Montserrat font.
+`build-theme-main.py` собирает фон и предпросмотр из многослойного PSD;
+нужны `psd-tools`, `Pillow` и шрифт Montserrat.
 
-## What is not included
+## Что не входит
 
-This is a source-only repository. It does not contain:
+Релиз содержит только исходники. В репозитории нет:
 
-- private keys, certificates or signed EFI binaries (`keys/`, `*.signed`);
-- Microsoft-derived font files (`tahoma*.pf2`, `segoeui18.pf2`);
-- built Ventoy releases and bootable images (`*.iso`, `*.img`, `*.wim`,
-  `*.esd`, `Data.pf`);
-- `bootice.exe`, Total Commander and other third-party binaries;
-- build output, logs or local machine paths.
+- приватных ключей, сертификатов и подписанных EFI (`keys/`, `*.signed`);
+- производных шрифтов Microsoft (`tahoma*.pf2`, `segoeui18.pf2`);
+- собранных релизов Ventoy и загрузочных образов (`*.iso`, `*.img`,
+  `*.wim`, `*.esd`, `Data.pf`);
+- `bootice.exe`, Total Commander и других сторонних бинарников;
+- результатов сборки, логов и локальных путей.
 
-## License
+## Лицензия
 
-Ventoy itself is licensed under GPLv3; see
-[`Ventoy-src/COPYING`](Ventoy-src/COPYING). The Paravis patches and theme are
-released under the same terms as the project they modify. See
-[`THIRD-PARTY.md`](THIRD-PARTY.md) for details.
+Сам Ventoy распространяется по GPLv3, см.
+[`Ventoy-src/COPYING`](Ventoy-src/COPYING). Патчи и тема Paravis
+распространяются на тех же условиях, что и проект, который они изменяют.
+Подробности — в [`THIRD-PARTY.md`](THIRD-PARTY.md).