Ventoy 文件列表 插件

  • 背景

默认情况下,Ventoy 会遍历第1个分区(镜像分区)中的所有目录及其子目录,搜索出所有的ISO/IMG等支持的文件。
通过 全局控制插件 你还可以指定搜索的根目录 VTOY_DEFAULT_SEARCH_ROOT ,这样Ventoy就不会遍历所有的目录了, 而只会从你设定的这个目录开始搜索(包含其子目录)。
另外,你还可以在某个目录下放一个名为 .ventoyignore 的文件(文件内容无所谓、空文件也行,只要名字对就可以,注意大小写),这样Ventoy就会跳过这个目录及其子目录的搜索。
最后,Ventoy会把所有搜索出来的文件排序之后显示在启动界面上。(通过 全局控制插件 可以控制排序时是否区分大小写)

  • 新需求

虽然Ventoy提供了比较灵活的搜索镜像文件的配置。但还是会有一些特殊需求。比如:
1、我只想显示出某个目录下的某几个ISO文件,而不是全部的ISO文件
2、我不想按照字母排序,而是希望按照自己指定的顺序来显示启动菜单

因此,这里提供了一个文件列表的插件,由用户自己列出文件列表,Ventoy 不再搜索而是直接使用你给出的文件列表。
同时 Ventoy 也不再对文件进行排序,而是直接按照这里给出的文件顺序来显示启动菜单。
但记住,99%的情况下,你都不需要使用这个插件,让 Ventoy 去搜索即可。

  • Json 定义

/ventoy/ventoy.json 中定义了一个 image_list 的字符串数组来描述相关设置。

{
    "image_list": [
        "/ISO/Linux/archlinux-2020.10.01-x86_64.iso",
        "/ISO/cn_windows_10_enterprise_ltsc_2019_x64_dvd_9c09ff24.iso",
        "/ISO/Win10PE.iso"
    ]
}

Key Type Description
STRING Ventoy支持的镜像文件的全路径(ISO/IMG/VHD...)。
文件必须放在第1个分区,路径必须以 / 开头,不能有中文、空格等非Ascii字符
  • 双模式配置

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

  • 注意

1. 本插件和 菜单别名 插件没有依赖关系,不管有没有设置菜单别名,这里只需要列出实际镜像文件的路径即可。
2. 如果同时设置了全局控制插件中的 VTOY_DEFAULT_SEARCH_ROOT 选项,则列表中的文件必须都位于对应的目录或子目录下。