mpvc 项目安装与使用教程

mpvc 项目安装与使用教程

mpvc An mpc-like control interface for mpv. 项目地址: https://gitcode.com/gh_mirrors/mp/mpvc

1. 项目的目录结构及介绍

mpvc 项目的目录结构如下：

mpvc/
├── extras/
│   ├── mpvc-autostart
│   ├── mpvc-equalizer
│   ├── mpvc-fzf
│   ├── mpvc-installer
│   ├── mpvc-mpris
│   ├── mpvc-now
│   ├── mpvc-tui
│   └── mpvc-web
├── LICENSE
├── mpvc
├── README.md
└── requirements.txt

目录结构介绍

• extras/: 包含 mpvc 项目的额外功能模块，如自动启动、均衡器、FZF 集成、安装器、MPRIS 控制、分享当前播放列表、TUI 界面和远程 Web 控制。
• LICENSE: 项目的开源许可证文件，采用 MIT 许可证。
• mpvc: 项目的核心启动文件，提供 mpvc 播放器的核心 CLI 命令。
• README.md: 项目的说明文档，包含项目的基本介绍、安装方法和使用指南。
• requirements.txt: 项目依赖的软件包列表。

2. 项目的启动文件介绍

mpvc 项目的启动文件是 mpvc，它是一个命令行工具，用于控制 mpv 播放器。mpvc 提供了以下主要功能：

• 添加媒体到播放列表: 使用 -a 或 --add 选项可以将媒体文件或 URL 添加到播放列表中。
• 停止播放: 使用 -s 或 --stop 选项可以停止当前播放。
• 搜索并播放本地媒体: 使用 -l 选项可以通过 FZF 搜索并播放本地媒体文件。
• 搜索并播放在线媒体: 使用 -p 选项可以通过 Invidious 搜索并播放在线媒体。

使用示例

# 添加媒体文件到播放列表
mpvc -a /path/to/your/media.mp3

# 停止播放
mpvc -s

# 搜索并播放本地媒体
mpvc -l

# 搜索并播放在线媒体
mpvc -p 'kupla mirage'

3. 项目的配置文件介绍

mpvc 项目没有明确的配置文件，但可以通过环境变量和命令行选项进行配置。以下是一些常用的配置选项：

• 环境变量:

  • MPVC_TERM: 指定用于启动 mpvc-fzf 的终端程序。

• 命令行选项:

  • -a | --add: 添加媒体到播放列表。
  • -s | --stop: 停止播放。
  • -l: 搜索并播放本地媒体。
  • -p: 搜索并播放在线媒体。

配置示例

# 设置 MPVC_TERM 环境变量
export MPVC_TERM=xterm

# 使用 mpvc-fzf 搜索并播放在线媒体
mpvc-fzf -p 'kupla mirage'

通过以上配置，可以灵活地控制 mpvc 的行为，满足不同的使用需求。

mpvc An mpc-like control interface for mpv. 项目地址: https://gitcode.com/gh_mirrors/mp/mpvc