Skip to content

About

MPV 播放器配置文件可视化设置工具,无需手动编辑 mpv.conf,轻松管理各项参数。A GUI tool to configure MPV player settings without manually editing mpv.conf.

Resources

Code of conduct

Contributing

Security policy

Stars

19 stars

Watchers

0 watching

Forks

Repository files navigation

🎬 MPV Player · 硬核技术交流群

QQ Group Members QQ Group Members


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


📌 群信息

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

MPVConfig

✨ MPV 播放器配置文件可视化设置工具 · 无需手动编辑 mpv.conf · 绿色便携双击即用 ✨

GitHub stars GitHub forks GitHub watchers

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

GitHub last commit GitHub commit activity (monthly) GitHub contributors GitHub issues

GitHub repo size GitHub code size Lines of Code

Status Maintained MPV Language Platform Portable Offline

Important

🚫 非商业使用声明

本项目仅供 个人学习、研究和非商业用途 使用,严禁任何形式的商业使用, 包括但不限于收费、将本工具打包进收费整合包或付费服务等行为。

📄 详见 LICENSE.md


📖 项目简介

MPVConfig 中文便携版 —— 一款为 mpv 播放器打造的 配置文件可视化设置工具。

不用再翻文档、不用再手动改 mpv.conf / input.conf / uosc.conf:打开程序、自动定位你的 mpv 配置、改完一键全部保存。绿色便携,双击即用,不写注册表、不联网。

项目 信息
适用平台 Windows 10 及以上(64 位)
运行方式 绿色便携,免安装,单文件运行
管理对象 mpv.conf / input.conf / uosc.conf / 脚本配置(script-opts)
最新版本 Releases
交流群 ①群:1097053691 ②群:1104144778

📄 四合一标签页

程序把 mpv 的四类配置文件整合进同一个窗口,按来源文件夹分组着色、同源联动:

标签 管理文件 能做什么
软件设置 mpv.conf 参数分类管理;常用参数常驻、其余折叠;拖拽摆放与排序
快捷方式 input.conf 键位 / 命令 / 菜单路径行内直接改;跨菜单拖拽移动;快捷键冲突检测
ousc设置 uosc.conf uosc 键值可视化编辑,与脚本配置统一操作体验
脚本管理 script-opts/ scripts 全部脚本配置可编辑;lua 文件只读浏览

💡 智能定位:把 mpv 文件夹(或 mpv.exe / 任一配置文件)拖进窗口,自动定位整套配置——portable_config 目录结构无需手动翻找。


✨ 核心功能

功能 说明
🔀 拖拽摆放 参数拖到左侧分类上即归入并记住;拖动时右侧实时展开目标分类预览,摆放
✅ 双开关设计 input.conf 每条快捷键两个独立开关:「✓ 启用」控制整条生效
⚠️ 冲突检测 键位改重复即时提醒(弹窗直达冲突行);符合 mpv 真实规则
🕘 备份与恢复 每次保存自动备份到 backups\,备份列表备注 / 恢复 / 删除一目了然
↩️ 撤销 误删 / 误移 / 新增,一步撤回(12 秒撤销条 + 顶部「↩ 撤销」)
🔍 全局搜索 四个标签页均支持关键词即时过滤(键位 / 命令 / 菜单路径 / 配置项)
🎨 主题 深色 / 浅色主题随心切换
🪟 布局记忆 窗口大小位置自动记忆,四标签布局跨会话恢复

⌨️ 键位写法约定(input.conf)

程序完全遵循 mpv 官方注释规则与 uosc 菜单约定,未改动的行原样保留:

写法 含义
F1 命令 #menu: 文件 > 打开 快捷键 + 进 uosc 菜单
# 命令 #menu: 文件 > 打开 纯菜单项(不绑键,uosc 官方写法)
#F1 命令 整条停用(菜单和快捷键都消失)
_ 命令 #menu: 工具 > xx 占位键(纯菜单项的另一种约定,弹幕等脚本常用)

📥 下载

前往 Releases 下载最新的 MPVConfig-中文便携版-x.x.x.zip。

  • 发布版为单文件 exe(资源已内嵌),解压后只有一个 MPVConfig.exe
  • 程序不写注册表、不产生垃圾文件,删掉文件夹即彻底卸载

🚀 使用方法

1️⃣ 运行

解压后双击 MPVConfig.exe(免安装)。

2️⃣ 定位配置

首次打开选择你的 mpv 文件夹(或 mpv.exe / mpv.conf,任选其一即可自动定位整套配置)。

3️⃣ 修改并保存

修改参数后点 「🔗 全部保存」,重启 mpv 生效。

💡 每次保存都会自动备份到程序目录 backups\,改坏了随时一键恢复。


💡 使用技巧

技巧 操作
参数归类 在 a 标签按住参数拖到左侧分类上:不松手可预览目标分类的参数列表,落到某两行之间即精准摆放
快捷键搬家 b 标签按住行拖到左侧大分组,跨菜单移动会自动改写 #menu: 路径
纯菜单项 键位留空 = 纯菜单项(保存为 #);填 _ 同样只进菜单不占键位
找回误删 右键删除 / 行操作都有 12 秒撤销条,点一下就回来
快速过滤 顶部搜索框四个标签通用,输入即过滤,Esc 一键清空

📸 预览

📄 mpv 软件设置

⌨️ 菜单与快捷方式

🎛 ousc 设置

🗂 脚本管理器

🛡️ 防错功能示意

×N 重复参数检测 —— 重复行标红、分组条红闪 + 大号 ×N,展开查看重复明细;保存前弹窗逐条确认。

配置组冲突检测与互斥判定 —— 冲突卡片「⚠ 冲突」角标 + 对照弹窗一键修复;成对开关自动互斥。


❓ 常见问题

🔒 杀毒软件报毒怎么办?
程序发布版对脚本做了代码混淆(防止白嫖党二次打包倒卖),个别杀软可能误报。本程序不联网、不收集任何数据,添加信任即可。请务必只从本仓库官方 Releases 页面下载。
📡 程序会联网吗?
不会。所有操作仅读写本地配置文件,无任何网络请求。
🗂 我的配置文件在哪?
程序自动定位 mpv 目录下的 `portable_config\`(整合包)或 `%APPDATA%\mpv\`;备份保存在程序目录 `backups\`。
💾 修改后没生效?
点「🔗 全部保存」后需重启 mpv(或重新载入配置)才会应用。

📜 开源协议

本项目基于 非商业使用许可 协议发布,仅供个人学习、研究使用,严禁商业使用和任何形式的收费。


🤝 反馈与贡献

  • 🐛 发现问题 / 有功能建议?请提 Issue,或进上方 QQ 群交流
  • 📝 更新内容见 CHANGELOG.md
  • 🔒 安全问题请勿公开提交,见 SECURITY.md

🙏 致谢

  • mpv 播放器 — 强大而优雅的媒体播放器
  • uosc — 优秀的 mpv UI 框架
  • 所有使用和反馈本工具的朋友们

Made with ❤️ by yosh-wang

⭐ 如果这个项目对您有帮助,请给一个 Star 支持一下!


About

MPV 播放器配置文件可视化设置工具,无需手动编辑 mpv.conf,轻松管理各项参数。A GUI tool to configure MPV player settings without manually editing mpv.conf.

Resources

Code of conduct

Contributing

Security policy

Stars

19 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors