Multi-Mode Option
Ventoy will define a json object for every plugin to set the configuration.
For example, control
for Golbal Control Plugin, theme
for Theme Plugin, menu_alias
for Menu Alias Plugin ...
All these objects are multi-mode options.
What does that mean?
Take theme plugin for example, you can set a theme
object in ventoy.json and it will take effect in all BIOS mode.
{ "theme": { "file": "/ventoy/theme/theme.txt", "gfxmode": "1920x1080" } }
Also, you can set theme_legacy
theme_uefi
theme_ia32
theme_aa64
theme_mips
and correspondingly they will take effect in x86 Legacy BIOS, x86_64 UEFI, IA32 UEFI, ARM64 UEFI and MIPS64 UEFI mode.
{ "theme_legacy": { "display_mode": "CLI" }, "theme_uefi": { "file": "/ventoy/theme/theme.txt", "gfxmode": "1920x1080" }, "theme_ia32": { "file": "/ventoy/theme/theme.txt", "gfxmode": "1920x1080" }, "theme_aa64": { "file": "/ventoy/theme/theme.txt", "gfxmode": "1920x1080" }, "theme_mips": { "file": "/ventoy/theme/theme.txt", "gfxmode": "1920x1080" } }
You can also use the two styles at the same time. For example you can set a theme_legacy
and a theme
Then theme_legacy
will be used for Legacy BIOS mode and theme
will be used for other mode.
{ "theme_legacy": { "display_mode": "CLI" }, "theme": { "file": "/ventoy/theme/theme.txt", "gfxmode": "1920x1080" } }
Similarly:
control
corresponded to control_legacy
, control_uefi
, control_ia32
, control_aa64
and control_mips
auto_install
corresponded to auto_install_legacy
, auto_install_uefi
, auto_install_ia32
, auto_install_aa64
and auto_install_mips
...
Notes
1. For an object xxx
the corresponded dual mode option are xxx_legacy
, xxx_uefi
, xxx_ia32
, xxx_aa64
and xxx_mips
, case-sensitive
2. You can use the two styles at the same time. For example, you can set a control_uefi
and a control
3. You can only set one of the dual mode options. For example, you can only use theme_uefi
and don't set others.
4. All the sub options in the object have no difference.
ventoy.json Example
{ "control_legacy": [ { "VTOY_DEFAULT_MENU_MODE": "1" }, { "VTOY_FILT_DOT_UNDERSCORE_FILE": "1" } ], "control_uefi": [ { "VTOY_DEFAULT_MENU_MODE": "0" }, { "VTOY_FILT_DOT_UNDERSCORE_FILE": "1" } ], "control_ia32": [ { "VTOY_DEFAULT_MENU_MODE": "0" }, { "VTOY_FILT_DOT_UNDERSCORE_FILE": "1" } ], "control_aa64": [ { "VTOY_DEFAULT_MENU_MODE": "0" }, { "VTOY_FILT_DOT_UNDERSCORE_FILE": "1" } ], "control_mips": [ { "VTOY_DEFAULT_MENU_MODE": "0" }, { "VTOY_FILT_DOT_UNDERSCORE_FILE": "1" } ], "theme_legacy": { "display_mode": "CLI" }, "theme_uefi": { "file": "/ventoy/theme/theme.txt", "gfxmode": "1920x1080" }, "theme_ia32": { "file": "/ventoy/theme/theme.txt", "gfxmode": "800x600" }, "theme_aa64": { "file": "/ventoy/theme/theme.txt", "gfxmode": "1024x768" }, "theme_mips": { "file": "/ventoy/theme/theme.txt", "gfxmode": "1024x768" } }