Skip to content

Repository files navigation

🎬 MPV Player · 硬核技术交流群

QQ Group Members QQ Group Members


🎯 mpv · 为画质而生,为技术而狂 · mpv 🎯


📌 群信息

QQ ①群1097053691
QQ ②群1104144778
群成员2000,36+
群性质热心发电·免费交流
分享内容配置/脚本/着色器/懒人包
适合人群新手入门·玩家折腾·开发交流
群目标互助·分享·共同折腾
进群暗号mpv 玩家
QQ群二维码 群内讨论截图

mpv-startup-format-logos

GitHub stars GitHub forks GitHub watchers

GitHub Repo stars GitHub forks GitHub issues GitHub watchers GitHub contributors GitHub license

GitHub release (latest by date) GitHub tag GitHub release date GitHub downloads (latest) GitHub downloads License

GitHub last commit GitHub commit activity (monthly) GitHub commit activity (weekly) GitHub commit activity (yearly) GitHub contributors GitHub contributors (anon)

GitHub top language GitHub language count GitHub repo size GitHub code size GitHub file count Lines of Code

Status Maintained MPV Language Platform Translation Chinese


本脚本提取自 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 整合包中提取。

  1. 访问 Yaozhil/mpv-Yaozhi 仓库,下载最新的整合包(Releases 或完整压缩包)。
  2. 解压后,在 portable_config 目录下找到 startup-format-logos 文件夹,
  3. 解压后,在 portable_config/scripts/ 目录下找到 startup-format-logos.lua 文件,
  4. 解压后,在 portable_config/script-opts/ 目录下找到 startup_format_logos.conf 文件,
  5. 解压后,在 portable_config/script-modules/ 目录下找到 startup-logo-bounds.lua 文件,

关于 HDR Vivid / Audio Vivid 识别:要实现 HDR Vivid 和 Audio Vivid 的准确识别,需要使用杳知 编译的 mpv.exe(即 mpv-Yaozhi 整合包中的播放器核心)。标准版 mpv 可能缺少识别这些国产标准所需的特定参数和元数据解析能力。

📦 安装

1. 目录结构

将以下文件放入 你自己的 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-righttop-leftbottom-rightbottom-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 提交问题,并附上:

  1. mpv 版本
  2. 操作系统
  3. mpv.log 日志
  4. 问题的详细描述

📄 许可证

MIT License

版权所有 (c) 2026

特此授予任何获得本软件及相关文档文件的人免费使用本软件的权利,包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售本软件副本的权利,并允许其接收者享有上述权利,但须符合以下条件:

上述版权声明和本许可声明应包含在本软件的所有副本或主要部分中。

本软件按"现状"提供,不作任何明示或暗示的保证,包括但不限于适销性、特定用途适用性和非侵权性的保证。在任何情况下,作者或版权持有人均不对因本软件或本软件的使用或其他交易而产生的任何索赔、损害或其他责任承担责任,无论是在合同诉讼、侵权诉讼还是其他诉讼中。


🙏 致谢

  • mpv-Yaozhi — 本脚本的原始来源,感谢 @Yaozhil 的杰出工作
  • mpv — 强大的媒体播放器

Enjoy! 🎬

About

mpv-startup-format-logos

Topics

Resources

Stars

5 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors