Ventoy Global Control Plugin

This plugin is used to set some global configuration of Ventoy.

  • Json Configuration

A control array is defined to describe the configuration in /ventoy/ventoy.json. Each item is a key:value pair in string.
It should be noted that, you don't need to configure every option, you can also configure only some or one of them.

{
    "control": [
        { "VTOY_DEFAULT_MENU_MODE": "0" },
        { "VTOY_TREE_VIEW_MENU_STYLE": "0" },
        { "VTOY_FILT_DOT_UNDERSCORE_FILE": "1" },
        { "VTOY_SORT_CASE_SENSITIVE": "0" },
        { "VTOY_DEFAULT_SEARCH_ROOT": "/ISO" },
        { "VTOY_MENU_TIMEOUT": "10" },
        { "VTOY_DEFAULT_IMAGE": "/ISO/debian_netinstall.iso" }
    ]
}

Key Type Description
VTOY_DEFAULT_MENU_MODE STRING Default menu display mode, "0":ListView Mode    "1":TreeView Mode
VTOY_TREE_VIEW_MENU_STYLE STRING Menu style in TreeView mode. "0":with DIR and file size prefix    "1":No DIR and file size
Default is "0"
VTOY_FILT_DOT_UNDERSCORE_FILE STRING Filter for files with prefix ._ in name. This will be useful when you use macOS (a lot of ._xxx file generated when you copy files)
"0":Don't filt    "1":Filt
VTOY_SORT_CASE_SENSITIVE STRING Case sensitive when sort the ISO files or directories. Default is "0" (case insensitive)
"0":case insensitive    "1":case sensitive
VTOY_DEFAULT_SEARCH_ROOT STRING The root path where to search the iso files. By default, Ventoy will search all the directories and subdirectories in the USB. This will be very slow when you have huge number of files in the USB. In this case, you can put all the iso files in one directory and use this to specify the search path. Ventoy will only search this directory and its subdirectories for iso files.
VTOY_MENU_TIMEOUT STRING Menu timeout (seconds).
By default no timeout is set. When you set it to 10 for example, the first image will be selected an booted after 10 seconds.
VTOY_DEFAULT_IMAGE STRING Default selected image path. Normally used with VTOY_MENU_TIMEOUT.
It can be ISO/WIM/VHD/IMG ... and supported in both ListView mode and TreeView mode.
Besides, you can use some special values as descripted in following Special VTOY_DEFAULT_IMAGE.
VTOY_VHD_NO_WARNING STRING "0": Show a warning message if the partition is not NTFS when booting VHD(x) file. "1": No warning message
default is "0"
  • Special VTOY_DEFAULT_IMAGE Values

You can use some special values for VTOY_DEFAULT_IMAGE.
VTOY_EXIT: Ventoy will exit after timeout.
Fn>xx>xx: Fn hotkey menu

{
    "control": [
        { "VTOY_MENU_TIMEOUT": "10" },
        { "VTOY_DEFAULT_IMAGE": "VTOY_EXIT" }
    ]
}

{
    "control": [
        { "VTOY_MENU_TIMEOUT": "10" },
        { "VTOY_DEFAULT_IMAGE": "F2>Halt" }
    ]
}
{
    "control": [
        { "VTOY_MENU_TIMEOUT": "10" },
        { "VTOY_DEFAULT_IMAGE": "F4>Search and boot Windows" }
    ]
}
{
    "control": [
        { "VTOY_MENU_TIMEOUT": "10" },
        { "VTOY_DEFAULT_IMAGE": "F4>Boot the 1st local disk" }
    ]
}
{
    "control": [
        { "VTOY_MENU_TIMEOUT": "10" },
        { "VTOY_DEFAULT_IMAGE": "F5>Check plugin json configuration (ventoy.json)>Check theme plugin configuration" }
    ]
}
  • Dual Mode

Supported. You can set different configurations for Legacy BIOS mode and UEFI mode. Please refer Dual Mode Option for details.