pablostanley/yoinks

来源：https://github.com/pablostanley/yoinks

yoinks

yoink 任意视频。粘贴。yoink。搞定。

从 YouTube、X/Twitter、Instagram、Threads、TikTok 以及 1,800+ 其他网站下载视频——直接在终端里完成。粘贴一个 URL，选择分辨率（或仅音频的 mp3），就完成了。没有弹窗，没有假下载按钮，没有可疑的重定向。

安装

npm install -g yoinks

或者不安装任何东西直接试用：

npx yoinks

需要 Node 18+。其他一切（yt-dlp、ffmpeg）都会自动获取或随包捆绑。

使用

$ yoinks https://youtu.be/dQw4w9WgXcQ # 直接进入格式选择器
$ yoinks # 提示输入 URL
$ yoinks --theme light # 强制使用浅色配色

yoinks 会接管终端（全屏、居中显示——退出时会恢复你之前的滚动回退内容）。用 ↑/↓（或 j/k，或数字键）选择格式，然后按回车。esc 返回，^c 退出。

也可以直接用鼠标操作——yoink 按钮、格式列表和底部提示都可以点击，点击 logo 可以返回首页。

文件保存到 ~/Downloads，完成后文件路径会打印在你的终端里。

默认的 auto 主题会使用你终端自身的前景色和背景色，因此会自动跟随终端的明暗主题，无需猜测。按下 ^t 或点击底部的主题控件，可在 auto、light 和 dark 之间为当前会话循环切换。使用 --theme auto、--theme light 或 --theme dark 可以为本次启动指定起始主题。

工作原理

• 基于 yt-dlp（https://github.com/yt-dlp/yt-dlp）。首次运行时，yoinks 会将独立的 yt-dlp 二进制文件下载到 ~/.yoinks/bin——无需 Python。如果你已经安装了 yt-dlp，它会直接使用你已有的版本。
• ffmpeg（用于合并高分辨率流和提取 mp3）会从你的 PATH 中查找，并以内置的 ffmpeg-static 作为兜底方案。
• 界面使用 Ink（https://github.com/vadimdemedes/ink）——终端版的 React。

开发

npm install
npm run build # 使用 tsup 打包到 dist/
npm run dev # 文件变更时重新构建
node dist/cli.js
npm run typecheck

如果想在不发布的情况下将其作为全局命令试用：运行 npm link，然后在任意位置执行 yoinks。

路线图

• --best / --mp3 参数，跳过选择器（可脚本化模式）
• -o 指定输出文件夹
• 播放列表 / 包含多个视频的 thread 支持
• 剪贴板检测：启动时不带参数，自动建议你复制的 URL
• 内置 yt-dlp 二进制文件的自更新（yt-dlp -U）
• 发布到 npm（npm i -g yoinks / npx yoinks）
• curl yoinks.sh | sh 安装脚本

关于合理使用的说明

yoinks 是一个个人归档工具。下载内容可能会违反平台的服务条款——只下载你有权保留的内容，请善待创作者。

许可证

MIT