mpv.net 媒体播放器完全使用指南

mpv.net 媒体播放器完全使用指南

mpv.net 🎞 mpv.net is a media player for Windows that has a modern GUI. 项目地址: https://gitcode.com/gh_mirrors/mp/mpv.net

概述

mpv.net 是一款基于 mpv 核心的现代化 Windows 媒体播放器，它继承了 mpv 强大的媒体播放能力，同时提供了更友好的图形用户界面。作为 mpv 的衍生版本，mpv.net 几乎完全兼容 mpv 的所有功能，这意味着官方 mpv 手册中的大部分内容同样适用于 mpv.net。

核心特性

1. 跨平台兼容性：基于 mpv 核心，支持几乎所有主流媒体格式
2. 现代化界面：提供直观的图形用户界面，同时保留 mpv 的强大功能
3. 高度可定制：支持丰富的配置选项和脚本扩展
4. 轻量高效：保持 mpv 原有的高性能特点

安装与配置

系统要求

• Windows 10 或更高版本
• .NET Desktop Runtime 6.0 运行环境

安装步骤

1. 下载最新版本的 mpv.net 安装包
2. 运行安装程序或解压便携版
3. 确保系统已安装 .NET 6.0 运行时

文件关联设置

用户可以通过以下方式设置文件关联：

1. 右键菜单：配置 > 设置 > 注册文件关联
2. Windows 文件资源管理器：右键媒体文件 > 打开方式 > 选择其他应用

环境变量配置

为方便在命令行中使用 mpv.net，建议将其添加到系统 PATH 环境变量：

1. 通过右键菜单：配置 > 设置 > 添加 mpv.net 到 PATH 环境变量
2. 或手动添加 mpv.net 安装目录到系统 PATH

核心功能详解

配置文件系统

mpv.net 的配置文件存储在以下位置（按优先级排序）：

1. MPVNET_HOME 环境变量指定的目录
2. 可执行文件目录下的 portable_config 文件夹
3. 系统默认配置目录：%APPDATA%\mpv.net

主要配置文件包括：

• mpv.conf：mpv 核心配置
• mpvnet.conf：mpv.net 特有配置
• input.conf：键盘和鼠标输入绑定
• scripts：用户脚本目录
• script-opts：脚本配置目录

输入控制与上下文菜单

mpv.net 提供丰富的输入控制方式：

1. 全局快捷键：通过 global-input.conf 文件配置
2. 输入测试模式：通过命令行参数 --input-test 启动
3. 上下文菜单：右键播放界面可快速访问常用功能

命令行接口

mpv.net 支持与 mpv 相同的命令行语法：

mpvnet [选项] [文件|URL|播放列表|-]

所有 mpv 支持的属性都可以通过命令行设置，例如：

• 启用边框：--border 或 --border=yes
• 禁用边框：--no-border 或 --border=no

高级功能

终端集成

当从终端启动时，mpv.net 会：

• 将状态、错误和调试信息输出到终端
• 接受来自终端的输入控制

脚本扩展

mpv.net 支持两种脚本语言：

1. Lua 脚本：丰富的用户脚本生态
2. JavaScript：通过 mpv 的 JavaScript API 实现扩展

.NET 扩展

开发者可以创建 .NET 扩展，放置在配置目录的 extensions 子目录中，扩展文件命名需与目录名一致。

颜色主题

mpv.net 支持自定义颜色主题：

1. 内置主题定义位于程序资源中
2. 用户自定义主题可保存在 <配置目录>\theme.conf
3. 通过配置编辑器可设置深色/浅色模式使用的主题

与 mpv 的主要差异

虽然 mpv.net 基于 mpv，但存在一些重要区别：

1. 图形界面：提供完整的 GUI 而不仅是命令行
2. 配置方式：增加 mpvnet.conf 专门配置 GUI 相关选项
3. 扩展机制：支持 .NET 扩展
4. 主题系统：内置颜色主题支持

实用技巧

1. 播放列表管理：使用 --queue 参数添加文件到播放列表
2. 窗口控制：通过 move-window 命令快速调整窗口位置
3. 媒体信息查看：使用 show-media-info 命令获取详细媒体信息
4. 流媒体播放：配合 yt-dlp 工具实现高质量网络流媒体播放

常见问题解决

1. 文件关联不生效：检查 Windows 默认应用设置
2. 脚本不执行：确认脚本放置在正确的 scripts 目录
3. 播放卡顿：尝试调整缓存设置或更换解码器
4. 界面显示异常：检查主题配置或重置为默认设置

进阶应用

VapourSynth 脚本播放

配置 mpv.conf 以支持 .vpy 文件播放：

[extension.vpy]
demuxer-lavf-format = vapoursynth

需确保 Python 和 VapourSynth 已加入 PATH 环境变量。

外部工具集成

1. 浏览器扩展：使用 "Play with mpv" 扩展实现网页视频直接播放
2. 文件资源管理器集成：通过 "Open with++" 增强右键菜单功能
3. 流媒体下载：配合 External Application Launcher 扩展实现视频下载

性能优化建议

1. 硬件加速：根据显卡配置合适的硬件解码选项
2. 缓存设置：网络播放时适当增加缓存大小
3. 进程管理：使用 --process-instance=single 减少资源占用
4. 脚本优化：仅加载必要的用户脚本

通过本指南，用户应能充分利用 mpv.net 的强大功能，获得出色的媒体播放体验。对于更高级的定制需求，建议参考 mpv 官方文档和活跃的用户社区资源。

mpv.net 🎞 mpv.net is a media player for Windows that has a modern GUI. 项目地址: https://gitcode.com/gh_mirrors/mp/mpv.net