api-HydrusNetwork/scripts/README.zh-Hans.md

English | 简体中文 | 繁体中文

mpv handler

一个 mpv 的协议处理程序，使用 Rust 编写。

使用 mpv 和 yt-dlp 播放网站上的视频与音乐。

请配合用户脚本使用：

重大变更

v0.4.0

为了避免与 mpv 所提供的 mpv:// 协议冲突。

mpv://...

mpv protocol. This is used for starting mpv from URL handler. The protocol is stripped and the rest is passed to the player as a normal open argument. Only safe network protocols are allowed to be opened this way.

协议 mpv:// 和 mpv-debug:// 已弃用, 请使用 mpv-handler:// 和 mpv-handler-debug://.

需要手动干预

Windows

运行 handler-uninstall.bat 卸载已弃用的协议, 然后运行 handler-install.bat 安装新的协议.

Linux

如果你是手动安装的，请重新执行一遍手动安装流程。

协议

协议名

• mpv-handler: 在没有命令行窗口的情况下运行 mpv-handler
• mpv-handler-debug: 在有命令行窗口的情况下运行 mpv-handler 以便于查看输出和错误

插件 / Plugins

• play: 使用 mpv 播放视频

编码数据 / Encoded Data

使用 URL 安全的 base64 编码网址或标题。

替换 / 至 _, + 至 - 并且删除填充的 =。

示例 (JavaScript):

let data = btoa("https://www.youtube.com/watch?v=Ggkn2f5e-IU");
let safe = data.replace(/\//g, "_").replace(/\+/g, "-").replace(/\=/g, "");

参数 / Parameters (可选)

cookies  = [ www.domain.com.txt ]
profile  = [ default, low-latency, etc... ]
quality  = [ 2160p, 1440p, 1080p, 720p, 480p, 360p ]
v_codec  = [ av01, vp9, h265, h264 ]
v_title  = [ Encoded Title ]
subfile  = [ Encoded URL ]
startat  = [ Seconds (float) ]
referrer = [ Encoded URL ]

安装

Linux

Arch Linux

手动安装

1. 下载 最新的 Linux 压缩包

2. 解压缩压缩包

3. 复制 mpv-handler 至 $HOME/.local/bin

4. 复制 mpv-handler.desktop 至 $HOME/.local/share/applications/

5. 复制 mpv-handler-debug.desktop 至 $HOME/.local/share/applications/

6. 为二进制文件设置可执行权限

   • $ chmod +x $HOME/.local/bin/mpv-handler
     

7. 注册 xdg-mime（感谢 linuxuprising 的提醒）

   • $ xdg-mime default mpv-handler.desktop x-scheme-handler/mpv-handler
     $ xdg-mime default mpv-handler-debug.desktop x-scheme-handler/mpv-handler-debug
     

8. 添加 $HOME/.local/bin 到环境变量 PATH

9. 可选: 复制 config.toml 至 $HOME/.config/mpv-handler/config.toml 并配置

Windows

Windows 用户目前只能手动安装。

手动安装

1. 下载 最新的 Windows 压缩包
2. 解压缩档案到你想要的位置
3. 运行 handler-install.bat 注册协议处理程序
4. 编辑 config.toml 设置 mpv 和 ytdl 的路径

配置

mpv = "/usr/bin/mpv"
# 可选，类型：字符串
# mpv 可执行文件的路径
# 默认值:
# - Linux: mpv
# - Windows: mpv.com

ytdl = "/usr/bin/yt-dlp"
# 可选，类型：字符串
# yt-dlp 可执行文件的路径

proxy = "http://example.com:8080"
# 可选，类型：字符串
# HTTP(S) 代理服务器的地址

# 对于 Windows 用户：
#   - 路径格式可以是 "C:\\folder\\some.exe"，也可以是 "C:/folder/some.exe"
#   - 路径的目标是可执行二进制文件，而不是目录