yoinks：在终端下载视频或提取音频
一分钟看懂
yoinks 是一个基于 yt-dlp 的终端媒体下载工具。用户粘贴视频地址后，可以在全屏终端界面中选择分辨率或仅提取 MP3 音频，支持 YouTube、X、Instagram、Threads、TikTok 以及 yt-dlp 所覆盖的其他站点。
你可以用它做什么
- 将有权保存的在线视频下载到本地个人归档。
- 在终端中选择视频分辨率并查看估算文件大小。
- 仅提取音频并输出 MP3 文件。
- 在脚本开发或测试环境中调用同一命令行入口。
主要能力
项目使用 Ink 构建可交互终端界面，底层调用 yt-dlp 获取媒体信息和下载内容，并使用 ffmpeg 合并高分辨率音视频流或提取音频。若系统没有 yt-dlp，首次运行会把独立二进制文件下载到用户目录；ffmpeg 可使用系统版本或项目提供的静态回退版本。
适合哪些人
它适合熟悉命令行、希望避免网页下载站广告和跳转的个人用户，也适合需要快速查看可用媒体格式的开发者。需要批量、无交互自动化的用户应注意部分脚本化参数仍列在项目路线图中。
怎么开始使用
需要 Node.js 18 或更高版本。可执行 npm install -g yoinks 全局安装，也可以使用 npx yoinks 临时运行。传入媒体 URL 后在格式列表中选择下载项，文件默认保存到用户的 Downloads 目录。
使用前需要知道
下载内容可能受著作权、平台服务条款和地区法律约束，只应保存自己拥有权利或获得许可的内容。首次运行可能从网络下载 yt-dlp，处理高分辨率视频也需要磁盘空间、带宽和 ffmpeg 计算时间。项目仍较年轻，播放列表、输出目录参数和自动更新等能力在官方路线图中尚未完成。代码采用 MIT 许可证，但该许可证不授予第三方媒体内容的使用权。