yoinks终端视频下载器从粘贴链接到文件落盘的下载体验全流程拆解【免费下载链接】yoinksyoink any video from your terminal. no shady ads.项目地址: https://gitcode.com/GitHub_Trending/yo/yoinks一分钟了解它是什么yoinks是一款运行在终端里的视频下载器口号很直白yoink any video. paste. yoink. done.粘贴链接按 yoink完事。它支持YouTube、X/Twitter、Instagram、Threads、TikTok 及另外 1800 网站全程没有弹窗、没有假下载按钮、没有可疑跳转。对新手最友好的三点零环境依赖只需 Node 18底层的 yt-dlp 和 ffmpeg 全部自动处理像网页一样直观全屏居中界面方向键选格式还支持鼠标点击无广告干扰纯终端体验粘贴链接即可开始下载安装终端视频下载器只需一条命令快速安装步骤npm install -g yoinks不想安装也可以直接跑一次试试npx yoinks首次运行时yoinks 会自动下载独立版 yt-dlp 到~/.yoinks/bin不需要装 Python如果你系统里已有 yt-dlp会优先使用你本地的src/lib/ytdlp.ts。ffmpeg 则从 PATH 中查找找不到时自动使用内置的ffmpeg-static兜底。第一步粘贴链接三种启动姿势启动方式有三种对应不同使用习惯方式命令适用场景带链接启动yoinks https://youtu.be/xxxx直奔主题跳过输入界面裸启动yoinks先打开界面再慢慢贴剪贴板接力复制好链接后执行yoinks最丝滑自动识别剪贴板第三种方式值得一提yoinks 启动时会读取剪贴板macOS 用pbpasteLinux 依次尝试wl-paste/xclip/xsel见 src/lib/clipboard.ts如果里面恰好是一个链接界面底部会提示link in your clipboard — ⇥ to paste it按Tab一键填入无需手动复制粘贴。输入框对链接做基本校验贴错内容会提示that doesnt look like a link不会白白浪费一次探测。第二步格式选择分辨率和大小一目了然提交链接后进入探测阶段warming up…→fetching video info…随后进入核心的格式选择器。左侧是视频标题、平台、时长和上传者右侧是下载选项列表例如▶ 2160p · mp4 · ~232 MB ▶ 1440p · mp4 · ~120 MB ▶ 1080p · mp4 · ~80 MB ... ♪ audio only · mp3 · ~3.3 MB几个设计细节很贴心每个选项都标注预估文件大小选之前心里有数♪前缀是纯音频 mp3选项只想要声音的人不用下整个视频选择操作支持↑/↓ 方向键、j/k、数字键或直接用鼠标点选列表超过 8 项时会自动收敛到最多 8 个视频档src/lib/ytdlp.ts避免刷屏第三步下载中进度条不会让你干等进入下载阶段后界面固定显示三行无论数值怎么跳动布局都不会跳动这是 src/app.tsx 里刻意做的固定行高设计████████████████░░░░░░░░░░ 58% part 1/2 12.4 MB/s 01:23 left进度条 百分比实现见 src/components/progress-bar.tsx速度与剩余时间12.4 MB/s · 01:23 leftpart 1/2高清晰度视频通常是「视频流 音频流」分开下载再用 ffmpeg 合并进度条走完第一部分会重置part x/y明确告诉你当前进行到哪一步合并/转码阶段会切换为processing…提示你不需要猜它卡没卡还有一个隐藏的健壮性设计如果探测缓存里的媒体链接过期导致下载失败yoinks 会显示link expired — grabbing a fresh one…并自动重新提取一次而不是直接报错甩锅给用户src/app.tsx。第四步文件落盘路径直接给你下载完成后文件保存到~/Downloads文件名即视频标题截取前 60 字符界面显示✓ yoinked! find your file in:加完整路径退出程序后终端还会再打印一行✓ yoinked → 路径方便接echo/open等后续命令按↵或点击yoink another按钮可以立刻下载下一个视频不用重新打开。实用小技巧快捷键、历史与主题按键作用↵确认 / 开始下载 / 再来一个↑↓/j k/ 数字键切换下载格式esc返回上一步或取消当前任务^c退出程序^t切换主题auto / light / dark↑输入界面调出历史记录几个容易被忽略的细节历史记录每次成功下载都会记录链接最多 50 条存于~/.config/yoinks/history.json见 src/lib/history.ts下次输入时按↑就能翻出来取消不留垃圾下载中途按esc取消已写了一半的.part/.ytdl临时文件会被自动清理不会在 Downloads 里留残骸src/lib/ytdlp.ts主题跟随终端默认auto模式会继承你终端的前景色和背景色深色浅色终端都不用手动调全程可鼠标操作yoink 按钮、格式列表、底部快捷键提示、甚至 logo点它回到首页都可以点退出恢复滚动历史yoinks 使用终端备用屏幕alternate screen退出后你的 shell 滚动记录原封不动幕后它是怎么做到的整个流程拆解成四个环节对应四个源码位置环节机制源码命令解析解析 URL、--theme、--helpsrc/lib/args.ts平台识别从域名匹配 YouTube、X 等平台标签src/lib/platforms.ts探测与下载调用 yt-dlp解析进度流src/lib/ytdlp.ts界面渲染ReactInk驱动的终端 UIsrc/app.tsx探测阶段会把 yt-dlp 返回的元数据-JJSON缓存到临时文件真正下载时用--load-info-json直接复用跳过二次提取所以从选格式到开始下载几乎是瞬间完成的。常见问题Q需要自己装 yt-dlp 或 ffmpeg 吗不需要。yt-dlp 首次运行自动下载独立二进制ffmpeg 找不到时用内置的ffmpeg-static兜底。Q支持哪些平台YouTube、X/Twitter、Instagram、Threads、TikTok 是主打其余 1800 站点由 yt-dlp 的能力覆盖Vimeo、Twitch、Reddit、Facebook 等都有专门识别。Q文件存在哪里固定保存到~/Downloads。自定义输出目录-o已在项目 Roadmap 中。Q合法合规吗yoinks 定位为个人存档工具。请只下载你有权保存的内容遵守平台条款尊重创作者。总的来说yoinks 把「复制 → 选格式 → 等下载 → 找到文件」这条链路压缩到了终端里能做到的最短一条命令、两个按键就能让视频稳稳落盘。相关模块路径速查src/cli.tsx入口、src/app.tsx主界面状态机、src/lib/ytdlp.ts探测与下载、src/lib/clipboard.ts剪贴板、src/lib/history.ts历史记录、src/components/progress-bar.tsx进度条【免费下载链接】yoinksyoink any video from your terminal. no shady ads.项目地址: https://gitcode.com/GitHub_Trending/yo/yoinks创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考