终端视频下载工具 yoinks 怎么装、怎么下
【免费下载链接】yoinksyoink any video from your terminal. no shady ads.项目地址: https://gitcode.com/GitHub_Trending/yo/yoinks
网页下载器用多了都懂那种感觉：点一下"高速下载"，弹出来一个捆绑安装包，真正的文件还在第三层按钮后面。yoinks 把下载这件事搬回终端——一个跑在命令行里的视频下载工具，背后是成熟的 yt-dlp 引擎，覆盖 YouTube、X、Instagram、Threads、TikTok 在内的 1800+ 站点。流程只剩三步：给链接、挑格式、回车。
第一次跑起来：从安装到下载完成
环境要求只有一条：Node.js 18 及以上。装到全局：
npm install -g yoinks不想装也可以直接跑npx yoinks，临时用一次就行。首次运行不用做任何配置：yoinks 会先检测系统里有没有 yt-dlp，没有的话自动把独立二进制拉到~/.yoinks/bin（你已装好的 yt-dlp 会被直接复用），合并高清音视频流需要的 ffmpeg 同理——PATH 里有就用系统的，没有就用内置的ffmpeg-static兜底。
装完执行一条命令，把链接直接带上：
yoinks https://youtu.be/dQw4w9WgXcQ它接管整个终端（全屏、居中，退出时恢复你的滚动缓冲），探测到视频后弹出格式列表：用 ↑/↓（或 j/k、数字键）选中想要的分辨率，按↵，文件就落到~/Downloads，下载完成后终端会打印完整路径。
视频这样下
链接直下。yoinks <url>带着链接启动，跳过输入页直接进格式选择器，适合脚本里串流程。
裸跑再输入。直接执行yoinks，在输入框里粘贴或键入完整 URL，粘贴即触发提交；如果剪贴板里本来就放着一条链接，界面会提示你按⇥直接收下。
只提音频。格式列表最后一项是audio only · mp3，选中它，得到的就是 MP3 而不是视频文件——用命令行下载 MP3 也就是这么一次选择的事。列表里每个视频档位都标着预估大小，♪前缀是音频、▶前缀是视频。
复用历史。裸跑后按↑逐条翻出最近 50 条下载记录，↵选中即重新下载，esc放弃。记录存在~/.config/yoinks/history.json，新链接会自动置顶，重复的自动去重。
参数、主题与快捷键
| 命令 | 作用 |
|---|---|
yoinks <url> | 带链接启动，跳过输入页 |
yoinks | 进入输入页，等链接 |
--theme auto / light / dark | 指定本次启动的配色 |
-h/--help | 查看帮助 |
-v/--version | 查看版本号 |
主题默认auto，直接沿用终端自身的前景色和背景色，深浅色终端都不用猜；按^t可在 auto、light、dark 三档之间循环，改动只作用于当前会话。快捷键分四组：
- 选格式：↑/↓、j/k、数字键（视频档位最多 8 个）
- 确认与取消：
↵开始下载，esc取消或返回，^c退出 - 历史链接：
↑/↓翻最近 50 条，esc退出调用 - 换配色：
^t
不想敲键盘也行——格式列表、按钮、底部提示都能点，点 Logo 回到输入页。参数解析在 src/lib/args.ts，只认上面这些选项，写错会直接报出来；三档配色的具体色值定义在 src/theme.ts；鼠标点击命中哪块界面，由 src/lib/click-map.ts 按当前帧文本定位；历史链接的存取上限（50 条）写死在 src/lib/history.ts 里。
常见问题与坑
第一次用，进度条卡在 "fetching yt-dlp…" 很久？原因是首次运行正在下载 yt-dlp 独立二进制，文件不大但看网络。等它走完即可，只发生一次；如果你的机器已装 yt-dlp，这一步会被直接跳过。
下高清时，进度条快满了却突然清零？这不是卡死。yt-dlp 通常先把视频流、音频流分开下载，下完进入合并阶段，进度条按"第几个文件"重新计数，界面上会标出part 1/2这类信息。合并依赖 ffmpeg，找不到时会自动用内置的ffmpeg-static。
格式列表里什么都没有，或者提示该平台无法解析？yt-dlp 对单条链接生效，不支持播放列表，那是路线图上的事；站点解析失败多半是 yt-dlp 版本跟不上平台改版，升级你系统里的 yt-dlp 后重试通常就能解决。
下别人发的视频没问题吗？现象不算问题，属于边界：yoinks 定位是个人归档工具，下载内容可能触碰平台服务条款。解法只有一条——只下你有权保留的内容，尊重创作者。
接下来
yoinks 现在处于 0.3.x 阶段，迭代很勤。官方 Roadmap 上排着的有：--best/--mp3参数直接跳过选择器、-o <dir>指定输出目录、播放列表支持、启动时自动读取剪贴板里的 URL、内置 yt-dlp 的自更新。等功能补齐，脚本化下载会再省一步。终端里缺一个干净下载工具的话，npx yoinks现在就能跑。
【免费下载链接】yoinksyoink any video from your terminal. no shady ads.项目地址: https://gitcode.com/GitHub_Trending/yo/yoinks
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
