☰
3种方式给yoinks传链接:命令行参数、输入框与剪贴板检测全指南
2026/10/4 5:43:41 网站建设 项目流程

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/dQw4w9WgXcQ

yoinks 会跳过输入界面,直接进入"抓取视频信息 → 选择清晰度"流程,几乎零等待进入下载。参数解析逻辑在 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 按钮:

这个输入框有三个好用的小细节:

  1. 粘贴即自动提交:输入框为空时,只要粘贴的内容被识别为 URL,就直接开始下载,连回车都不用按(逻辑见 src/components/text-input.tsx);
  2. 输入不完整会温柔提醒:粘贴的不是合法链接时会提示 "that doesn't look like a link — paste a full url",不会盲目发起下载;
  3. 鼠标党友好: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):

平台使用的命令
macOSpbpaste
WindowsPowerShellGet-Clipboard
Linuxwl-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),仅供参考

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

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

立即咨询