mpv_player_config

项目概述

mpv 播放器配置是一套面向 Windows（兼顾 macOS 与 Linux）的 mpv 部署与配置还原方案，主题是「uosc 与 ModernX 共存架构 + 全量中文注释」。它把两大主流 UI 框架分工处理：ModernX 负责底部进度条、悬浮控制栏与顶部标题栏的视觉呈现，uosc 专精右键与 Tab 唤出的多级半透明菜单，从而避免界面重叠与功能冲突。方案还包含分辨率自适应的自动 Profile、音频专项优化脚本、硬解与软解说明，以及可切换的中文性能统计面板。

一套把 uosc 与 ModernX 分工妥当、配置全部中文注释的 mpv 便携方案。

主要功能

• 双框架分工：ModernX 负责主界面与交互，uosc 负责右键菜单、播放列表与轨道直选，互不冲突
• 缩略图预览：配合 thumbfast 在进度条悬停时秒级拉取高清缩略图
• 分辨率自适应：按视频分辨率自动切换去色带与抗振铃策略，中分辨率加强 Deband、超高清保留原盘细节
• 音频专项优化：有封面时居中显示封面，无封面时自动渲染彩虹频谱，并按文件类型应用独立音量
• 拖动防爆音：拖动进度条时自动降低音量，松手后平滑恢复
• 自动加载与播放列表：自动扫描同目录文件加入播放列表，并支持排序、反转、随机与保存加载
• 中文统计面板：可按需切换为含 CPU 与 GPU 实时占用率的中文性能面板
• 主题色库：提供经典简约、动漫主题与高对比霓虹三类进度条主题色，可一键更换

适用人群

• 想快速部署一套顺眼 mpv 配置的 Windows 用户
• 需要缩略图预览与中文统计面板的用户
• 想了解硬解与软解差异并手动调优的用户

快速上手

1. 从 mpv 官方构建源下载最新 64 位构建包并解压到本地目录，例如 C:\mpv\
2. 将仓库的全部配置文件与文件夹放入 mpv 根目录下的 portable_config 目录
3. 确认 portable_config 包含 mpv.conf、input.conf、fonts/、scripts/ 与 script-opts/
4. 打开 script-opts/thumbfast.conf，把 mpv_path= 指向本机 mpv 的实际路径或填 mpv
5. 可选：以管理员身份运行 mpv-register.bat 关联系统常见媒体格式
6. 拖入测试视频，按功能验证清单逐项核对进度条、缩略图、右键菜单与统计面板

核心优势

• 分工清晰：ModernX 与 uosc 各司其职，界面清爽且功能不重叠
• 中文注释齐全：脚本与配置均有中文说明，便于理解和二次调整
• 画质自适应：按分辨率自动调整滤镜策略，动画与高清原盘都能兼顾
• 音频体验好：封面显示、频谱可视化与拖动降音一并处理

系统要求

项目	要求
操作系统	Windows 主推，兼顾 macOS 与 Linux
播放器	mpv 官方 64 位构建包
显卡	Windows 下使用 D3D11，macOS 与 Linux 需改用 Vulkan

注意事项

• 换电脑或修改安装路径后，必须重新核实 thumbfast.conf 中的 mpv_path 配置
• macOS 与 Linux 上需把 gpu-api=d3d11 改为 gpu-api=vulkan 或注释该行
• 中文统计面板启用后，mpv 内置英文面板会被禁用，两者不能同时生效
• 更换签名或滤镜配置后建议整目录备份，避免调优成果丢失
• 显卡驱动更新后，建议重新确认电源管理与刷新率策略