yoinks 快速上手:终端里下载视频,3 步跑通 5 分钟搞定
【免费下载链接】yoinksyoink any video from your terminal. no shady ads.项目地址: https://gitcode.com/GitHub_Trending/yo/yoinks
yoinks 是一款终端视频下载工具:在命令行粘贴链接、选一个清晰度,视频就落到本地。它支持 YouTube、X/Twitter、Instagram、TikTok 等 1800+ 站点,没有弹窗,也没有广告跳转。如果你平时靠浏览器下视频、又不想折腾 Python 环境,这篇 5 分钟教程带你从零跑通。
认识 yoinks:一个干净的终端视频下载器
官方标语是 paste. yoink. done.——粘贴、下载、完成,就这么点事。
| 维度 | 传统做法 | yoinks |
|---|---|---|
| 界面 | 浏览器、弹窗广告、假下载按钮 | 接管整个终端,界面居中,退出时自动恢复滚动记录 |
| 依赖 | 手动装 Python + yt-dlp + ffmpeg | 自动下载 yt-dlp 独立二进制,无需 Python |
| 主题 | 无 | auto / light / dark,默认跟随终端配色 |
启动后的主页长这样,看到输入框就可以开始用了:
三种方式安装 yoinks 并验证环境
环境要求只有一条:Node.js 18+。其余依赖——yt-dlp(命令行下载引擎)和 ffmpeg(音视频处理工具)——都会自动拉取。
推荐:全局安装,一条命令装好:
npm install -g yoinks装完后任意目录都能直接敲yoinks。
免安装:npx 直接体验。只想试一次的话,不用安装任何东西:
npx yoinks首次运行会自动拉取依赖,稍等片刻即可进入界面。
源码构建:自己克隆编译。喜欢动源码的话:
git clone https://gitcode.com/GitHub_Trending/yo/yoinks cd yoinks npm install && npm run build node dist/cli.js构建产物在dist/目录,按最后一条命令运行即可。
任选一种方式装好后,跑这条命令确认版本:
yoinks -v预期结果:终端打印出当前版本号。
完成第一次视频下载:从粘贴到落盘
1. 启动并粘贴链接
两种方式启动,区别只是要不要先粘链接:
yoinks https://youtu.be/xxxx # 带链接,直接进入清晰度选择 yoinks # 不带参数,停在家页等你粘贴预期结果:带链接直接进格式选择界面;不带参数则看到主页输入框。启动时还会检测剪贴板,如果你刚复制过链接,会提示按⇥直接粘贴。平台识别逻辑见 src/lib/platforms.ts。
2. 选清晰度或只要音频
列表里每个档位都标了预估文件大小,底部还有♪ audio only · mp3选项——只想要播客音频就选它。选好档位按Enter确认,下载随即开始。
键盘操作对照:
| 操作 | 按键 |
|---|---|
| 上下选择 | ↑/↓或j/k,数字键可直选 |
| 确认下载 | Enter |
| 返回上一级 | Esc |
| 退出 | Ctrl + C |
| 切换主题 | Ctrl + T(auto → light → dark) |
3. 等待完成并确认文件
下载过程中有进度条、速度和预计剩余时间。结束后文件存入~/Downloads,终端会打印最终路径。历史自动记到~/.config/yoinks/history.json(最多 50 条,见 src/lib/history.ts),下次启动能直接翻记录,不用重复粘链接。
常用参数与快捷键速查
| 参数 / 操作 | 说明 |
|---|---|
--theme light | 强制浅色主题,也支持dark/auto |
--help | 查看帮助 |
-v | 查看版本 |
| 鼠标 | 按钮、清晰度列表、底部提示均可点击,点 logo 回主页 |
| 历史 | 主页可翻阅最近 50 条下载记录 |
参数解析实现在 src/lib/args.ts。
遇到问题怎么办:4 个高频问答
Q:需要装 Python 吗?A:不需要。yt-dlp 独立二进制会自动下载到~/.yoinks/bin;系统里已有 yt-dlp 时会优先用你的。见 src/lib/ytdlp.ts。
Q:能下哪些站?A:YouTube、X、Instagram、Threads、TikTok、Vimeo、Twitch,以及 yt-dlp 支持的全部 1800+ 站点。
Q:进度条为什么中途会重置?A:高分辨率视频是视频流、音频流分别下载,再用 ffmpeg 合并,属正常现象。
Q:界面颜色和终端不搭?A:默认auto主题跟随终端配色;想固定就用Ctrl + T循环切换,或启动时加--theme。
到这里,你的第一个「yoinked」视频已经跑通了,剩下的是享受终端里干净的下载体验。yoinks 定位是个人存档工具,请只下载你有权保留的内容,尊重创作者。
【免费下载链接】yoinksyoink any video from your terminal. no shady ads.项目地址: https://gitcode.com/GitHub_Trending/yo/yoinks
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考