☰
yoinks 快速上手:终端里下载视频,3 步跑通 5 分钟搞定
2026/10/16 2:44:41 网站建设 项目流程

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),仅供参考

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

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

立即咨询