终端视频下载工具

pablostanley/yoinks 是一个用 TypeScript 编写的终端视频下载工具（MIT，2805 Stars 今日 +356），通过粘贴 URL 即可从 YouTube、X/Twitter、Instagram、Threads、TikTok 等 1800+ 网站下载视频或音频，界面基于 Ink（终端版 React），由 yt-dlp 驱动，主打无广告、无弹窗、无虚假下载按钮、无可疑重定向的干净体验；要求 Node 18+，可 npm install -g yoinks 全局安装或 npx yoinks 免安装试用，yt-dlp 与 ffmpeg 会被自动获取或内置（首次运行下载独立 yt-dlp 二进制到 ~/.yoinks/bin，无需 Python；已有 yt-dlp 则复用；ffmpeg 优先从 PATH 查找、以 ffmpeg-static 作后备）；使用 `yoinks <url>` 直接进入格式选择器，`yoinks` 提示输入 URL，`--theme light` 强制浅色配色；全屏居中终端界面，退出时恢复滚动历史，↑/↓ 或 j/k 或数字键选择格式回车确认、esc 返回、^c 退出，支持鼠标操作（yoink 按钮、格式列表、页脚提示可点击，点击 logo 返回主页）；文件默认保存到 ~/Downloads 并打印路径；默认 auto 主题使用终端自身前景/背景色自动适配明暗，可通过 ^t 或点击页脚主题控件在 auto、light、dark 间切换当前会话主题，也用 --theme auto/light/dark 指定启动主题；开发上 npm install 装依赖、npm run build（tsup 打包到 dist/）、npm run dev 变更重建、node dist/cli.js <url> 运行、npm run typecheck 类型检查、npm link 本地链接为全局命令；路线图待办含 --best/--mp3 跳过选择器（可脚本化）、-o <dir> 输出目录、播放列表/多视频线程、剪贴板检测自动建议已复制 URL、内置 yt-dlp 二进制自更新（yt-dlp -U）、curl yoinks.sh | sh 安装脚本（发布到 npm 已完成）；项目定位个人存档工具，提醒下载内容可能违反平台服务条款，应仅下载有权保留的内容并尊重创作者。