ventoy启动后搜索了U盘上所有的WIM ISO和EFI文件放在显示菜单，比较杂乱

moors

1. 指定搜索目录
通过 全局控制插件 中的 VTOY_DEFAULT_SEARCH_ROOT 参数，可以指定搜索目录。指定之后，Ventoy 就只会在这个目录及其子目录里面搜索了。
如下设置则 Ventoy 就只会在 ISO 这个目录里面搜索（包括其子目录）。

{
    "control": [
        { "VTOY_DEFAULT_SEARCH_ROOT": "/ISO" }
    ]
}

minchengan

还可以在不需要搜索的目录下放一个文件，文件名：.ventoyignore

shy20070509

控制 Ventoy 搜索路径的方法总结
背景介绍
默认情况下，Ventoy 会遍历磁盘中的所有目录及其子目录以找出所有支持的镜像文件。一般情况下U盘中的文件数目都不会很多，因此这个过程比较快，几乎感觉不到。
但是如果你的U盘中有非常非常多文件的话，整个搜素过程就会很慢，就会卡很久才能进入启动菜单。
因此，Ventoy 提供了多种方法来控制搜索行为，灵活使用这些方法可以加快搜索速度，减少进入启动菜单的等待时间。

注意：本文中介绍的各个方法可能是不同的版本中加入的，所以测试时请使用最新发布的 Ventoy 版本。
1. 指定搜索目录
通过 全局控制插件 中的 VTOY_DEFAULT_SEARCH_ROOT 参数，可以指定搜索目录。指定之后，Ventoy 就只会在这个目录及其子目录里面搜索了。
如下设置则 Ventoy 就只会在 ISO 这个目录里面搜索（包括其子目录）。

{
    "control": [
        { "VTOY_DEFAULT_SEARCH_ROOT": "/ISO" }
    ]
}
2. 指定搜索的子目录层数
全局控制插件 中还有一个 VTOY_MAX_SEARCH_LEVEL 参数，通过这个参数可以控制递归搜索子目录时的最大层数。默认情况下，不管你子目录有多少层都会一直搜到底。
通过这个参数可以设置，比如最多搜索 3 层以内的子目录。如果同时也设置了 VTOY_DEFAULT_SEARCH_ROOT 参数，则层数就从其对应的目录为根目录（0级），往下开始计算。
比如，下面这个设置相当于只列出根目录下的文件，而不去搜索任何一个子目录。

{
    "control": [
        { "VTOY_MAX_SEARCH_LEVEL": "0" }
    ]
}
下面这个设置表示，从 ISO 目录开始，往下最多搜索1层子目录。所以，例如 /ISO/abc 这个目录会进行搜索，而 /ISO/abc/def 这个目录就不会搜索了。

{
    "control": [
        { "VTOY_MAX_SEARCH_LEVEL": "1" },
        { "VTOY_DEFAULT_SEARCH_ROOT": "/ISO" }
    ]
}
3. 跳过某个特定的目录
Ventoy 还提供了一个小功能。就是如果发现某一个目录下有一个名字为 .ventoyignore 的文件。就会自动跳过这个目录及其所有子目录的搜索。
这里只要求文件名字是 .ventoyignore 即可，对文件内容没有要求，甚至也可以是一个空文件。这在一些特殊情况下比较有用。 例如，你在某个目录下有很多 ISO 格式 的 Office 安装文件，由于是 ISO 格式的，所以默认也会被 Ventoy 搜索出来，但其实它不是一个可启动的镜像文件。 此时，你就可以在这个目录下放一个 .ventoyignore 即可。

另外，特殊说明一下，这个文件要求名字是 .ventoyignore 也就是说它没有名称部分，只有一个后缀部分。默认情况下，系统可能不允许你创建这种没有名称、只有后缀的文件。
这个其实是有意为之，就是为了防止误操作的情况。你可以借助批处理 CMD.exe 来创建这个文件，如下（假设你想要跳过 Ventoy 里面的 ISO/test 这个目录）：

echo 123 > E:\ISO\test\.ventoyignore
另外，.ventoyignore 在 F2 浏览模式 下也能使用。 .ventoyignore 如果位于某个分区的根路径下，则整个分区在F2浏览时也会被跳过。

4. 指定文件列表
文件列表插件 这种模式是终极的自定义模式。
在这种模式下，Ventoy 再也不自己搜索了，而是完全由你来告诉 Ventoy，你说有几个文件就几个文件，你说在哪个目录就在哪个目录。

5. 文件类型过滤
默认情况下，Ventoy 会列出所有支持的镜像文件，比如 .iso/.wim/.img/.vhd/.vtoy 文件。
全局控制插件 中有一组 VTOY_FILE_FLT_XXX 参数，通过这个参数可以进行文件类型过滤。 比如，把 VTOY_FILE_FLT_EFI 设置为 "1", 则会过滤掉所有的 .efi 文件。

总结
Ventoy 提供了几种控制搜索行为的方法，可以灵活使用。其中，除了指定文件列表的方式以外，其他方法是可以组合使用的。
比如，你指定了搜索路径为 ISO 目录以后，你也还可以在 ISO/abc 这个子目录下放一个 .ventoyignore 文件， 这样 ISO/abc 这个子目录就会被整个跳过。

shy20070509

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

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

因此，这里提供了一个文件列表的插件。有 白名单 和 黑名单 两种模式。
在白名单模式下
由用户自己列出文件列表，Ventoy 不再搜索而是直接使用你给出的文件列表。 同时 Ventoy 也不再对文件进行排序，而是直接按照这里给出的文件顺序来显示启动菜单。
在黑名单模式下
Ventoy 首先还是像原来一样搜索，最后再从搜索结果中剔除这个列表中的文件。

但记住，99%的情况下，你都不需要使用这个插件，让 Ventoy 去搜索即可。

Json 定义
推荐使用 VentoyPlugson 工具进行配置，无需手动创建、编辑json文件。请参考 VentoyPlugson
关于 ventoy.json 的位置以及相关说明，请首先参考 插件入口 （*必读）
在镜像分区 /ventoy/ventoy.json 中定义了一个 image_list/image_blacklist 的字符串数组来描述相关设置，分别对应白名单模式和黑名单模式。
注意，image_list 和 image_blacklist 是互斥的，只能使用其中一种，不能同时使用。

{
    "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...）。image_list 对应白名单，image_blacklist 对应黑名单。
文件必须放在第1个分区，路径必须以 / 开头，不能有中文、空格等非Ascii字符
本参数支持模糊匹配，请参考 插件路径匹配说明
多模式选项
支持。可以分别针对 x86 Legacy BIOS、IA32 UEFI、x86_64 UEFI 和 ARM64 UEFI 模式做不同的设置。详细说明请参考 多模式选项

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

cuicongyuan

shy20070509 发表于 2023-3-2 15:42
控制 Ventoy 搜索路径的方法总结
背景介绍
默认情况下，Ventoy 会遍历磁盘中的所有目录及其子目录以找出 ...

panyf14

学习学习

2012andyle113

直接搜索没搞过，都是手动自己找

lucky323su

thank you

xhxy2021

进来学习下

2012zcsh

同感，支持楼主的提议，期待ventoy以后的改进。

abs9668

谢谢楼主分享

2011sxpdwzs

学习中。。。。。。

plutoshen

打不死的小强 发表于 2023-3-2 20:53
{
    "control":[
        { "VTOY_MAX_SEARCH_LEVEL": "2" },

这个很全了

cfc1680

学习一下，感谢分享了

aaa1942

软件里面自带的有程序可以指定搜索目录的级数

nanan84563

官网文档里面有全局插件，能设置iso存储文件夹

zp1688

学习了！

chinaben

打不死的小强 发表于 2023-3-2 20:53
{
    "control":[
        { "VTOY_MAX_SEARCH_LEVEL": "2" },

这个全面，感谢

hawks

软件里自带程序可以设置ISO的目录

十三先生

这个方法可行

xpf235689

不想动 看看作者能不能优化下