Ventoy 全局控制插件

本插件用来配置一些Ventoy的全局设置。比如默认显示模式等。

  • Json 配置

/ventoy/ventoy.json 中定义了一个 control 数组来描述本插件,数组中的每个成员都是有一个字符串类型的键值对。
注意你不需要对这里列出来的每一项都做配置,可以只对其中的一项或几项做特殊配置,其他的会使用默认值.

{
    "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" }
    ]
}

关键字 类型 描述
VTOY_DEFAULT_MENU_MODE STRING 默认显示模式,"0":列表模式    "1":TreeView 模式
VTOY_TREE_VIEW_MENU_STYLE STRING TreeView模式下的菜单风格,"0":显示DIR和文件大小    "1":不显示DIR和文件大小
默认是 "0"
VTOY_FILT_DOT_UNDERSCORE_FILE STRING 过滤以 ._ 开头的文件。当使用苹果系统时,有时拷贝文件会产生一些 ._ 开头的文件,可以通过此选项过滤掉。
"0": 不过滤     "1":过滤
VTOY_SORT_CASE_SENSITIVE STRING 在菜单排序时是否大小写敏感。默认是 "0" (大小写不敏感)
"0":大小写不敏感    "1":大小写敏感
VTOY_DEFAULT_SEARCH_ROOT STRING 指定搜索ISO文件的根目录。默认Ventoy会搜索U盘上的所有目录和子目录,当你U盘上有海量的文件时,这个过程会很慢。这种情况下你可以把ISO文件单独放在某个目录下,然后通过这个变量来指定搜索路径,此时Ventoy就只会搜索该目录及其子目录。
VTOY_MENU_TIMEOUT STRING 菜单倒计时(秒)。默认不设置,设置之后,比如设置为10,则在倒计时10秒之后,会自动选择启动第1个镜像文件。在倒计时的过程中按任意键会停止倒计时,等待用户操作。
VTOY_DEFAULT_IMAGE STRING 正常情况下默认选中的是第1个镜像文件。通过这个选项可以设置默认选中的镜像文件,一般和 VTOY_MENU_TIMEOUT 一起使用。
可以设置为 WIM/VHD/IMG 等支持的文件,必须是以 / 开始的全路径,ListView模式和TreeView模式都支持。
除此之外,还可以设置为一些特殊值,参考本页特殊 VTOY_DEFAULT_IMAGE 值
VTOY_VHD_NO_WARNING STRING "0": 启动Windows VHD(x)时,如果U盘分区不是NTFS格式,则显示告警信息 "1": 不显示告警信息
默认是 "0",即显示告警信息
  • 特殊 VTOY_DEFAULT_IMAGE

你可以使用一些的特殊的 VTOY_DEFAULT_IMAGE 值来实现一些特殊功能。例如:
VTOY_EXIT: Ventoy 在超时之后会自动退出
Fn>xx>xx: Ventoy 自动执行 Fn 热键内的子菜单,比如 F4>Search and boot Windows

{
    "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" }
    ]
}
  • 双模式配置

支持。可以分别针对 Legacy BIOS 模式和 UEFI 模式做不同的设置。详细说明请参考 双模式选项