mpv 播放器

主题

PSEUDO GUI MODE（伪 GUI 模式） ​

mpv 没有官方 GUI，除了 OSC（ON SCREEN CONTROLLER），它不是完整的 GUI，也不打算成为完整的 GUI。但是，为了补偿缺少预期 GUI 行为，mpv 在某些情况下会以某些设置启动，使其行为稍微更像 GUI 模式。

启用条件 ​

目前，仅在以下情况下发生：

  • 在 Linux 上使用 mpv.desktop 文件启动时（例如从桌面环境提供的菜单或文件关联启动）
  • 在 Windows 上从 explorer.exe 启动时（从技术上讲，如果它在 Windows 上启动，并且所有 stdout/stderr/stdin 句柄都未设置）
  • 在 macOS 上从 bundle 启动时
  • 如果您在命令行上手动使用 --player-operation-mode=pseudo-gui

内置配置文件 ​

此模式应用来自内置配置文件 builtin-pseudo-gui 的选项，但仅当这些选项未在用户的配置文件或命令行中设置时，这是与使用 --profile=builtin-pseudo-gui 的主要区别。

配置文件当前定义如下：

bash
[builtin-pseudo-gui]
terminal=no
force-window=yes
idle=yes
screenshot-directory=~~desktop/

兼容性配置文件 ​

pseudo-gui 配置文件存在是为了兼容性。pseudo-gui 配置文件中的选项是无条件应用的。此外，配置文件确保启用伪 GUI 模式，因此 --profile=pseudo-gui 可以像在旧版 mpv 中一样工作：

bash
[pseudo-gui]
player-operation-mode=pseudo-gui

警告

目前，您可以正常方式在配置文件中扩展 pseudo-gui 配置文件。这已弃用，将在未来的 mpv 版本中删除。

作为替代方案，可以使用条件自动配置文件：

bash
[gui]
profile-cond=p["player-operation-mode"]=="pseudo-gui"
idle=once

伪 GUI 行为 ​

在伪 GUI 模式下，mpv 会：

  • 禁用终端输出
  • 强制显示窗口
  • 启用空闲模式（没有文件时也显示窗口）
  • 将截图保存到桌面

配置示例 ​

bash
# 启用伪 GUI 模式
player-operation-mode=pseudo-gui

# 自定义伪 GUI 行为
[pseudo-gui]
terminal=no
force-window=yes
idle=yes
screenshot-directory=~/Pictures/mpv

相关链接 ​