mpv-scripts 项目教程
项目介绍
mpv-scripts
是一个为 mpv
播放器收集的脚本集合,由社区开发者贡献。这些脚本扩展了 mpv
的功能,提供了诸如 YouTube 搜索、播放列表管理、用户界面定制等多种实用功能。项目托管在 GitHub 上,采用 MIT 许可证。
项目快速启动
安装 mpv
首先,确保你已经安装了 mpv
播放器。你可以通过以下命令在不同操作系统上安装 mpv
:
-
Linux:
sudo apt-get install mpv
-
macOS:
brew install mpv
-
Windows: 可以从 mpv 官方网站 下载安装包进行安装。
安装脚本
克隆 mpv-scripts
仓库到本地:
git clone https://github.com/stax76/mpv-scripts.git
将脚本复制到 mpv
的配置目录:
-
Linux 和 macOS:
cp -r mpv-scripts/* ~/.config/mpv/scripts/
-
Windows:
xcopy /E mpv-scripts %APPDATA%\mpv\scripts\
配置脚本
在 mpv
的配置文件(通常位于 ~/.config/mpv/mpv.conf
或 %APPDATA%\mpv\mpv.conf
)中添加以下配置:
script-opts=youtube-search-api-key=YOUR_YOUTUBE_API_KEY
替换 YOUR_YOUTUBE_API_KEY
为你的 YouTube API 密钥。
应用案例和最佳实践
YouTube 搜索
使用 youtube-search
脚本,你可以在 mpv
中直接搜索并播放 YouTube 视频。按下 Ctrl+Y
打开搜索界面,输入关键词并选择视频进行播放。
播放列表管理
使用 save-playlist
脚本,你可以保存当前播放列表为 .m3u
文件。按下 Ctrl+S
并输入文件名和路径即可保存。
用户界面定制
使用 osc-layout
脚本,你可以自定义 mpv
的用户界面。通过修改脚本配置文件,调整界面元素的位置和样式。
典型生态项目
mpv-user-input
mpv-user-input
是一个允许脚本通过 OSD 请求用户输入的 API。它支持几乎所有的键绑定,使得脚本可以更加灵活地与用户交互。
scroll-list
scroll-list
是一个 Lua 脚本,提供了一个滚动列表界面,用于在 mpv
中显示和选择项目。它常用于文件浏览器和播放列表管理。
dvd-browser
dvd-browser
脚本使用 lsdvd
命令行工具,允许用户直接在 mpv
中查看和选择 DVD 标题。它支持交互式浏览和自动播放列表管理。
通过这些脚本和工具,mpv
的用户体验得到了极大的增强,使其成为一个功能丰富且高度可定制的媒体播放器。