# mpv-config **Repository Path**: cjl2385/mpv-config ## Basic Information - **Project Name**: mpv-config - **Description**: No description available - **Primary Language**: Unknown - **License**: LGPL-2.1 - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-13 - **Last Updated**: 2026-11-17 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # mpv ModernZ / ModernGlass 配置 基于 [akFace/mpv.config](https://github.com/akFace/mpv.config) 的简体中文配置,提供两套界面:ModernZ 与液态玻璃风格的 ModernGlass。保留上游的右键菜单、弹幕、进度条缩略图、超分和滤镜,在此之上调整了图片浏览、快捷键和桌面交互。需要另外安装 [mpv](https://mpv.io)(已在 0.41 上测试) ## 两套界面 | 界面 | 控制栏 | 进度条缩略图 | 字体 | 右键菜单样式 | | ------------------ | ---------------------------- | ------------ | -------------------------- | ------------------------- | | `modernz` | ModernZ | thumbfast | `modernz-icons`(图标) | 深色卡片 | | `modern_glass`(默认) | ModernGlass 悬浮玻璃面板 | thumbz | Inter(随配置安装) | 玻璃(`glass_enabled`) | 两者共用快捷键、右键菜单脚本、弹幕、超分等其余配置,以及下文「相对上游的调整」中的全部改动 ## 安装 Linux / macOS / Windows(Git Bash): ```sh sh install.sh # 交互终端里会询问界面 sh install.sh --ui modern_glass # 直接指定:modernz 或 modern_glass(别名 glass) sh install.sh --target ~/mpv-portable # 安装到其他目录 ``` Windows(PowerShell): ```powershell powershell -ExecutionPolicy Bypass -File install.ps1 powershell -ExecutionPolicy Bypass -File install.ps1 -UI modern_glass # 安装到其他目录,例如 mpv.exe 旁的 portable_config powershell -ExecutionPolicy Bypass -File install.ps1 -Target D:\mpv\portable_config ``` | 平台 | 默认安装位置 | | ------------- | ----------------------------------- | | Linux / macOS | `${XDG_CONFIG_HOME:-~/.config}/mpv` | | Windows | `%APPDATA%\mpv` | 界面的选择顺序(两个脚本一致): 1. 命令行参数 `--ui` / `-UI` 2. 未指定且在交互终端中运行时,列出两套界面供选择,回车采用默认值 3. 非交互运行(如管道、脚本)时沿用目标目录上次安装的界面:读取安装时写入的 `.mpv-config-ui`;旧版安装没有该文件时,有 `scripts/thumbz.lua` 视为 `modern_glass` 4. 以上都没有时使用 `modern_glass`;交互提示的默认值也按 3、4 确定 其他行为: - 共享配置与所选界面的专属文件先合并到目标同级的临时目录,再整体替换,失败时不留下半成品;参数无效时不做任何修改 - 已有配置会整体移动到同级的 `<目标>.backup.YYYYMMDD-HHMMSS`,不会被覆盖 - 最近播放(`recent.json`)、上次会话属性(`celebi.txt`)和 `switch-opts-backup.json` 属于运行状态,不随项目分发,重装时从旧配置沿用 - Windows 上请先关闭 mpv,否则目录可能被占用;此时脚本会退出且不做修改 - 安装是复制,之后更新本项目或切换界面需要重新运行安装脚本 ### 不安装直接试用 安装到临时目录,再用 `--config-dir` 打开: ```sh dir=$(mktemp -d)/mpv sh install.sh --ui modern_glass --target "$dir" mpv --config-dir="$dir" /path/to/video.mp4 ``` `config/` 只有共享部分,不能直接作为配置目录使用。`--config-dir` 不改变 mpv 的缓存目录 `~~cache`(Linux 为 `~/.cache/mpv`),封面缓存仍写在那里 ## 目录结构 ```text config/ 两套界面共用:mpv.conf、input.conf、右键菜单、弹幕、着色器及本项目的脚本 themes/ modernz/ scripts/modernz.lua、thumbfast.lua,script-opts/modernz*.conf、menu_style.conf、thumbfast.conf,fonts/modernz-icons.ttf modern_glass/ scripts/modernz.lua(ModernGlass)、thumbz.lua,script-opts/modernz*.conf、menu_style.conf、thumbz.conf,fonts/Inter-* install.sh / install.ps1 docs/hover-files.md 右侧文件列表说明 tests/ 测试 ``` 安装时把 `config/` 与 `themes/<界面>/` 合并,两者没有同名文件。两套界面的控制栏脚本都叫 `modernz.lua`(ModernGlass 沿用 ModernZ 的脚本名和 `script-message-to modernz` 接口),因此不能同时装在一个目录里 ## 相对上游的调整 ### 右侧文件列表 鼠标移到窗口右边缘,展开当前目录的图片和视频列表:玻璃卡片、小封面加文件名,当前文件标「正在播放」。单击切换,滚轮或拖动滚动条浏览。卡片浮在画面上,不缩小视频,也避开控制栏和标题栏;`modern_glass` 界面下复用它的玻璃 shader 模糊卡片背后的视频,`modernz` 界面下是半透明纯色卡片。视频封面取 20% 处的画面并缓存到磁盘,`modern_glass` 下复用 thumbz 的封面。详见 [docs/hover-files.md](docs/hover-files.md) ### 快捷键与图片浏览 | 操作 | 行为 | | -------------------------------------- | ------------------------------------------------------------------------------------------------------ | | `z` / `x` / `c` | 减速 0.1× / 恢复 1.0× / 加速 0.1×(替换了上游 `z` 的字幕延迟) | | 单击画面 | 暂停 / 继续。会等过双击判定时间(约 0.3 秒)再生效,因此双击全屏时不会先暂停一下 | | 双击画面 / `f` | 切换全屏 | | 方向键(图片) | 左 / 上:上一张;右 / 下:下一张 | | 方向键(视频、音乐) | 保持上游的快进 / 后退和音量;带封面的音乐不会被当成图片 | | `Ctrl+=` / `Ctrl+-` / `Ctrl+0`(图片) | 放大 25%(超过 300% 回到 100%)/ 缩小(最低 100%)/ 复位。`Ctrl+0` 替换了上游的色调 +1,菜单中仍可使用 | 图片不再 5 秒后自动切换(`image-display-duration=inf`),视频播放结束仍会进入下一项 ### 其他 - **统一提示**:倍速、缩放、HDR、着色器等操作的提示显示在左上角半透明圆角框中,由 `notice.lua` 提供;其他脚本可用 `script-message-to notice show <文本> [秒数]` 调用 - **右键菜单保持打开**:执行普通菜单项后不关闭,方便对比画质;点击菜单外、按 `Esc` 或再次右键关闭 - **`window-dragging=no`**:避免拖动窗口干扰单击暂停 - **`keepaspect-window=no`**:适配平铺窗口管理器(如 Niri)调整窗口尺寸,画面本身仍保持比例 ## 已知限制 - 右侧列表的目录扫描是同步的,超大目录或慢速网络挂载可能短暂卡顿 - 统一提示没有覆盖第三方脚本和 mpv 原生 OSD - 主要在 Linux(Niri / Wayland)上测试;未在 Windows 和 macOS 上实测。`install.ps1` 在 Linux 的 PowerShell 7 上测试过,未在 Windows PowerShell 5.1 上运行 - 插帧模式使用 mpv 的时间重采样,不是运动预测或 AI 插帧 ## 测试 ```sh lua tests/hover-files-test.lua # 侧栏逻辑单测,无需显示环境(另有 glass / max-source 模式,见 docs/hover-files.md) bun run tests/media-controls.ts # 方向键、单击 / 双击,无窗口的真实 mpv bun run tests/install.ts # 安装脚本:界面选择与沿用、备份、运行状态;install.ps1 部分需要 pwsh(可用 PWSH 指定路径) ``` 其余 `tests/*.ts` 会打开真实 mpv 窗口并截图,`HOVER_TEST_UI=modern_glass` 时以玻璃界面运行;部分需要 Niri、grim 和 `/dev/uinput`,见 [docs/hover-files.md](docs/hover-files.md#测试) ## 来源与许可 - 上游:[akFace/mpv.config](https://github.com/akFace/mpv.config) `v1.9.31` 发布包。`config/` 与 `themes/modernz/` 来自 `modernz_zh.zip`,`themes/modern_glass/` 来自 `modern_glass_zh.zip`(两个包除这些皮肤文件外完全相同) - 从 `v1.9.30` 升级时以导入提交 `de267a0` 为基准三方合并,本地对 `menu.lua`、`input.conf`、`mpv.conf` 的改动均已保留;更新上游时可按同样方式对比两个发布包 - 上游功能、快捷键与平台兼容性见 [config/README.md](config/README.md) 中的上游文档链接 - 许可见 `LICENSE.LGPL`;第三方组件以各自附带的许可文件为准,Inter 字体见 `themes/modern_glass/fonts/Inter-LICENSE.txt`