GitHub周榜热榜！Yoinks：终端视频下载神器，粘贴链接自动下载，从此告别流氓下载站

一、你是不是也受够了这些下载站？

想下载一个视频，搜索引擎一点开，好家伙——满屏的”高速下载”按钮，点下去不是让你装某某浏览器，就是弹出三个广告窗口。真正的下载链接藏在页面最底下，字小得要用放大镜找。

折腾半天，下下来的东西不是带水印就是被压缩得模糊不清。

其实下载视频这事，用对了工具，真的可以简单到离谱：粘贴链接，选个分辨率，完事。

今天要介绍的 Yoinks，就是把这件事做到极致的开源工具。它是本周 GitHub Trending 热榜项目，一周涨了近 2000 颗星，4.7k+ Stars，MIT 开源协议，完全免费。

二、Yoinks 是什么来头？

一句话：运行在终端里的全屏视频下载器。

它不是浏览器插件，不是桌面软件，就是你终端里的一个命令行工具。粘贴一个视频链接进去，它会列出所有可用的分辨率（还标注了预估文件大小），你用方向键选一个，回车，视频自动下载到 ~/Downloads 目录。

支持的平台相当全：

• YouTube
• X / Twitter
• Instagram
• Threads
• TikTok
• 以及其他 1800+ 网站（底层由 yt-dlp 驱动）

重点是：没有弹窗、没有假按钮、没有流氓跳转。这就是”终端工具”的底气——它根本不需要靠广告活着。

三、环境准备：只需要 Node.js

Yoinks 基于 Node.js 编写，要求 Node 18 或更高版本。

先检查一下自己的 Node 版本：

node --version
# 输出 v18.x.x 或更高即可，比如 v24.16.0

如果没有装 Node.js，去官网 nodejs.org 下载 LTS 版本安装即可，或者用 nvm 管理版本。

至于 yt-dlp 和 ffmpeg？完全不用管。Yoinks 首次运行时会自动下载 yt-dlp 独立二进制文件（不需要 Python 环境），ffmpeg 也会自动回退到内置的 ffmpeg-static。你只需要有 Node 就行。

四、安装：一行命令搞定

两种方式任选：

方式一：全局安装（推荐日常使用）

npm install -g yoinks

方式二：免安装试用（npx 直接跑）

npx yoinks

npm 的国内镜像如果慢，可以临时切一下：

npm install -g yoinks --registry=https://registry.npmmirror.com

安装完成后，终端里敲 yoinks 就能启动。

五、核心操作：三步下载一个视频

上面就是 Yoinks 的主界面——全屏、居中、深色背景，一个大大的输入框等你粘贴链接。

第 1 步：启动并粘贴链接

最简单的方式，直接带链接启动：

yoinks https://youtu.be/dQw4w9WgXcQ

或者裸启动，进去后再粘贴：

yoinks

把视频链接粘贴到输入框里，按回车（或者直接点界面上的 yoink 按钮——它支持鼠标操作）。

第 2 步：选择分辨率

这是格式选择器界面，可以看到：

• 各个分辨率选项（2160p、1440p、1080p、720p……）
• 每个选项旁边的预估文件大小——这个太实用了，再也不用担心选了个 4K 结果下了 2GB
• 最下面还有 Audio Only (mp3) 选项，只需要音频的可以直接提取 MP3

用 ↑/↓ 或 j/k 上下选择（vim 键位党狂喜），也可以直接按数字键，选中后回车确认。

第 3 步：等待下载完成

选完格式后 Yoinks 会显示下载进度。完成后文件保存在 ~/Downloads，终端里会打印出完整的文件路径。

快捷键速查

六、进阶用法

强制浅色/深色主题

yoinks --theme light   # 浅色
yoinks --theme dark    # 深色
yoinks --theme auto    # 自动跟随终端配色（默认）

默认的 auto 主题会读取你终端自身的前景色和背景色，所以不管你是浅色终端还是深色终端，它都能自动适配，不会出现”黑底黑字”的尴尬。

只下音频当 BGM 素材

在格式选择器里选最底部的 Audio Only (mp3)，就能只提取音频。做视频剪辑找 BGM 的朋友应该懂这个需求有多高频。

七、它是怎么工作的？（技术原理速览）

给开发者朋友多说两句技术栈：

• 下载引擎：底层是 yt-dlp——视频下载领域的”瑞士军刀”，支持 1800+ 站点。Yoinks 首次运行时会自动下载 yt-dlp 独立二进制到 ~/.yoinks/bin，不需要装 Python。如果你系统里已经有 yt-dlp，它会直接用你的。
• 界面框架：Ink——”React for terminal”，用写 React 组件的方式写终端 UI。所以 Yoinks 的界面才能做得这么精致：居中布局、全屏接管、退出后恢复滚动缓冲区。
• 音视频合并：高分辨率视频的音画流分离下载后需要 ffmpeg 合并，Yoinks 优先用系统 PATH 里的 ffmpeg，找不到就回退到内置的 ffmpeg-static。

整个工具零遥测、零账号、MIT 开源，代码完全公开可审计。

八、FAQ：新手最常遇到的问题

Q：国内能用吗？下载 YouTube 需要梯子吗？

A：Yoinks 本身是国内可用的（npm 安装没问题），但 YouTube、X 等平台在国内访问受限，下载这些站点的视频自然也需要相应的网络环境。不过 yt-dlp 支持的 1800+ 站点里有不少国内平台可以直接用。

Q：和浏览器插件比有什么优势？

A：浏览器插件依赖浏览器且容易被检测、被下架；命令行工具稳定可控，而且可以写进脚本批量处理。另外 Yoinks 的格式选择器直接列出预估大小，比大多数插件的信息展示更直观。

Q：下载的视频有水印吗？

A：yt-dlp 拿到的是平台提供的原始视频流，没有水印问题（前提是平台本身不加水印）。

Q：支持 playlists 吗？

A：目前还不支持（官方 Roadmap 里有这一项），当前一次下载一个视频。

九、写在最后

说实话，终端里的视频下载工具不少，但像 Yoinks 这样把体验打磨到”全屏居中、鼠标可点、预估大小、主题自适应”这个程度的，还真不多见。它没有试图教育用户，就是安安静静地做一个工具：粘贴、选择、下载，三步结束。

开源免费、零遥测、一行命令安装——值得每个经常和视频打交道的人收藏。

📥 软件下载

npm 安装（推荐）：

npm install -g yoinks

夸克网盘下载（安装包 + 源码 + README）：

夸克网盘下载：https://pan.quark.cn/s/8dedc4b4a920

GitHub 项目地址：https://github.com/pablostanley/yoinks

关注公众号：「实用软技」，在公众号窗口里回复关键字”软件”即可免费获取