GitHub周榜热榜！Yoinks：终端视频下载神器，粘贴链接自动下载，从此告别流氓下载站
一、你是不是也受够了这些下载站？
想下载一个视频，搜索引擎一点开，好家伙——满屏的”高速下载”按钮，点下去不是让你装某某浏览器，就是弹出三个广告窗口。真正的下载链接藏在页面最底下，字小得要用放大镜找。
折腾半天，下下来的东西不是带水印就是被压缩得模糊不清。
其实下载视频这事，用对了工具，真的可以简单到离谱：粘贴链接，选个分辨率，完事。
今天要介绍的 Yoinks，就是把这件事做到极致的开源工具。它是本周 GitHub Trending 热榜项目，一周涨了近 2000 颗星，4.7k+ Stars，MIT 开源协议，完全免费。
二、Yoinks 是什么来头？
一句话：运行在终端里的全屏视频下载器。
它不是浏览器插件，不是桌面软件，就是你终端里的一个命令行工具。粘贴一个视频链接进去，它会列出所有可用的分辨率（还标注了预估文件大小），你用方向键选一个，回车，视频自动下载到 ~/Downloads 目录。
支持的平台相当全：
- YouTube
- X / Twitter
- 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，终端里会打印出完整的文件路径。
快捷键速查
| 按键 | 功能 |
|---|---|
↑ / ↓ 或 j / k |
上下选择格式 |
Enter |
确认下载 |
Esc |
返回上一步 |
Ctrl+C |
退出 |
Ctrl+T |
切换主题（auto/light/dark） |
| 鼠标 | 按钮、列表、提示均可点击 |
六、进阶用法
强制浅色/深色主题
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
关注公众号：「实用软技」，在公众号窗口里回复关键字”软件”即可免费获取
https://www.88531.cn/?p=57901
创作不易，用心坚持，请喝一怀爱心咖啡！继续坚持创作~~
