☰
如何不安装任何东西就用npx yoinks下载视频?
2026/10/4 3:10:07 网站建设 项目流程

如何不安装任何东西就用npx yoinks下载视频?

【免费下载链接】yoinksyoink any video from your terminal. no shady ads.项目地址: https://gitcode.com/GitHub_Trending/yo/yoinks

想从终端下载视频,又不想折腾一堆依赖?yoinks是一个运行在终端里的视频下载工具:粘贴链接,选择清晰度,回车,搞定。它支持 YouTube、X/Twitter、Instagram、Threads、TikTok 等 1800+ 网站,没有弹窗广告、没有假下载按钮、没有乱七八糟的重定向。最关键的是——你可以用一条npx yoinks命令零安装直接体验,无需npm install -g,也无需安装 Python。

为什么推荐用 npx 而不是直接安装

传统的命令行下载工具往往需要你手动装 Python、yt-dlp、ffmpeg 等一串依赖,新手很容易卡在环境配置上。yoinks 的设计目标是"粘贴即下载":

  • npx 按需运行:Node 的npx会在本地临时拉取并执行包,用完即走,不污染全局环境;
  • 依赖自动搞定:首次运行时,yoinks 会自动下载独立的 yt-dlp 二进制文件到~/.yoinks/bin(不需要 Python);如果系统里已有 yt-dlp,就直接复用你的;
  • ffmpeg 兜底:高清流合并和 MP3 提取需要 ffmpeg,工具会先找系统 PATH 里的,找不到就使用内置的ffmpeg-static。

也就是说,只要你装了Node 18+,一条命令就能开跑。相关逻辑可以参见 src/lib/ytdlp.ts 与 src/cli.tsx。

npx yoinks 快速上手:三步完成首次下载

第一步:运行命令

npx yoinks

首次运行会显示"first run: fetching yt-dlp…",稍等片刻即可进入全屏界面。

第二步:粘贴链接

程序启动后会自动进入居中的全屏界面。如果你的剪贴板里已经有一条视频链接,yoinks 会直接提示你按 Tab 粘贴;否则手动粘贴 URL 即可。界面如下,输入框右侧就是标志性的yoink按钮:

第三步:选择清晰度,回车下载

npx yoinks https://youtu.be/dQw4w9WgXcQ # 直接带链接启动,跳过输入框

下载的文件默认保存到~/Downloads,完成后终端会打印完整文件路径:

✓ yoinked → /home/you/Downloads/Rick Astley - Never Gonna....mp4

分辨率选择界面:还能顺便提取 MP3 音频

选定视频后,yoinks 会列出所有可用格式,每项都标注了清晰度、封装格式和预估文件大小,最后一项还是"仅音频 MP3",非常适合只想要声音的场景(比如通勤听播客式听视频):

选择方式很灵活:

操作效果
↑/↓或j/k上下移动选择
数字键直接选中对应序号的格式
Enter(或鼠标点击 yoink 按钮)开始下载
Esc返回上一级
Ctrl+C退出程序
Ctrl+T在 auto / light / dark 三种主题间切换

界面里的按钮、格式列表和底部快捷键提示全部支持鼠标点击,点一下 Logo 就能返回首页,完全不必担心"终端只能键盘党"。

常用命令与参数速查

完整参数解析见 src/lib/args.ts,常用用法如下:

命令说明
npx yoinks无参启动,进入界面后提示输入链接
npx yoinks <url>直接传入 URL,一步进入格式选择
npx yoinks --theme light本次启动强制浅色主题(也支持dark、auto)
npx yoinks -h查看帮助
npx yoinks -v查看版本号

主题默认是auto——它会跟随你终端的前景色和背景色,浅色终端、深色终端都能自然适配,这也是新手最省心的选择。

原理一句话讲清楚

yoinks 的底层是著名的 yt-dlp,UI 则是用 Ink(终端版的 React)实现的,所以你能看到一个像网页应用一样精致的全屏交互界面,但它本质仍是一个纯命令行工具,退出时会自动还原你的终端滚动缓冲,不留残影。更多细节可参考 README.md 和 src/app.tsx。

常见问题 FAQ

Q:npx yoinks 和我的电脑冲突吗?不会。npx 运行在临时目录中,不往系统里写入全局包;唯一持久化的文件是缓存在~/.yoinks/bin的 yt-dlp 二进制,下次运行直接复用,不重复下载。

Q:一定要带链接启动吗?不是。裸命令npx yoinks启动后会提示输入 URL,还会智能检测剪贴板里的链接供你一键粘贴。

Q:Windows 能用吗?可以。Windows 下会自动下载yt-dlp.exe对应版本(见 src/lib/ytdlp.ts 中的平台判断逻辑)。

Q:下载的东西放哪?默认在~/Downloads(Windows 为用户目录下的 Downloads 文件夹),完成后路径会直接打印在终端里。

Q:想研究源码?仓库是 MIT 协议开源的,如需本地克隆体验,可用地址:https://gitcode.com/GitHub_Trending/yo/yoinks

写在最后

yoinks 的定位是"个人存档工具":下载内容可能会涉及平台的服务条款,请只下载你有权保留的内容,并善待创作者。

一句话总结:装好 Node 18+,输入npx yoinks,粘贴链接,选清晰度,回车——视频下载这件事,第一次变得这么简单。🚀

【免费下载链接】yoinksyoink any video from your terminal. no shady ads.项目地址: https://gitcode.com/GitHub_Trending/yo/yoinks

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询