yoinks：终端里的视频下载

它包的是什么

底层就是 yt-dlp——你已经有 yt-dlp 的话，yoinks 解决的是参数组合难记的问题，不是下载能力本身。

shnpm install -g yoinks

或者不装直接跑：

shnpx yoinks

要求 Node 18+。其余依赖会自动获取或打包。

三条最常用的命令

shyoinks https://youtu.be/dQw4w9WgXcQ    # 直接进格式选择
yoinks                                 # 提示你输入 url
yoinks --theme light                   # 强制浅色配色

界面怎么操作

yoinks 会接管终端（全屏、居中，退出时恢复你的 scrollback）：

鼠标也能用：yoink 按钮、格式列表、页脚提示都可点，点 logo 回首页。

格式列表里除了各档分辨率，还有只要音频的 mp3，并标出预计文件大小。

主题

默认的 auto 主题用你自己终端的前景色和背景色，所以它会跟着你的明暗主题走，不用它猜。

• --theme auto / --theme light / --theme dark —— 指定某次启动的初始主题
• 运行中按 ^t 或点页脚主题控件，在 auto / light / dark 之间循环（仅当次会话有效）

它怎么工作

• yt-dlp —— 首次运行时 yoinks 把独立的 yt-dlp 二进制下载到 ~/.yoinks/bin，不需要 Python。你本地已经装了 yt-dlp 就用你的
• ffmpeg —— 从 PATH 找，找不到用打包的 ffmpeg-static 兜底。合并高清流和提取 mp3 需要它
• UI —— Ink（在新标签页打开），也就是「终端里的 React」

现在还不能做的（别按脚本工具规划）

roadmap 上还没实现的：

• --best / --mp3 跳过选择器的标志（可脚本化模式）
• -o <dir> 指定输出文件夹
• 播放列表 / 长帖多视频支持
• 剪贴板检测（直接启动并自动建议你刚复制的 url）
• 内置 yt-dlp 二进制自更新

已完成的是发布到 npm（也就是 npm i -g yoinks / npx yoinks 那条）。

这意味着现在每次下载都要走一遍交互界面。 批量下载、定时下载、接进自动化流程——这些场景它帮不上。已完成的 checkbox 只有发布到 npm 那项。

开发

shnpm install
npm run build        # 用 tsup 打包到 dist/
npm run dev          # 改动后重建
node dist/cli.js <url>
npm run typecheck

想不发布就在本地当成全局命令用：npm link，之后在任何目录跑 yoinks。

合理使用

README 里作者自己写了一段，意思值得原样记住：yoinks 是个人归档工具，下载内容可能违反某个平台的服务条款——只下载你有权保留的内容，并对创作者保持尊重。

评估供应链时要知道

yoinks 会在首次运行时下载并执行第三方二进制（yt-dlp）。这是它的设计带来的便利（省掉装 Python），但如果你所在环境对供应链有要求，这是需要自己评估的一点。本地已有 yt-dlp 时它会用你的版本。