适配版本 Master_commit_220819
ENGLISH | 简体中文
- 关于
- 下载
- 安装
- 支持
- 设置
- 快捷键和上下文菜单
- 命令面板
- 命令行界面
- 终端
- mpv.net的专属命令
- mpv.net的专属选项
- 外部工具
- 脚本
- 扩展
- 配色主题
- 高级功能
- 隐藏功能
- 与mpv的差异
- 技术概览
- 上下文菜单
mpv.net是基于受欢迎的mpv的Windows现代媒体播放器。
mpv.net出于兼容mpv而设计，几乎所有mpv的功能都可用，因为它们都包含在libmpv中，这意味着mpv官方手册 也适用于mpv.net。
mpv专注命令行与终端的使用，而mpv.net保留了这些并加入了现代化的图形界面。
与mpv一样，mpv.net也是为高级用户设计的。
-
winget install mpv.net
mpv.net需要.NET Framework 4.8运行库和高于win7版本的系统以及一张不太旧的显卡。
互联网流媒体需要：
- 下载yt-dlp并将其添加到用户环境变量PATH；
- 在使用代理服务器的情况下，需要手动配置。
可以使用上下文菜单注册文件关联。 'Settings > Setup'
注册完文件关联后，进入 "Windows设置 > 应用 > 默认应用" (Win+I, ms-settings:defaultapps) 然后选择mpv. net作为视频/音频/图像的默认程序。
另一种注册文件关联的方式是使用文件资源管理器，选中媒体文件后，选择上下文菜单的 '打开方式 > 选择其它应用' 。
Open with++ 可用来扩展资源管理器的上下文菜单。Play with mpv.net 和 Add to mpv.net playlist 可用来获取 'Play with mpv.net' 和 'Add to mpv.net playlist' 的菜单子项
当在资源管理器中选择多个文件并按 enter 键时，文件会在mpv.net随机排序打开，最多限制15个文件。
在提出支持请求之前，先尝试最新的 测试版。
可以在这些地方请求支持：
初学者提问：
mpv.net的错误报告、功能请求和高级问题：
https://github.com/mpvnet-player/mpv.net/issues
高级的mpv问题：
https://github.com/mpv-player/mpv/issues
mpv.net在以下路径寻找设置文件夹：
- <程序启动目录>\portable_config
- %APPDATA%\mpv.net (
C:\Users\%USERNAME%\AppData\Roaming\mpv.net)
mpv的选项保存在mpv.conf文件中，mpv.net的专属选项保存在 mpvnet.conf 文件中，参数解释请参阅 此处
键鼠的快捷键和上下文菜单的操作保存在 input.conf 文件中，如果设置目录中不存在，mpv.net会用默认值生成它。
请注意，一旦 input.conf 存在， mpv.net 就不能更新它，这意味着当 mpv.net 升级了新的版本或改变了的默认菜单项时，菜单条目就会过时。获得最新菜单的唯一方法是通过删除 input.conf 来重置菜单，或者通过手动编辑 input.conf 来更新它。
通过 global-input.conf 文件支持全局热键。
设置文件夹可以从上下文菜单中打开： Settings > Open Config Folder
input 和 config editor 可以在上下文菜单的该条目中找到 'Settings'
输入测试模式可以通过命令行启动： --input-test
输入的键位列表可由该参数输出 --input-keylist 或从上下文菜单的该条目获取 View > Advanced > Show Keys
mpv.net的默认input.conf文件： https://github.com/mpvnet-player/mpv.net/blob/master/src/Resources/input.conf.txt
mpv的默认input.conf文件： https://github.com/mpv-player/mpv/blob/master/etc/input.conf
mpv的命令： https://mpv.io/manual/master/#list-of-input-commands
mpv的input选项： https://mpv.io/manual/master/#input
命令面板能用来快速查找、选择和执行命令。
它也可以用来方便的找到快捷键。
命令面板提供了以下功能：
- 以不同方式显示 mediainfo
- 显示和选择音轨
- 显示和选择字幕轨
- 显示和选择播放列表的文件
- 显示和选择最近的文件
- 显示可用的mpv属性
- 显示可用的解码器
- 显示可用的解复用器
- 显示可用的按键
- 显示可用的协议
| 按键 | 动作 |
|---|---|
| F1 | 显示命令面板 |
| Esc | 隐藏命令面板 |
| Enter | 执行所选的条目 |
| Up | 光标向上移动 |
| Down | 光标向下移动 |
mpvnet [options] [file|URL|PLAYLIST|-]
mpvnet [options] files
mpv的参数与mpv.net共通，例如：
启用窗口装饰：
--border or --border=yes
禁用窗口装饰：
--no-boder or --border=no
所有支持的mpv属性，参阅此处：
https://mpv.io/manual/master/#properties
mpv.net可以使用以下功能列出所有可用的属性：
Context Menu > View > Advanced > Show Properties
mpv有一些基于非属性的开关，在mpv.net中一般不受支持。
当mpv. net从终端启动时，它将输出状态、错误和调试消息，并接受终端的输入。
终端的常见用处是脚本调试。
script-message-to mpvnet <command> <arguments>
mpv.net命令可在mpv命令不存在或缺乏某种功能时使用。
切换到下一个音轨并显示该音轨的信息。
显示一个资源管理器的对话框来加载外部音频文件。
显示一个资源管理器的对话框来加载外部字幕文件。
将窗口移动到屏幕边缘 (Alt+方向键) 或中心 (Alt+Backspace)。
用Windows资源管理器打开配置文件夹。
append
追加文件到播放列表中。
打开一个资源管理器的对话框，以便选择要打开的文件。资源管理器的对话框支持多选以一次性加载多个文件。按住CTRL键可以将这些文件追加到播放列表中。
显示一个资源管理器的对话框来打开一个DVD或BD文件夹。ISO镜像不需要被挂载，但可以直接用 open-files 命令打开。
从剪贴板打开单个的URL或文件路径，或以文件剪贴板中的格式打开多个文件。
循环切换 pause 的属性。如果播放列表为空，将加载最近文件列表中的最新文件。
通过指定的整数值来跳转播放的条目。如果已到达末尾则它会跳到开头，反之亦然。
跳转到播放列表的第一个条目，如果加载的文件已经是第一个条目，则无动作。
跳转到播放列表的最后一个条目，如果加载的文件已经是最后一个条目，则无动作。
跳转到播放列表的任一条目。
第一次触发时，书签被保存，第二次触发时，它被恢复并移除。当加载新文件时，书签也会被移除。
注册文件关联。
减小或增大窗口的尺寸。
显示命令面板以选择一个profile。
Shell执行单个文件或URL。
显示 "关于" 的对话框。
在一个信息框中显示可用的音频设备。
在命令面板中显示可用的音轨，并允许加载选中的音轨。
在命令面板中显示章节。
显示命令面板。
显示可用的mpv输入命令。
显示配置编辑器。
显示可用的解码器。
显示可用的解复用器。
显示已有的历史文件。
显示器快捷键编辑器。
在命令面板中显示可用的按键。（与 --input-keylist 显示的内容一致）
msgbox
在一个信息框中显示mediainfo
editor
在一个文本编辑器中显示mediainfo
osd OSD上显示mediainfo
full
显示mediainfo的完整细节
raw
显示带有原始属性名的mediainfo
显示上下文菜单。
在命令面板中显示播放列表，并允许播放选中的条目。
用一个信息框显示可用的profile
显示一个简易的OSD进度条信息，附带时间和日期。
在命令面板中显示可用的属性，并允许显示所选属性的值。
在命令面板中显示可用的协议。
在命令面板中显示最近播放的文件和URL，并允许选择和播放条目。
在命令面板中显示可用的字幕轨，并允许激活选中的字幕。
显示一个具有指定文本、持续时间和字体大小的OSD信息。
职能类似于mpv的属性 window-scale
这些专属选项可以在 conf editor 中使用关键词 "mpv.net" 检索。
这些专属选项被修改后被保存在 mpvnet.conf 文件中。
音频文件的初始窗口高度，以百分比为单位。默认：70
图片文件的初始窗口高度，以百分比为单位。默认：80
添加文件到播放列表，需要设置 --process-instance=single 。也可以在资源管理器中使用 Open with++ 添加文件。
通过命令行向正在运行的mpv.net实例发送输入命令，例如使用 AutoHotkey 创建全局热键，必须设置 process-instance=single 。
在程序退出时保存音量并静音，在启动时恢复之前的音量。默认：yes
设置为记住窗口大小。
width-session
记住当前的宽度。
width-always
始终记住宽度。
height-session
记住当前的高度。（默认值）
height-always
始终记住高度。
video
窗口大小设置为视频分辨率。
session 记住当前进程的大小。
always
始终记住大小。
最小宽高比，如果窗口宽高比小于定义的值，那么将窗口的宽高比将被强制设为该值。
同上但仅用于音频文件。
在退出时保存窗口的位置。默认：no
在显示窗口之前等待libmpv返回视频分辨率的阈值（毫秒），否则将使用由 --autofit 和 --start-size 定义的初始大小。默认：1500
打开单个文件时，自动将整个目录加载到播放列表中。可以通过 shift 键临时禁用。默认：yes
如果在播放器暂停时，加载另一个文件，会自动恢复播放。
定义是否允许多个 mpv.net 进程。
当打开文件或 url 时，只要按下CTRL键，就不会清除当前的播放列表，而只将文件或 url 追加到列表中。这不仅适用于进程启动，也适用于所有打开文件和 url 的功能。
也可以通过按住SHIFT键来启动多个进程。
multi
每次从 shell 启动 mpv.net 时创建一个新进程。
single
每次从 shell 启动 mpv.net 只允许唯一一个进程。（默认值）
queue
和 single 类似但会把文件追加到已打开的mpv.net的播放列表中。
最近文件的记录数量。默认：15
使用MediaInfo而不是mpv来访问媒体信息。默认：yes
要从历史日志功能中排除的路径的分号分隔列表。
用于创建文件关联的视频文件扩展名，由自动加载文件夹的功能使用。
用于创建文件关联的音频文件扩展名，由自动加载文件夹的功能使用。
用于创建文件关联的图片文件扩展名，由自动加载文件夹的功能使用。
只有在开发人员要求时才启用此选项。默认：no
启用深色模式.
always
始终（默认值）
system
跟随系统。（需要win10及以上的系统）
never 从不
深色模式中使用的配色主题。默认：dark
浅色模式中使用的配色主题。默认：light
在原始OSC标志的基础上绘制蓝色的mpvnet图标。默认：yes
在12月绘制蓝色的mpvnet图标时使用圣诞彩蛋。默认：yes
Play with mpv 是一个支持调用mpv播放YouTube等网站视频的谷歌浏览器的扩展。
由于Chrome扩展无法启动一个应用程序，需要另一个与扩展程序通信的应用程序，该程序可以从此处下载。只有当该程序运行时扩展才能正常工作，为了让应用程序始终运行，应将其放在系统自启动目录中：
C:\Users\%username%\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup
这将使该程序随系统共同启动，并在后台运行。当mpv.net的文件关联注册被执行后，该程序应该会找到mpv.net的位置，或者将mpv.net文件夹添加到环境变量PATH。
或者可以使用Chrome/Firefox扩展 Open With 。
Open with++ 可用来扩展资源管理器的上下文菜单。Play with mpv.net 和 Add to mpv.net playlist 可用来获取 'Play with mpv.net' 和 'Add to mpv.net playlist' 的菜单子项
视频可以通过Chrome扩展程序的外部应用按钮进行流式传输或轻松下载，对于下载（推荐）：
path: wt
args: -- pwsh -NoLogo -Command "yt-dlp --ignore-errors --download-archive 'C:\External Application Button.txt' --output 'C:\YouTube\%(channel)s - %(title)s.%(ext)s' ('[HREF]' -replace '&list=.+','')"
可以在 mpv wiki 中找到一个庞大的用户Lua脚本的集合。
Lua脚本在 mpv.net wiki 上有进一步记录。
文件位置： <config folder>\scripts-ps
PS脚本在打开媒体文件前尚未初始化。
文件位置： <config folder>\scripts-cs
没有兼容性保证。
脚本代码可以在C#扩展中编写，这样就可以获得完整的代码和调试器支持。一旦代码被调试和开发完成，就可以将其从扩展转移到轻量级的独立脚本。脚本host使用的是旧的C#版本，像字符串插值这样的现代功能是不存在的。
有同步事件和异步事件，更偏好异步事件，不要阻断同步事件和观察到的属性，因为这样会阻断主事件循环。
C#脚本的host类似于扩展，在打开媒体文件前尚未初始化。
扩展位于设置目录的子文件夹 'extensions' 中，文件名必须与上级文件夹具有相同的名称：
<config folder>\extensions\ExampleExtension\ExampleExtension.dll
有同步事件和异步事件，更偏好异步事件，不要阻断同步事件和观察到的属性，因为这样会阻断主事件循环。
- 下载安装 Visual Studio Community 。
- 创建新的项目类型 Class Library .NET Framework 并确保项目名称以 Extension 作结尾。
- 增加一个 reference 到 System.ComponentModel.Composition.
- 增加一个 reference 到 mpvnet.exe ，在 Solution Explorer 中选择 mpvnet 的 reference ，打开 Properties 窗口并设置 Copy Local 为 false 来阻止在项目编译时 mpvnet.exe 被复制到输出目录。
- 现在打开 project properties 并在 Build 标签页设置 output path ，扩展类似于位于配置文件夹中的脚本，例如：
<config folder>\extensions\ExampleExtension\ExampleExtension.dll - 同样在 project properties 的 Debug 标签页中选择选项 Start external program 并且定义到 mpvnet.exe 的路径。在 Debug 标签页中你还可以定义 command line arguments ，例如开始调试时要播放的视频文件。
当mpv.net关闭时，这个扩展程序会对分级视频的文件名进行记录。
'input.conf defaults' 包含了用于设置评级扩展的键位绑定。
mpv.net支持自定义配色主题，内置主题的定义可以在以下文件中查看：
自定义的配色方案保存在以下文件中：
<conf folder>\theme.conf
theme.conf 文件可包含无限量的主题。
在 config editor 的 UI 词条中存在 dark-theme 和 light-theme 的设置来定义主题应用在深色/浅色模式。
播放vpy文件的功能受 mpv.conf 中的以下参数支持：
[extension.vpy]
demuxer-lavf-format = vapoursynth
Python和VapourSynth必须在环境变量PATH中。
使用mpv.net在资源管理器中选择多个文件并按下回车键打开。资源管理器将此限制为最多15个并且顺序将是随机的。
当打开文件或url时，只要按下CTRL键，就不会清除播放列表，而是将文件或url附加到播放列表中。这适用于mpv.net的所有打开文件或url的功能。
在打开单个文件时按下SHIFT键将禁止该文件夹的其它文件添加到播放列表中。
在全屏模式下点击顶部右上角关闭播放器。
mpv.net被设计的和mpv大体一致，但是有一些限制：
mpv.net实现了一个自己的主窗口，这意味着只有在mpv.net中有自己实现的mpv窗口功能才受支持。
当前不支持无窗口模式，即使从终端启动mpv.net并播放音乐，主窗口也始终可见。
mpv窗口特性的文档可以在此处找到：
https://mpv.io/manual/master/#window
mpv.net目前已实现了以下窗口属性：
- border
- fullscreen
- keepaspect-window
- ontop
- screen
- snap-window
- title
- window-maximized
- window-minimized
- window-scale
部分支持的属性：
- autofit 仅支持0-100范围内的整数
- autofit-smaller 同上
- autofit-larger 同上
mpv.net的专属窗口功能在 屏幕设置 部分。
mpv.net支持基于属性的mpv命令行选项，这意味着它支持mpv几乎所有的命令行选项。
不支持的是非基于属性的选项。它们在mpv.net中有自己的实现，到目前为止实现的有：
--ad=help
--audio-device=help
--input-keylist
--profile=help
--vd=help
--version
mpv的属性 idle 在mpv.net中也会相应的发挥作用，但是LUA脚本获取到的值始终是 yes ，因为mpv.net必须设置它才能正常工作，这是一个难以攻克的来自libmpv的限制。
在config editor中输入 mpv.net 检索这些选项，在此处的手册中有对应说明。
mpv.net的专属选项保存在 mpvnet.conf 文件中，与mpv一样可由命令行界面获取。
mpv.net使用 C#7 编写并且需要 .NET Framework 4.8 来运行。
扩展的实现基于 Managed Extensibility Framework
主窗口基于WinForms，与WPF相比对libmpv集成的更友好，所有其他窗口都是基于WPF的。
使用的第三方组件：
mpv.net的上下文菜单由设置目录中的文件 input.conf 定义。
如果 input.conf 文件不存在，mpv.net由以下文件生成默认：
https://github.com/mpvnet-player/mpv.net/tree/master/src/Resources/input.conf.txt
input.conf 定义mpv的快捷键，同时mpv.net使用注释定义上下文菜单。
菜单中的打开文件是在mpv.net中打开文件的一种方式，它支持多选。
打开文件的另一种方法是现有关联的文件资源管理器使用命令行。
第三种方法是拖放文件到主窗口上。
每当打开文件或URL时按下控制键时，播放列表不会被清除，但文件或URL会追加到播放列表中。这适用于所有打开文件或URL的mpv.net的功能。
在打开单个文件时按shift键将临时禁止加载文件夹中的其它文件。
支持Blu-ray和DVD的ISO镜像文件。
从剪贴板打开文件和URL。如何从YouTube等网站的浏览器中直接打开url在外部工具部分进行了描述。
打开DVD/Blu-ray的驱动器/文件夹。
允许加载外部音轨文件。也可以根据文件名自动检测，该选项可在下面的设置中找到 'Settings > Show Config Editor > Audio > audio-file-auto'
允许加载外部字幕文件。也可以根据文件名自动检测，该选项可在下面的设置中找到 'Settings > Show Config Editor > Subtitles > sub-auto'
使用以下命令播放/暂停：
cycle pause
使用以下命令中止播放并关闭播放列表：
stop
使用以下命令切换全屏的状态：
cycle fullscreen
使用以下命令跳转播放列表中的上一个文件：
playlist-prev
使用以下命令跳转播放列表中的下一个文件：
playlist-next
使用以下命令跳转下一章节：
add chapter 1
使用以下命令跳转上一章节：
add chapter -1
使用以下命令跳转下一帧：
frame-step
使用以下命令跳转上一帧：
frame-back-step
使用以下命令跳转（无OSD信息）：
no-osd seek sec
sec是跳转的相对秒数，使用no osd前缀是因为mpv.net包含一个脚本，该脚本显示执行寻道操作时的位置，该脚本使用更简单的时间格式。
使用以下命令放大0.1视频尺寸：
add video-zoom 0.1
使用以下命令缩小0.1视频尺寸：
add video-zoom -0.1
add video-pan-x -0.01
video-pan-x, video-pan-y property
add video-pan-x 0.01
video-pan-x, video-pan-y property
add video-pan-y -0.01
video-pan-x, video-pan-y property
add video-pan-y 0.01
video-pan-x, video-pan-y property
add panscan -0.1
add panscan 0.1
重置平移、缩放的状态，同一行中的多个命令用“分号”分隔。
set video-zoom 0; set video-pan-x 0; set video-pan-y 0
video-pan-x, video-pan-y property
使用以下命令减少1对比度：
add contrast -1
使用以下命令增加1对比度：
add contrast 1
使用以下命令减少1亮度：
add brightness -1
使用以下命令增加1亮度：
add brightness 1
使用以下命令减少1伽马：
add gamma -1
使用以下命令增加1伽马：
add gamma 1
使用以下命令减少1饱和度：
add saturation -1
使用以下命令增加1饱和度：
add saturation 1
async screenshot
使用以下命令改变去隔行扫描的状态：
cycle deinterlace
使用以下命令改变长宽比：
cycle-values video-aspect 16:9 4:3 2.35:1 -1
使用mpv.net的命令改变到下一个可用的音轨并且不跳过音轨关闭（比mpv原生指令更好）
使用以下命令增加0.1音频延迟：
add audio-delay 0.1
使用以下命令减少0.1音频延迟：
add audio-delay -0.1
使用以下命令改变到下一个可用的字幕轨：
script-message-to mpvnet cycle-subtitles
使用以下命令改变字幕可见性的状态：
cycle sub-visibility
使用以下命令减少0.1字幕延迟：
add sub-delay -0.1
使用以下命令增加0.1字幕延迟：
add sub-delay 0.1
使用以下命令上移1字幕位置：
add sub-pos -1
使用以下命令下移1字幕位置：
add sub-pos 1
使用以下命令减少0.1字幕尺寸：
add sub-scale -0.1
使用以下命令增加0.1字幕尺寸：
add sub-scale 0.1
使用以下命令增加10音量：
add volume 10
使用以下命令减少10音量：
add volume -10
使用以下命令改变静音状态：
cycle mute
使用以下命令递退1.1倍的播放速度：
multiply speed 1/1.1
使用以下命令递进1.1倍的播放速度：
multiply speed 1.1
使用以下命令半速播放：
multiply speed 0.5
使用以下命令倍速播放：
multiply speed 2
使用以下命令重置播放速度：
set speed 1
一个将评级写入文件名的插件。
使用以下命令启用播放器置顶：
set ontop yes
使用以下命令禁用播放器置顶：
set ontop no
使用mpv.net的命令显示当前文件的信息（持续时间、位置、格式、大小和文件名）。
使用以下命令临时显示数据统计：
script-binding stats/display-stats
使用以下命令切换数据统计的状态：
script-binding stats/display-stats-toggle
使用以下命令切换OSC可见性的状态：
script-binding osc/visibility
使用以下命令显示5秒的（原生OSD）播放列表：
show-text ${playlist} 5000
使用以下命令显示5秒的轨道信息列表：
show-text ${track-list} 5000
显示mpv.net的设置编辑器
显示mpv.net的快捷键编辑器
打开包含以下文件的设置文件夹：
mpv.conf 文件内涵mpv的设置
mpvnet.conf 文件内涵mpvnet的设置
input.conf 文件内涵mpv的键鼠绑定
用户脚本和扩展
显示命令面板，该窗口允许快速查找、执行命令和快捷键。
显示包含历史记录的文本文件。如果文件不存在，则会询问是否在设置文件夹中创建该文件。一旦文件存在，则写入历史记录（包括时间和文件名）
屏蔽部分路径的参数：
script-opt = history-discard=path1;path2
使用以下命令创建单个片段循环：
ab-loop
使用以下命令改变当前文件的循环播放的状态：
cycle-values loop-file "inf" "no"
使用以下命令改变硬件解码的状态：
cycle-values hwdec "auto" "no"
允许管理文件关联。
显示 mpv官方手册.
显示 mpv.net 网站.
显示 mpv.net手册.
显示mpv.net的关于信息。
使用以下命令退出mpv.net：
quit
使用以下命令退出mpv.net并且记住文件状态：
quit-watch-later