yoinks 终端视频下载器完整指南:30 秒装完,链接到文件只要三步
【免费下载链接】yoinksyoink any video from your terminal. no shady ads.项目地址: https://gitcode.com/GitHub_Trending/yo/yoinks
yoinks 是一个终端视频下载器,让你在命令行里从 YouTube、X、Instagram、TikTok 等 1800+ 站点下载视频或 MP3 音频。没有弹窗广告、没有假下载按钮、没有钓鱼跳转。
第1关|30 秒上手:安装与首次启动
前提只有一个:Node.js 18+。全局安装一条命令:
npm install -g yoinks不想安装就用npx yoinks临时跑,零配置。
裸运行yoinks,界面以全屏居中方式接管终端,退出时自动恢复你的滚动缓冲区。首次启动它替你办两件事:
- 把 yt-dlp 独立二进制下载到
~/.yoinks/bin,全程不用碰 Python(实现见 src/lib/ytdlp.ts);若系统已装 yt-dlp,直接复用 - 检查 PATH 里的 ffmpeg,找不到就用内置的
ffmpeg-static兜底
第2关|完成第一次下载:从链接到文件
- 输入链接:
yoinks <视频链接>直接进格式选择器;或裸运行后在输入框粘贴、回车。界面给出反馈:视频标题、来源、时长。 - 选择格式:↑/↓(或 j/k、数字键)移动光标,列表逐项显示分辨率与预估大小,例如
2160p · mp4 · ~232 MB,末项audio only · mp3是纯音频。 - 回车确认:开始下载,进度条给出速度与剩余时间;完成后终端打印
✓ yoinked → <文件路径>。
文件默认存到~/Downloads,整个下载流程由 src/app.tsx 驱动——整个过程就像把链接丢进浏览器,只是结果直接落盘。
第3关|效率玩法:命令行参数速查
| 命令 | 作用 |
|---|---|
yoinks <url> | 带链接直进格式选择器 |
yoinks --theme dark | 指定本次启动主题(auto / light / dark) |
yoinks --help | 查看帮助与示例 |
yoinks --version | 查看版本号 |
其余高频操作:
- 快捷键:回车确认、
esc返回、^c退出、^t在 auto / light / dark 间循环 - 鼠标:格式列表、yoink 按钮、底部提示都能点,点 Logo 回首页
- 历史:首页按 ↑ 调出最近 50 条下载链接,存于
~/.config/yoinks/history.json(实现见 src/lib/history.ts) - 主题:默认
auto跟随终端自身深浅色,参数解析在 src/lib/args.ts,配色定义在 src/theme.ts
第4关|看懂它:技术底座一句话
下载引擎是 yt-dlp 这个成熟开源项目,终端界面用 Ink(React for the terminal)搭成;yt-dlp 负责抓取与下载,yoinks 只负责选格式和画界面。当前 0.3.1 还很年轻,Roadmap 上排着--best/--mp3脚本模式、-o <dir>输出目录、播放列表支持(见 README.md)。
避坑区:常见问题
Q:需要装 Python 吗?不需要。yt-dlp 以独立二进制形式自动下载;系统里已有 yt-dlp 则直接复用。
Q:下载的文件存在哪?默认~/Downloads,完成后终端打印完整路径。
Q:高分辨率视频为什么要等?高码流要 ffmpeg 合并音视频两路流,PATH 里没有时由内置ffmpeg-static接管,合并时间计入等待。
Q:下载别人的视频合规吗?yoinks 定位为个人归档工具,只下载你有权保留的内容,尊重创作者。
收尾:3 个动作,1 条命令
yoinks 把"下载视频"这件杂事压缩成 3 个动作:粘贴、选择、回车。现在就可以敲下这条命令试试:
npx yoinks【免费下载链接】yoinksyoink any video from your terminal. no shady ads.项目地址: https://gitcode.com/GitHub_Trending/yo/yoinks
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考