3种方式给yoinks传链接:命令行参数、输入框与剪贴板检测全指南
【免费下载链接】yoinksyoink any video from your terminal. no shady ads.项目地址: https://gitcode.com/GitHub_Trending/yo/yoinks
yoinks 是一款运行在终端里的免费视频下载工具,支持 YouTube、X、Instagram、TikTok 等 1800+ 网站。新手最常见的疑问是:链接到底怎么"喂"给它?答案是:yoinks 视频下载器提供了 3 种传链接方式——命令行参数、程序内输入框、剪贴板自动检测,分别适合一次性下载、临时使用和"已经复制好链接"的场景。本文带你逐一上手。
🚀 30秒安装 yoinks
npm install -g yoinks不想安装也行,直接:
npx yoinks要求 Node 18+,yt-dlp 和 ffmpeg 会在首次运行时自动获取,无需额外配置。
方式一:命令行参数,一条命令直达下载
这是最快捷的方式,适合你明确知道要下载哪个视频,或在脚本中批量使用时。把 URL 直接跟在命令后面:
yoinks https://youtu.be/dQw4w9WgXcQyoinks 会跳过输入界面,直接进入"抓取视频信息 → 选择清晰度"流程,几乎零等待进入下载。参数解析逻辑在 src/lib/args.ts 中实现,它还会做两个贴心校验:
- 传了多个 URL 会报错
expected a single url,防止误操作; - 支持
--theme auto / light / dark指定本次启动的主题,例如yoinks --theme light <url>。
查看帮助随时可用yoinks --help(见 src/cli.tsx 中的帮助文本)。
方式二:程序内输入框,粘贴即下载
直接裸启动 yoinks(不带任何参数):
yoinks你会看到居中全屏的主界面,中间是一个"Paste a link"输入框,旁边配有醒目的 yoink 按钮:
这个输入框有三个好用的小细节:
- 粘贴即自动提交:输入框为空时,只要粘贴的内容被识别为 URL,就直接开始下载,连回车都不用按(逻辑见 src/components/text-input.tsx);
- 输入不完整会温柔提醒:粘贴的不是合法链接时会提示 "that doesn't look like a link — paste a full url",不会盲目发起下载;
- 鼠标党友好:yoink 按钮、底部快捷键提示都可以直接点击,点 logo 可回到主界面(点击热区在 src/lib/click-map.ts 中实现)。
另外,输入框上方支持用↑键调出下载历史,重复下载看过的视频不用再翻浏览器记录。
方式三:剪贴板检测,已复制链接按 Tab 秒填
最丝滑的场景是:你刚在浏览器里复制了一个视频链接,打开终端跑yoinks,然后……什么都不用粘贴。
yoinks 启动时会主动读取你的系统剪贴板(见 src/cli.tsx):如果内容恰好是一条 URL,界面下方会浮现一行提示:
link in your clipboard — ⇥ to paste it
此时只需:
- 按Tab(⇥):把剪贴板里的链接填入输入框,提示变成 "from your clipboard — ↵ to yoink it";
- 再按Enter(↵):正式开下。
剪贴板读取兼容三大平台(实现见 src/lib/clipboard.ts):
| 平台 | 使用的命令 |
|---|---|
| macOS | pbpaste |
| Windows | PowerShellGet-Clipboard |
| Linux | wl-paste/xclip/xsel(自动逐个尝试) |
两个安全细节值得注意:剪贴板内容必须是不含空白的单行 URL才会被识别(防止多行文本被误当成链接),而且只有在交互式终端(TTY)下才启用检测——管道或重定向场景不会误读剪贴板。
三种方式怎么选?一张表看懂
| 方式 | 命令 | 适合场景 | 速度感 |
|---|---|---|---|
| 命令行参数 | yoinks <url> | 明确知道链接、写脚本 | ⚡ 最快 |
| 输入框粘贴 | yoinks后粘贴 | 链接在手边、临时下载 | ⚡ 快 |
| 剪贴板检测 | yoinks后按 Tab | 链接刚从浏览器复制 | 🚀 最省事 |
三者殊途同归:链接到位后,都会进入下一步——选择画质下载。
链接传完之后:选清晰度,开下
无论用哪种方式传入链接,yoinks 都会列出该视频所有可选画质,并估算每档的文件大小,最底部还有纯音频的 mp3 选项:
用↑/↓(或 j/k、数字键)选择后按 Enter 即可,文件默认保存到~/Downloads,完成后终端会打印✓ yoinked → <文件路径>。想连续下载多个视频,完成页的 "yoink another" 按钮一键回到输入框。
常见问题
Q:剪贴板里有内容但没出现 Tab 提示?说明剪贴板内容不是"单行、无空白的 URL",或者当前不是交互式终端。此时用方式二手动粘贴即可。
Q:命令行里可以跳过选画质直接下最好的吗?目前版本每次都会经过选择面板,--best/--mp3跳过式参数已在路线图中(见 README.md),值得期待。
Q:下载内容要注意什么?yoinks 是个人存档工具,请只下载你有权保留的内容,尊重原创作者。
写在最后
命令行参数、输入框粘贴、剪贴板自动检测——三种方式覆盖了从脚本化到零操作的全部习惯。装好 yoinks,复制链接,yoinks,Tab,Enter:终端视频下载,真的可以只有四步。
【免费下载链接】yoinksyoink any video from your terminal. no shady ads.项目地址: https://gitcode.com/GitHub_Trending/yo/yoinks
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考