yoinks 完整指南：1800+ 站点的终端视频下载快速上手

【免费下载链接】yoinksyoink any video from your terminal. no shady ads.项目地址: https://gitcode.com/GitHub_Trending/yo/yoinks

在浏览器里搜"下载视频"，经常要走一段弯路：假下载按钮、捆绑了不明组件的安装包、几跳之后才见到真正的文件。yoinks 的做法是把终端视频下载这件事搬回你自己的终端：输入链接、挑一个清晰度，文件就落到下载目录里。它的底层引擎是开源的 yt-dlp，站点覆盖 1,800+ 家，包括 YouTube、X/Twitter、Instagram、Threads、TikTok，适合 YouTube 视频存档这类个人归档场景；命令行里没有广告和多余选项，输入什么就执行什么。

一条命令装好，零配置完成终端视频下载

环境要求只有一条：Node 18 及以上。全局安装只需一行：

npm install -g yoinks

不想装全局的话，用npx yoinks临时跑一次即可（npx 可以运行 npm 包的命令而不把它写进系统）。

首次运行也是全自动的：系统里没有 yt-dlp（一个在命令行里跑的视频下载引擎）时，yoinks 会把独立二进制下载到~/.yoinks/bin（逻辑见 src/lib/ytdlp.ts）；已经装过 yt-dlp 的话则直接复用你现有的。这是一个免 Python 的视频下载工具，全程不需要安装或配置 Python。

三个常见场景怎么用

带链接直达下载选择

启动时把链接作为参数传入，跳过输入环节：

yoinks <视频链接>

进入格式选择器后，用↑/↓或j/k、数字键移动光标，挑一个分辨率，回车确认。下载目标是~/Downloads，完成后终端会打印文件完整路径。

裸运行，交互式挑清晰度和 MP3

直接敲yoinks进入链接输入框，粘贴后能看到每一档可选的画质和预估体积：

选到audio only · mp3这一项时，只会把音频提取成 MP3，不保留视频画面。背后对应哪些 yt-dlp 命令行下载参数，你不需要记，选择会自动翻译。

一键切换主题

主题默认auto，跟随你终端自身的深浅配色。会话内切换有两种方式：按^t，或点击底部的主题按钮，依次在auto/light/dark三种模式间轮换；想用固定主题启动则加--theme参数。参数解析逻辑在 src/lib/args.ts。

快捷键怎么按

常用按键速查：

常用参数速查：

三个值得一提的工程细节

• 最近 50 条历史，↑ 键随时召回：下载记录会存进~/.config/yoinks/history.json，裸运行后按↑即可调出最近 50 条，同一个链接不用再粘贴第二遍，实现见 src/lib/history.ts
• 鼠标全程可用：格式列表、yoink 按钮、底部提示栏都响应点击，点 Logo 能回到首页。底层做法是保留每帧渲染出的文本，点击发生后再按文字反查坐标落在哪个控件上，见 src/lib/click-map.ts
• ffmpeg 自动兜底：高分辨率流的音视频分离合并依赖 ffmpeg（音视频处理工具），先在系统 PATH 中找，找不到就退回内置的ffmpeg-static，逻辑同样在 src/lib/ytdlp.ts

界面用 Ink（一个用 React 语法写终端界面的框架）全屏居中渲染，退出时恢复你原来的终端滚动记录，入口是 src/app.tsx。

常见问题与使用边界

Q：机器里没有装 Python，能跑吗？能。yt-dlp 以独立二进制形式自动下载，系统里已有则直接复用，全程不涉及 Python。

Q：下载文件存在哪？默认是~/Downloads，下载结束时终端打印完整路径，一眼就能找到文件。

Q：以前的下载链接还能调出来吗？能。裸运行后按↑会列出最近 50 条记录，重复下载不用重新粘贴链接。

Q：鼠标可以全程操作吗？可以。格式列表、yoink 按钮和底部提示栏都能点，点 Logo 回首页。

Q：下载别人平台上的内容，边界在哪里？yoinks 定位为个人归档工具。下载内容可能触碰平台服务条款，建议只保存你有权保留的内容，尊重创作者的权益。

下次想存一个视频时，不必先装任何东西：在终端敲npx yoinks，就能开始第一次下载。

【免费下载链接】yoinksyoink any video from your terminal. no shady ads.项目地址: https://gitcode.com/GitHub_Trending/yo/yoinks