Skip to content
Karl Hook edited this page Nov 8, 2023 · 17 revisions

mpv-lazy 维基


项目说明

爱折腾的一起交流学习使用技巧
想省事的直接下载懒人包/简易包

出于不值一提的“历史原因”,我写的关于mpv的文档比较分散,做一个简要概括防止迷路:

  1. 本维基为项目的文件与结构说明,主要针对我的两个包。右侧导航的顺序对应仓库的文件夹顺序,依次详细解释了各个文件夹的作用。仓库内的设置文件也自带丰富的注释;
  2. 【个人主页1】 的内容主要是官方文档的汉化与零基础入门的指引教程,面向各平台的各种用户,完全独立通用性最强;
  3. 【个人主页2 系列手册部分】 是起初对我的两个包的补充文档(即 mpv.conf 中提到的手册[xx]),后续扩充内容时不再局限于此,而是从泛用性出发(如果有时间,会逐步迁移到个人主页1) 已基本迁移至 个人主页1 ;
  4. 【讨论板块 信息分类】 属于末端文档,针对的都是某些具体案例。比如某个脚本的功能介绍、某个插件的使用方法...甚至一些奇技淫巧。

发行

发布版本的周期不定。
版本发布后如发现重要问题会进行后续修正,留意讨论区的 “版本专帖” 与release内的sha256变动/Assets的更新日期。

主仓库不包含二进制文件、插件等,且项目性质已转换(不再是纯粹的配置备份), 粗暴的 git clone 这个项目作是无用的,直接克隆作为你的配置也只是制造混乱。

(未注册用户)可以使用 DownGit 下载某个单文件/文件夹。

如果仿照我的习惯整合一个你自己的懒人包,请参照下方的目录树。


本地文件树结构

这是一个可参考的标准化的组件路径。
我使用的是 便携化的设置文件夹
此时在 mpv.conf~~/引用的相对路径即指向 .../mpv-lazy/portable_config/

如果你使用的是 常规的设置文件夹 ,只需要把 /portable_config/ 内的文件转移至 %APPDATA%/mpv/

/.../
└─ /mpv-lazy/
   │  mpv.exe & mpv.com
   │
   └─ /portable_config/
      │  input.conf
      │  mpv.conf
      │  profiles.conf
      │
      ├─ /fonts/
      │    ?????.ttf
      │    <等等字体>
      │
      ├─ /scripts/
      │    ?????.lua
      │    /<脚本群组文件夹>/
      │    │  main.lua
      │    └─ <附属文件> 
      │
      ├─ /script-opts/
      │    ?????.conf(名称通常对应脚本名)
      │
      ├─ /shaders/
      │    ?????.glsl
      │    ?????.hook
      │
      └─ /vs/
         └─ ?????.vpy

我也使用便携版Python VapourSynth
即解压所有包内文件到 mpv.exe 的同级

/.../
└─ /mpv-lazy/
   │  python.exe
   │  VSPipe.exe
   │  VapourSynth.dll
   │  xxxx.py
   │  <等等文件>
   │  
   └─ /vapoursynth64/
      └─ /plugins/
         └─ <这里放置自行添加的vs插件>

youtube-dl或YT-DLP增强mpv的流媒体解析能力

/.../
└─ /mpv-lazy/
   │  youtube-dl.exe
   └─ yt-dlp.exe

由于我使用的是静态库构建的mpv,而一些第三方脚本依赖FFmpeg,因此需要额外放置
如果你使用shared版FFmpeg,那就要把压缩包内 ffmpeg.exe 旁的各种 dll 文件一起解压出来

/.../
└─ /mpv-lazy/
   │  ffmpeg.exe
   │  ffplay.exe (目前没见过脚本需要ffplay的)
   └─ ffprobe.exe

tcl/tk依照可选脚本( contextmenu_gui )的预设放在此处

/.../
└─ /mpv-lazy/
   └─ tclsh.exe

安装注册相关的文件置于 mpv.exe 的次级

/.../
└─ /mpv-lazy/
   └─ /installer/
      │  mpv-BenchMark.conf
      │  mpv-test.conf
      │  mpv-??模式.bat
      │  mpv-icon.ico
      │  mpv-install.bat
      └─ mpv-uninstall.bat

碎碎念

这一节只是一些没有营养的废话

本项目创建的起因是为了分享我对mpv的摸索经验,一个优秀的开源项目、一个强大的本地播放器值得被更多人熟悉和使用。

与mpv的缘分来自于点击了vcb-s论坛用户zc62大佬的配置分享帖,在经过简单的上手后便肯定了,这是符合我的需求的纯粹的媒体播放器。
在后续的学习使用的过程中,我发现了一个算是很常见的问题,在中文互联网上存在大量的“拾人牙慧”的现象 —— 把他人的曾经的经验包装为自己的原创,然后布道给小白。批判“抄袭者”对我而言不是重点,我想说的是作为学习这些知识的萌新是个比较苦恼的事情。假使这些被大量复述的知识从一开始就是错的,或者因为时间的推移而不再适应当前版本,这徒增了不必要的大量的学习成本。对应这个现象的例子就是,我在中文互联网上查询mpv配置帖以供参考学习,其中很多都毫不意外的指向了zc62的副本,只不过署名换成了其它人的“原创”而已。另外一类常见的情况就是,一条条错误的参数或错误的使用方法被到处传播,而你换多个网址看到的“解决方案”几乎一致,当时作为菜鸡的我没有足够的判断力饶了很多弯路。

检讨自身,明明有条理清晰的官方手册我却不查(主要是懒)而依赖惯性的去问候度娘,我自己的问题也占了较大比重。我希望像我一样不是程序员的用户在接触到mpv时不会被 过分简洁的界面、无从下手设置的门道、冗长的说明手册 这些因素光速劝退,不被奇怪的过时的文章误导,于是着手开启了这一项目,并尽可能追随mpv的更新进度。
考虑到mpv的官方手册实际上偏向给开发者看的文档,我也计划重写了一系列面向用户的引导文(当然这些受限于我不同时期的知识/能力,不同章节的质量和水平参差不齐),同时也汉化了手册中大多数用户的要用到的内容(机翻打底),这些都是为了进一步降低对非专业人员的上手难度。

在长时间的使用体验后,我认为mpv是一个使用门槛不低的播放器,所以我不热衷于宣传( “别用垃圾pot了快用mpv” )。个性化配置好的它确实很顺手,但是配置的过程对大多数人来说可能是折磨的 —— 考虑到这一点因此有了开箱即用的懒人包,但随着后期功能的扩充,懒人包一点点变得不再那么“懒”,新用户没法像使用最初的版本那样快速理清mpv的使用思路。(就像那些适合打MOD的游戏,你满怀期待的下载了别人的几十GB的整合包却发现花里胡哨,迷失在了繁杂功能的地狱里,突然在某一瞬间感到索然无味后一键删除。)我不知道怎么解决这个问题,只能给懒人包持续扩充文档。。。有一点背道而驰的味道。

如果你也是一个路过的查询mpv如何使用的用户,无意中发现了这个项目,希望它能对你有用。
起先仓库里只是我的私人配置,后期有许多中文mpv用户同样参与了提交和贡献。共同完善了配置内容,这里表示诚挚的感谢。