资讯动态

Ventoy 如何定制启动菜单主题

发布时间:2026/10/20 10:54:26 来源:尧图企业网站定制
Ventoy 如何定制启动菜单主题【免费下载链接】VentoyA new bootable USB solution.项目地址: https://gitcode.com/GitHub_Trending/ve/VentoyVentoy 的启动菜单由 GRUB2 图形终端渲染主题由 theme.txt、一批位图和 U 盘里的 ventoy.json 共同决定。改主题只需动三处theme.txt 管样式位图管外观贴图ventoy.json 管引用与行为。本文按仓库实际结构讲清每处的改法。一个主题由哪些文件构成默认主题放在可启动分区的/ventoy/theme/目录仓库里对应 INSTALL/plugin/ventoy/theme/包含一个theme.txt和二十多张小尺寸 PNG。这些位图遵循 GRUB2 的 9-patch 命名约定同一部件拆成menu_n.png、menu_s.png、menu_ne.png、menu_c.png九块上下左右、四角、中心渲染时自动拉伸拼接所以一张select_c.png就能适应任意菜单宽度。theme.txt 里用通配符menu_*.png一次指认整套文件换图时保持前缀不变即可。主题还允许引用图标目录默认主题带icons/子目录存放发行版识别图标与 ventoy.json 的menu_class配置配合按发行版名称显示对应小图标。把主题放到可启动分区的最小改法最小可行改动只有两件事把主题目录放到可启动分区然后在 ventoy.json 的theme节点里写出路径。路径以/开头时按分区绝对路径解析不带/开头则自动补上ventoy/前缀即相对于可启动分区的ventoy目录。参考 INSTALL/plugin/ventoy/ventoy.json 的写法theme: { file: /ventoy/theme/theme.txt, display_mode: GUI, ventoy_left: 5%, ventoy_top: 95%, ventoy_color: #0000ff }保存后重新从 U 盘启动即生效。注意file指向的是 theme.txt 文件本身不是目录。theme.txt 里真正起作用的参数theme.txt 语法就是 GRUB2 gfxterm 的 theme.txt 格式Ventoy 只在其上追加了几个占位符。常用参数如下参数位置作用desktop-image文件头全屏背景图路径相对于 theme.txt 所在目录left / width / top / height boot_menu内菜单区域定位支持10%这类百分比与95%-25混合写法item_color/selected_item_color boot_menu内菜单项与选中项文字颜色十六进制格式item_height/item_spacing boot_menu内条目高度与行距单位像素menu_pixmap_style/selected_item_pixmap_style boot_menu内通配符指认整套 9-patch 贴图scrollbar/scrollbar_width/scrollbar_thumb boot_menu内ISO 数量多时滚动条的开关与样式 progress_bar独立块配合id __timeout__显示超时倒计时hbox与label块用于在屏幕任意位置放文字这是第四节状态显示的实现基础。字体方面theme.txt 可用font属性按元素指定字体theme.txt 同目录的字体文件由 ventoy.json 的fonts数组加载数组里的文件不存在时启动时会打印 NOT EXIST 提示。在菜单上显示运行时状态Ventoy 往主题系统里加了几个内置占位符写在label的text属性里即可。对应模式未激活时显示为空白不会占位干扰视觉占位符显示内容出现时机VTOY_HOTKEY_TIP当前快捷键提示常态VTOY_MEM_DISK[Memdisk]内存盘模式VTOY_ISO_RAWCompatible ModeISO 直通模式VTOY_GRUB2_MODEGRUB2 Mode以完整 GRUB2 菜单方式启动VTOY_WIMBOOT_MODEWIMBOOT ModeWIMBOOT 模式VTOY_ISO_UEFI_DRVUEFI FS从 UEFI 文件系统启动 ISOGRUB2 自带的TIMEOUT_NOTIFICATION_SHORT、KEYMAP_SHORT也能用另外任何变量名形式的写法会去读 GRUB 同名环境变量可借此自定义信息。默认主题就是这组标签的示例 hbox { left 30% top 95% width 10% height 25 label {text VTOY_HOTKEY_TIP color blue align left} }容易忽略的一点ventoy.json 里的ventoy_left、ventoy_top、ventoy_color并不作用于整个菜单而是控制这组状态文字的落位与颜色默认 5%、95%、#0000ff。想挪动底部那行提示文字改的是这三个键。多主题随机与分辨率匹配theme节点支持把file写成数组列出多个 theme.txt 路径启动时从中挑一个。random字段决定挑选依据boot_second每次启动都重抽boot_day每天固定boot_month每月固定缺省为boot_second。default_file可指定固定使用数组中第几个从 1 计。数组模式下还能开resolution_fit: 1系统按当前分辨率关键字去匹配文件名例如1024x768/theme.txt只在 1024x768 下被选用为不同分辨率各备一套布局提供官方支持。单个主题想锁定分辨率则直接用gfxmode字段指定如1024x768。改了不生效先查这三处编码。ventoy.json 只接受 UTF-8。用 GBK 或带 BOM 的 UTF-8 保存会触发编码检查报错而且报错效果是全部配置不加载不只主题——症状就是所有自定义集体消失。大小写。可启动分区的ventoy目录名和ventoy.json文件名必须全小写启动流程会做路径大小写比对Ventoy、VENTOY都会失败并有明确提示。文件不存在静默回退。file指向的 theme.txt 路径错误时插件只打印一条 does not exist 日志然后继续用默认主题界面不会弹错。改完路径没反应时核对 U 盘上文件实际位置比反复重启更快。⚠️ 最后给两条经验布局尽量用百分比而非像素写死避免高分辨率下菜单挤在角落背景图控制在 1MB 以内theme.txt 与位图放同一目录路径永远相对于 theme.txt 所在目录解析写错相对基准是最常见的背景图不见了原因。【免费下载链接】VentoyA new bootable USB solution.项目地址: https://gitcode.com/GitHub_Trending/ve/Ventoy创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

读完文章,也想定制专属网站?

尧图设计师 24 小时内与您沟通定制方案

免费获取报价 →
↑