🎯 mpv · 为画质而生,为技术而狂 · mpv 🎯
|
|
本脚本提取自 Yaozhil/mpv-Yaozhi 整合包,是其中"专业起播格式标识"功能的独立实现。感谢 @Yaozhil 为 mpv 中文社区所做的卓越贡献! 🙏
在 mpv 播放器启动时,于画面角落显示当前视频/音频格式的徽章(如 Dolby Vision、Dolby Atmos、HDR10+、FLAC 等)。
- 🎬 视频格式识别:Dolby Vision、HDR Vivid、HDR10+、HDR10、HLG、SDR
- 🔊 音频格式识别:Dolby Atmos、DTS:X、Audio Vivid、Dolby TrueHD、DTS-HD MA、DTS-HD HRA、Dolby Digital Plus、Dolby Digital、DTS、AC-4、MPEG-H、FLAC、ALAC、PCM、MLP、WavPack、APE、WMA、Opus、AAC、Vorbis、MP3
- 🎨 两种样式:彩色徽章 / 透明白色图标
- 📐 智能定位:自动检测黑边(含蓝光编码黑边),将徽章置于画面安全区内
- 📱 横竖屏自适应:自动适配横屏/竖屏比例
- 🎞️ 多音轨支持:切换音轨时自动刷新显示
- ⚡ 淡入淡出动画
- 🔧 高度可配置:优先级、位置、缩放、停留时间等全部可调
- 访问 Yaozhil/mpv-Yaozhi 仓库,下载最新的整合包(Releases 或完整压缩包)。
- 解压后,在
portable_config目录下找到startup-format-logos文件夹, - 解压后,在
portable_config/scripts/目录下找到startup-format-logos.lua文件, - 解压后,在
portable_config/script-opts/目录下找到startup_format_logos.conf文件, - 解压后,在
portable_config/script-modules/目录下找到startup-logo-bounds.lua文件,
关于 HDR Vivid / Audio Vivid 识别:要实现 HDR Vivid 和 Audio Vivid 的准确识别,需要使用杳知 编译的
mpv.exe(即mpv-Yaozhi整合包中的播放器核心)。标准版 mpv 可能缺少识别这些国产标准所需的特定参数和元数据解析能力。
将以下文件放入 你自己的 mpv 的 portable_config 目录:
portable_config/
│
├── script-assets/
│ └── startup-format-logos/ → LOGO 图片资源(.bgra 格式)
│
│
├── scripts/
│ └── startup-format-logos.lua → 主脚本
│
│
├── script-modules/
│ └── startup-logo-bounds.lua → 依赖模块(关键!)
│
│
└── script-opts/
└── startup_format_logos.conf → 配置文件
配置文件 script-opts/startup_format_logos.conf 中的完整选项:
| 选项 | 默认值 | 说明 |
|---|---|---|
enabled |
yes |
是否启用 |
style |
color |
color = 彩色徽章,white = 透明白色图标 |
show_video |
yes |
是否显示画面标准 Logo |
show_audio |
yes |
是否显示音频标准 Logo |
show_sdr |
yes |
是否为普通 SDR 画面显示彩色 SDR 徽章 |
show_common_audio |
yes |
是否显示 FLAC、PCM、AAC、Opus、MP3 等常见音频格式徽章 |
require_video |
no |
是否只在存在真实视频轨时显示 |
filename_fallback |
yes |
是否允许从文件名/媒体标题/路径补充识别 |
show_on_audio_change |
yes |
切换音轨后是否短暂显示新的音频格式 Logo |
| 选项 | 默认值 | 说明 |
|---|---|---|
position |
top-right |
位置:top-right、top-left、bottom-right、bottom-left |
anchor_to_video |
yes |
是否以实际视频画面边界为定位基准 |
detect_encoded_bars |
yes |
是否检测编码进视频帧的黑边(常见于蓝光 ISO) |
encoded_bar_threshold |
16 |
黑边 RGB 阈值(0-48),越高越容易识别较浅的黑边 |
encoded_bar_delay |
0.18 |
等待画面稳定后抽样编码黑边的时间(秒) |
margin_x |
60 |
水平安全边距(随分辨率自动缩放) |
margin_y |
38 |
垂直安全边距(随分辨率自动缩放) |
| 选项 | 默认值 | 说明 |
|---|---|---|
scale |
1.0 |
整体缩放倍率 |
portrait_scale |
1.18 |
竖屏模式下徽章额外倍率 |
| 选项 | 默认值 | 说明 |
|---|---|---|
delay |
0.45 |
等待画面就绪后延迟显示的时间(秒) |
hold |
4.0 |
完全显示后的停留时间(秒) |
fade_in |
0.12 |
淡入时间(秒),设为 0 关闭 |
fade_out |
0.18 |
淡出时间(秒),设为 0 关闭 |
frame_wait_timeout |
5.0 |
等待首帧的最长时间(秒) |
| 选项 | 默认值 | 说明 |
|---|---|---|
retry_interval |
0.25 |
轨道信息未就绪时的重试间隔(秒) |
retry_count |
8 |
最大检测次数 |
video_priority |
dolby-vision,hdr-vivid,hdr10-plus,hdr10,hlg,sdr |
视频格式优先级 |
audio_priority |
dolby-atmos,dts-x,audio-vivid,... |
音频格式优先级 |
| 选项 | 默认值 | 说明 |
|---|---|---|
asset_dir |
~~/script-assets/startup-format-logos/runtime |
资源目录 |
overlay_id |
50 |
占用的 overlay ID(连续三个,默认 50、51、52) |
可通过 mp.commandv("script-message", ...) 调用:
| 消息 | 参数 | 说明 |
|---|---|---|
startup-format-logos-show |
无 | 手动触发检测并显示 |
startup-format-logos-preview |
<video_slug> <audio_slug> |
预览指定格式组合 |
startup-format-logos-hide |
无 | 隐藏 Logo |
startup-format-logos-toggle |
无 | 开关启用状态 |
startup-format-logos-set-style |
color / white |
切换样式 |
| Slug | 显示名称 | 检测方式 |
|---|---|---|
dolby-vision |
Dolby Vision | 轨道参数 + 文件名 |
hdr-vivid |
HDR Vivid | 轨道参数 + 文件名 |
hdr10-plus |
HDR10+ | 轨道参数 + 文件名 |
hdr10 |
HDR10 | PQ 传输曲线 + 文件名 |
hlg |
HLG | HLG 传输曲线 + 文件名 |
sdr |
SDR | 常规 SDR 内容 |
| Slug | 显示名称 | 检测方式 |
|---|---|---|
dolby-atmos |
Dolby Atmos | 元数据 + 文件名 |
dts-x |
DTS:X | 文件名 |
audio-vivid |
Audio Vivid | 编解码器 + 文件名 |
dolby-truehd |
Dolby TrueHD | 编解码器 + 文件名 |
dts-hd-ma |
DTS-HD MA | 编解码器 + 文件名 |
dts-hd-hra |
DTS-HD HRA | 编解码器 + 文件名 |
dolby-digital-plus |
Dolby Digital Plus | 编解码器 + 文件名 |
dolby-digital |
Dolby Digital | 编解码器 + 文件名 |
dts |
DTS | 编解码器 + 文件名 |
ac4 |
AC-4 | 编解码器 |
mpeg-h |
MPEG-H | 编解码器 |
flac |
FLAC | 编解码器 |
alac |
ALAC | 编解码器 |
pcm |
PCM | 编解码器 |
mlp |
MLP | 编解码器 |
wavpack |
WavPack | 编解码器 |
ape |
APE | 编解码器 |
wma |
WMA | 编解码器 |
opus |
Opus | 编解码器 |
aac |
AAC | 编解码器 |
vorbis |
Vorbis | 编解码器 |
mp3 |
MP3 | 编解码器 |
请前往 Issues 提交问题,并附上:
- mpv 版本
- 操作系统
mpv.log日志- 问题的详细描述
MIT License
版权所有 (c) 2026
特此授予任何获得本软件及相关文档文件的人免费使用本软件的权利,包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售本软件副本的权利,并允许其接收者享有上述权利,但须符合以下条件:
上述版权声明和本许可声明应包含在本软件的所有副本或主要部分中。
本软件按"现状"提供,不作任何明示或暗示的保证,包括但不限于适销性、特定用途适用性和非侵权性的保证。在任何情况下,作者或版权持有人均不对因本软件或本软件的使用或其他交易而产生的任何索赔、损害或其他责任承担责任,无论是在合同诉讼、侵权诉讼还是其他诉讼中。
- mpv-Yaozhi — 本脚本的原始来源,感谢 @Yaozhil 的杰出工作
- mpv — 强大的媒体播放器
Enjoy! 🎬