如何不安装任何东西就用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),仅供参考