YouTerm

CLI 工具用于搜索YouTube视频并通过mpv.

要求

YouTube API

youterm使用 YouTube API 检索视频信息。需要 API 密钥。您可以在此链接获取注册 Google 开发人员资料、添加项目和创建 API 密钥以添加YouTube 数据 API v3服务的 方法。

依赖项

youterm不依赖外部 Python 库，尽管它使用外部程序来提供音频/视频流：

• mpv
• yt-dlp或者youtube-dl

可选依赖项

要安全地存储YouTube API，需要使用unix 标准密码管理器 pass 。youterm在密码存储[^2]中查找一个包含 API 密钥的密码条目 api/youtube，或任何自定义指定的条目[^1]。或者，您可以将 API 密钥youterm作为命令行参数传递（参见Usage）或使用配置文件 [^3] （参见 Configuration）。

[^1]：您可以pass使用配置文件为 API 密钥指定自定义条目（请参阅配置）[^2]：使用pass insert api/youtube或pass insert <entry>为自定义条目创建条目（其中<entry>是实际条目名称的占位符）[^3]：不建议

安装

youterm使用安装pip：

pip3 install youterm

用法

不带标志调用youterm默认为仅音频。下面的用法：

usage: youterm [-h] [-v] [-r <n>] [-a <api_key>] [-q <resolution>]

CLI tool to search for YouTube videos and play selected audio/video via MPV

options:
  -h, --help            show this help message and exit
  -v, --video           Play video
  -r <n>, --results <n>
                        Number of search results displayed
  -a <api_key>, --api <api_key>
                        YouTube Data API v3 key
  -q <resolution>, --quality <resolution>
                        Choose video quality (if not available choose closest lower)

配置

您可以指定youterm使用位于以下位置的配置文件 [^4] 的默认选项：[^4]：ini文件结构

• ~/.config/youterm/config在基于Linux和 Unix 的系统上（遵循 XDG 基本目录规范）
• C:\Users\<username>\AppData\Roaming\youterm\config在Windows系统上（<username>实际用户名的占位符在哪里）

下面是一个配置模板：

[api]
# YouTube Data API v3 key (can be overridden using CLI argument)
key = <api_key>
# pass entry containing the API key (if you want to use pass to store the key)
# if not set defaults to: "api/youtube"
pass_entry = <pass_entry>

[search]
# default number of search results (can be overridden using CLI argument)
# if not set defaults to: 5
results = <num>

[video]
# default video resolution (can be overridden using CLI argument)
# if not set defaults to: bestvideo
# valid options are: 144, 240, 360, 480, 720, 1080, 1440, 2160
quality = <video_resolution>

变更日志

有关完整的变更日志，请参阅CHANGELOG.md。