Стандартное меню Ventoy выводит все ISO-образы одним длинным списком на синем фоне, и при большом количестве файлов найти нужный дистрибутив становится неудобно. Кастомизация решается через конфигурационный файл ventoy.json и систему плагинов: так можно сменить тему оформления, задать образ по умолчанию, переименовать пункты и скрыть лишние файлы из списка.
Ниже разберём, где лежит конфиг, какие плагины отвечают за внешний вид меню, как подключить тему GRUB и какие настройки чаще всего вызывают ошибки. Все манипуляции выполняются на разделе флешки с меткой VTOYEFI или в корне первого раздела — в зависимости от задачи.
Где хранится конфигурация меню Ventoy
Все пользовательские настройки Ventoy собираются в одном файле — ventoy.json. Его нужно создать вручную в папке ventoy в корне первого раздела флешки (того, где лежат ISO-файлы). Итоговый путь выглядит так: /ventoy/ventoy.json.
Файл пишется в формате JSON, поэтому важна точность синтаксиса: лишняя запятая или незакрытая скобка сделает конфиг нерабочим, и Ventoy просто проигнорирует его без каких-либо сообщений об ошибке. Для редактирования подойдёт любой текстовый редактор с подсветкой JSON — например, Notepad++ или VS Code.
⚠️ Внимание: не создавайте ventoy.json в системном разделе VTOYEFI — он занимает около 32 МБ и предназначен для загрузчика. Конфиг размещается только в папке ventoy на основном разделе с образами.
Структура ventoy.json и основные плагины
Конфигурация построена по модульному принципу: каждая функция оформляется отдельным блоком — плагином. За внешний вид меню отвечают несколько ключевых блоков.
- 🎨 theme — подключение внешней темы оформления GRUB;
- 📋 menu_alias — переименование пунктов меню без переименования самих ISO-файлов;
- ⭐ default_image — выбор образа, который будет выделен по умолчанию при загрузке;
- 🚫 menu_class / injection — фильтрация и дополнительные действия для отдельных образов.
Пример минимального конфига с темой и переименованием пункта:
{
"theme": {
"file": "/ventoy/theme/mytheme/theme.txt"
},
"menu_alias": [
{
"image": "/iso/windows11.iso",
"alias": "Windows 11 Pro — установка"
}
]
}
Пути внутри файла указываются от корня раздела с образами. Если ISO лежит в папке iso, то и путь должен начинаться с /iso/.
Смена темы оформления меню
Темы для Ventoy — это обычные темы GRUB2, состоящие из файла theme.txt, шрифтов и фоновых изображений. Готовые варианты можно найти на профильных ресурсах, посвящённых кастомизации GRUB.
Порядок подключения темы следующий:
- 📁 Распакуйте архив темы в папку на флешке, например
/ventoy/theme/mytheme/; - 📝 Убедитесь, что внутри есть файл
theme.txt— именно он указывается в конфиге; - ⚙️ Добавьте блок
themeв ventoy.json с полным путём к этому файлу; - 🔄 Перезагрузитесь с флешки и проверьте результат.
Если тема не применилась, чаще всего виноват неверный путь или отсутствующие файлы шрифтов, на которые ссылается theme.txt. Проверьте, что структура папок темы сохранена полностью, а не скопирован один лишь конфиг.
Переименование пунктов и выбор образа по умолчанию
Имена файлов вроде ru_windows_10_business_editions_x64.iso в меню выглядят громоздко. Плагин menu_alias позволяет назначить каждому образу понятное название, не трогая сам файл — это удобно, когда имена ISO важны для учёта.
Блок default_image задаёт пункт, на котором будет стоять курсор при открытии меню. Дополнительно можно настроить таймаут автоматического выбора через параметр timeout в блоке control — тогда образ загрузится сам через заданное число секунд.
{
"control": [
{ "VTOY_DEFAULT_MENU_MODE": "0" },
{ "VTOY_MENU_TIMEOUT": "10" }
]
}
☑️ Чек-лист настройки меню Ventoy
Скрытие файлов и управление отображением списка
Когда на флешке десятки образов, помогает фильтрация. Ventoy поддерживает несколько способов сократить список без удаления файлов.
Во-первых, есть встроенный параметр VTOY_HIDE_FILES и механизм игнорирования по расширению. Во-вторых, файлы и папки, начинающиеся с определённых префиксов, можно исключить из показа через control-параметры. В-третьих, в самом меню работает клавиша переключения режима просмотра — список или дерево папок, что тоже упрощает навигацию.
Для служебных файлов (например, драйвер-паков или архивов, которые Ventoy пытается показать как образы) достаточно сменить расширение на неподдерживаемое — они исчезнут из меню, но останутся на флешке.
⚠️ Внимание: не переименовывайте ISO-файлы после настройки menu_alias и default_image — плагины привязаны к точным путям, и после переименования привязка сломается.
Режимы отображения меню
По умолчанию Ventoy показывает плоский список всех найденных образов. Нажатие клавиши в меню (подсказка отображается внизу экрана) переключает в древовидный режим, где образы группируются по папкам. Для флешек с большой коллекцией удобнее сразу разложить ISO по каталогам: /windows, /linux, /utils.
Сравнение основных плагинов кастомизации
| Плагин | Назначение | Ключевой параметр |
|---|---|---|
| theme | Смена внешнего вида меню | file (путь к theme.txt) |
| menu_alias | Переименование пунктов меню | image + alias |
| default_image | Образ по умолчанию | image |
| control | Глобальные параметры поведения | VTOY_* переменные |
| menu_tip | Подсказки для пунктов меню | image + tip |
Плагины можно комбинировать в одном ventoy.json — они не конфликтуют между собой, если синтаксис корректен. Разумно начинать с одного блока, проверить его загрузкой, и только потом добавлять следующий: так проще локализовать ошибку.
Типичные ошибки при настройке меню
Самая частая проблема — конфиг игнорируется из-за ошибки синтаксиса JSON, при этом Ventoy не выводит никаких предупреждений. Внешне это выглядит так, будто настройки «не работают». Всегда проверяйте файл валидатором перед перезагрузкой.
Вторая типичная ситуация — неверные пути. Путь в конфиге должен начинаться с / и точно совпадать с регистром символов и расположением файлов на флешке. Папка Theme и theme для Ventoy — разные пути.
Третья причина — конфиг сохранён в кодировке с BOM или в формате Windows-переносов строк, что иногда мешает разбору. Сохраняйте файл в UTF-8 без BOM.
Часто задаваемые вопросы
Где должен лежать ventoy.json?
В папке ventoy в корне первого раздела флешки — того же, где размещены ISO-образы. Полный путь: /ventoy/ventoy.json.
Почему тема не применяется после настройки?
Проверьте путь к theme.txt в конфиге, целостность папки темы (шрифты и изображения должны быть на месте) и синтаксис JSON. Также убедитесь, что регистр букв в пути совпадает с реальным.
Можно ли переименовать пункт меню, не переименовывая ISO-файл?
Да, для этого служит плагин menu_alias: в нём указывается путь к образу и желаемое отображаемое имя. Сам файл при этом остаётся нетронутым.
Как скрыть лишние файлы из меню Ventoy?
Используйте параметры фильтрации в блоке control, разложите образы по папкам и переключитесь в древовидный режим просмотра, либо смените расширение служебных файлов на неподдерживаемое.
Что делать, если после правок меню Ventoy перестало работать?
Удалите или переименуйте ventoy.json — Ventoy загрузится с настройками по умолчанию. Затем верните конфиг по частям, проверяя работоспособность после каждого блока, чтобы найти проблемный фрагмент.