tubetui：终端里的 YouTube 播放器

项目简介

tubetui 是一个用 Rust 和 ratatui 编写的终端应用，把 YouTube 的订阅、播放列表、历史记录和本地视频、音乐都放进终端里。视频通过 mpv 播放：默认打开独立窗口；在 kitty 终端中，视频可以直接内嵌到应用画面里。每个视频占用一个独立的标签页。界面提供英文和西班牙语，按 Ctrl+y l 切换。

主要功能

• 浏览：首页推荐、发现（本周你关注话题的热门视频）、订阅（直播和即将开播优先）、我的频道、发现频道、根据最近观看内容生成的“接下来看什么”。
• 播放列表与历史：我的列表（含点赞视频、稍后观看）、按日期分组的历史记录，并显示观看进度。
• 继续播放：关闭视频时记住播放到第几秒，再次打开会从上次的位置继续。
• 更新提醒：每 15 分钟检查订阅，新视频会在状态栏提示、菜单中计数、列表中标记 NUEVO，并可发送桌面通知。
• 搜索：支持全站搜索、仅限订阅频道、频道内搜索，也可以搜索频道。
• 预览面板：显示缩略图、时长，以及按所选清晰度估算的下载体积。
• 操作：订阅与取消订阅、点赞与点踩、稍后观看、下载（含字幕）、打开频道。
• 播放控制：音量、静音、跳转、字幕开关、原始音轨、字幕音轨与配音音轨的切换、语言选择、全屏、纯音频、章节跳转、直播播放。
• SponsorBlock：自动跳过赞助商、自我推广和“订阅”提醒片段，进度条上以绿色标出。
• 语音翻译（T 键）：由 vot-cli 把翻译后的语音叠在原声上播放，可设置默认语言。
• 评论：视频在独立窗口或以纯音频播放时，终端宽度 100 列以上会显示评论，用 PgUp 和 PgDn 滚动。
• 本地文件：我的视频和我的音乐会列出所选目录中的文件，音乐从选定歌曲播放到列表结尾。
• 下载管理：实时显示进度、速度和剩余时间；退出时若有进行中的下载会先询问。
• 其他：鼠标点击与滚轮操作、右键菜单、底部始终显示当前可用按键、设置界面（写入 config.toml）、Linux（X11）下的系统托盘图标。
• 登录：从已安装的浏览器读取登录状态，或在没有浏览器的机器上导入 cookies.txt。

安装与使用

需要 PATH 中有 mpv 和 yt-dlp；内嵌播放需要 kitty 终端。可选依赖：streamlink（直播）、vot-cli（语音翻译）、wmctrl（X11 窗口全屏）。

各版本的预编译包在官网和 GitHub Releases 上：Windows 使用 tubetui-x86_64-windows-setup.exe，Debian、Ubuntu 使用 sudo apt install ./tubetui_amd64.deb，其他 Linux 和 macOS 使用对应的 tar.gz 包。

从源码安装（需要 Rust 1.88 或更新版本）：

cargo install tubetui

也可以运行官方安装脚本，它会先检查 C 编译器、Rust、mpv 和 yt-dlp：

curl -sSf https://raw.githubusercontent.com/polblancoo/tubetui/main/install.sh | sh

全局快捷键使用类似 tmux 的 Ctrl+y 前缀，例如 Ctrl+y b 显示菜单、Ctrl+y / 搜索、Ctrl+y ? 查看全部快捷键。

注意事项

• 项目采用 AGPL-3.0 许可证，当前属于早期但可用的阶段。
• 内嵌视频仅在 kitty 终端中有效；若出现音画不同步，可降低分辨率或改用覆盖层模式。
• 语音翻译依赖 Yandex 的非官方服务，只支持英语、俄语和哈萨克语，且不支持直播。

---

本作品整理自 GitHub 开源项目 polblancoo/tubetui，原作者 @polblancoo，许可证 AGPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。