mpv 播放器

主题

OSD 选项 ​

本节列出 mpv 的屏幕显示选项。

OSD 级别 ​

OSD 级别设置 ​

bash
# 禁用 OSD
osd-level=0

# 仅显示进度条
osd-level=1

# 显示进度条和计时器
osd-level=2

# 显示所有信息
osd-level=3

OSD 持续时间 ​

bash
# OSD 显示持续时间（毫秒）
osd-duration=2000

# 禁用自动隐藏
osd-duration=0

OSD 字体 ​

字体设置 ​

bash
# OSD 字体
osd-font="Noto Sans CJK SC"

# OSD 字体大小
osd-font-size=40

# OSD 字体颜色
osd-color="#FFFFFFFF"

# OSD 边框颜色
osd-border-color="#FF000000"

# OSD 边框大小
osd-border-size=2

# OSD 阴影颜色
osd-shadow-color="#80000000"

# OSD 阴影偏移
osd-shadow-offset=2

字体样式 ​

bash
# OSD 字体样式
osd-font-style=normal
osd-font-style=italic
osd-font-style=bold

# OSD 字体粗细
osd-font-weight=normal
osd-font-weight=bold

进度条 ​

进度条显示 ​

bash
# 显示进度条
osd-bar=yes

# 禁用进度条
osd-bar=no

进度条样式 ​

bash
# 进度条位置
osd-bar-align-x=center
osd-bar-align-y=bottom

# 进度条大小
osd-bar-w=80
osd-bar-h=2

# 进度条颜色
osd-bar-color="#FFFFFFFF"
osd-bar-border-color="#FF000000"
osd-bar-border-size=1

进度条内容 ​

bash
# 进度条样式
osd-bar-style=auto
osd-bar-style=none
osd-bar-style=progress
osd-bar-style=seek

OSD 信息 ​

信息显示 ​

bash
# 显示媒体标题
osd-msg-title=yes

# 显示播放时间
osd-msg-time=yes

# 显示音量
osd-msg-volume=yes

# 显示字幕信息
osd-msg-sub=yes

信息格式 ​

bash
# 标题格式
osd-msg-title="${media-title}"

# 时间格式
osd-msg-time="${time-pos}/${time-remain}"

# 音量格式
osd-msg-volume="Volume: ${volume}%"

OSD 菜单 ​

OSC 菜单 ​

bash
# 启用 OSC
osc=yes

# OSC 样式
script-opts=osc-layout=bottombar
script-opts=osc-deadzonesize=0
script-opts=osc-minmousemove=3

菜单配置 ​

bash
# 菜单字体
script-opts=osd-font="Noto Sans CJK SC"

# 菜单大小
script-opts=osd-font-size=20

OSD 调试 ​

调试信息 ​

bash
# 显示 OSD 信息
mpv --msg-level=all=v video.mp4

# 测试 OSD
mpv --osd-level=3 video.mp4

OSD 测试 ​

bash
# 测试 OSD 显示
mpv --osd-level=3 --osd-duration=5000 video.mp4

# 测试进度条
mpv --osd-bar=yes video.mp4

OSD 脚本 ​

Lua 脚本 OSD ​

lua
-- 显示 OSD 消息
mp.osd_message("Hello World", 2)

-- 显示自定义 OSD
mp.add_key_binding('ctrl+o', 'show-info', function()
    local title = mp.get_property('media-title')
    local time = mp.get_property('time-pos')
    mp.osd_message(string.format('Title: %s\nTime: %s', title, time), 3)
end)

JavaScript 脚本 OSD ​

javascript
// 显示 OSD 消息
mp.osd_message("Hello World", 2);

// 显示自定义 OSD
mp.add_key_binding('ctrl+o', 'show-info', function() {
    const title = mp.get_property('media-title');
    const time = mp.get_property('time-pos');
    mp.osd_message(`Title: ${title}\nTime: ${time}`, 3);
});

下一步 ​