ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

MediaGo 桌面客户端配合猫爪(Cat Catch)浏览器扩展一键调起下载视频

MediaGo 桌面客户端配合猫爪(Cat Catch)浏览器扩展一键调起下载视频 音视频桌面应用后端【免费下载链接】mediago跨平台视频提取工具支持流媒体下载、视频下载、m3u8 下载及 B站视频下载提供 Windows 和 Mac 桌面客户端。Cross-platform video extraction tool: Supports streaming download, video download, m3u8 download, and Bilibili video download, with desktop clients for Windows and Mac.项目地址https://gitcode.com/caorushizi/mediago点击查看免费下载导读本文介绍如何在 Cat Catch猫爪浏览器扩展中配置自定义调用程序让浏览器里嗅探到的流媒体资源一键直达 MediaGo 桌面客户端并自动发起下载。读完本文你将掌握猫爪调用程序配置项的完整命令与每个参数的作用、MediaGo 自定义协议mediago-community://的解析链路与安全校验机制以及多选资源批量调用、静默下载等实战用法。前置条件安装最新版 猫爪Cat Catch 浏览器扩展已安装 MediaGo 桌面客户端Windows / macOS。本教程默认配置适用于 MediaGo 社区版mediago-community协议。本教程由社区用户1颗温暖的心提供基于其原始教程整理并辅以 MediaGo 仓库源码验证。感谢原作者的贡献。一、猫爪是什么与 MediaGo 的分工猫爪Cat Catch是一个浏览器视频嗅探扩展能在当前页面中捕获音频、视频、m3u8 等流媒体资源并列出链接列表。但它本身不负责下载解析与任务管理而 MediaGo 桌面客户端则负责把资源链接真正下载成文件支持流媒体、m3u8、B 站视频等详见 README.zh.md。两者结合后工作流程为浏览器页面播放视频 ↓ 猫爪嗅探 猫爪面板列出视频资源可选择一条或多条 ↓ 点击下载调起自定义协议 mediago-community:// 协议链接 ↓ MediaGo 解析并校验 MediaGo 弹出下载窗口并开始下载二、在猫爪中添加 MediaGo 调用程序打开猫爪扩展的设置页在设置中新增一个调用程序外部调用/自定义程序填入下面配置命令单条下载静默导入弹出下载确认直接下载跳过确认立即开始保存后猫爪面板中每条资源的下载按钮即可直接调用 MediaGo。提示不同版本猫爪的设置入口名称略有差异如调用程序外部程序但均为名称 命令行两个字段本教程只用到命令行字段。三、配置命令逐段拆解猫爪调用程序使用模板变量语法类似 Shell 的${}展开与管道过滤器将当前资源的元数据拼装成 MediaGo 的自定义协议链接。命令核心结构mediago-community://index.html/?ntruename${title}url${url|to:urlEncode}headers${referer|exists:Referer:*|to:urlEncode}silenttruedownloadNowfalse按段说明段含义说明mediago-community://协议 scheme需与客户端注册的 scheme 完全一致见下文第四、五节index.html/协议目标路径客户端按此路径分发详见第五节解析逻辑?ntrue标识携带下载参数让客户端将本链接识别为一次有效的下载调用name${title}下载文件名取自猫爪捕获到的资源标题url${url\|to:urlEncode}视频资源真实地址经to:urlEncode做 URL 编码避免特殊字符破坏协议链接headers${referer\|exists:Referer:*\|to:urlEncode}请求头当存在 Referer 时才携带并编码Referer 用于部分防盗链站点绕过校验silenttruedownloadNowfalse静默与自动下载开关静默导入参数但关闭自动开始下载参数行为对照表参数取值示例效果silenttrue/falsetrue时静默导入下载任务而不弹窗打扰downloadNowtrue/falsetrue时导入后立即开始下载false时仅加入任务列表等待手动开始typem3u8、direct等显式指定资源类型可选不传时客户端自动推断见第六节name任意标题下载任务显示名称可选url编码后的资源地址必填资源真实地址headers编码后的Referer: xxx等可选用于带 Referer 的防盗链资源注意url中的特殊字符必须经过 URL 编码to:urlEncode否则可能导致协议链接被截断或解析错误。防盗链与 Referer 的传递猫爪模板的exists过滤器会在资源存在 Referer 时才拼接Referer:*避免无 Referer 的资源携带空头。客户端拿到该参数后会把 Referer 一并带给下载引擎从而在部分需要校验来源的站点上提高下载成功率。这是本配置对只能看不能存的防盗链视频最实用的部分。四、MediaGo 侧自定义协议的注册原理MediaGo 桌面客户端在启动时会把mediago-community注册为默认协议客户端代码位于 apps/electron/src/index.tsif (process.defaultApp) { app.setAsDefaultProtocolClient(defaultScheme, process.execPath, [ ... ]); } else { app.setAsDefaultProtocolClient(defaultScheme); }同时通过protocol.registerSchemesAsPrivileged将mediago-community声明为secure安全与standard标准协议确保协议链接可被 Electron 正确处理。协议实际内容的分发则由 ProtocolService 完成当收到mediago-community://index.html/...之类的链接时protocol.handle将路径映射到渲染层页面index.html从而唤起主窗口或下载弹窗。协议 scheme 常量在 apps/electron/src/constants/index.ts 中定义即mediago-community。如果将来客户端更换 scheme猫爪配置中的协议前缀也要同步更换。五、客户端如何解析这份链接参数与安全校验MediaGo 收到协议链接后由 share-intent-parser.ts 负责解析其核心规则如下链接形式处理结果mediago-community://open仅唤起/聚焦窗口不携带下载意图mediago-community://share?...标准分享意图解析出下载任务mediago-community://index.html/?...兼容旧版自动动作的格式其中ntrue表示携带下载参数其它mediago-community://unknown拒绝视为无效对于下载意图解析器会从查询参数中提取url或旧格式的encodedURL、name、type然后交给 normalizeShareIntent 做安全校验协议白名单url只允许http:/https:Electron 端额外允许file:与magnet:javascript:等危险协议会被拒绝——这一点由单元测试 share-intent-parser.test.ts 中rejects unrelated targets and unsafe payloads用例覆盖长度上限url最长 16 KiB、name最长 512 字符超出即丢弃类型推断未显式传type时根据域名与路径自动推断B 站、YouTube、TikTok/抖音、小红书、*.m3u8等推断不到则归为direct。解析完成后意图进入 ShareIntentService 的任务队列同一urlnametype在 2 秒内去重队列最多缓存 20 个待处理意图随后通过IpcEvent.app.shareIntentAvailable通知渲染层弹出下载表单。六、下载类型自动推断一条 url 就够了即使猫爪配置里不显式传typeMediaGo 也能根据资源地址自动判断下载类型见 packages/common/src/utils/share-intent.ts 中的inferDownloadType资源地址特征推断类型b23.tv/bilibili.com及子域名bilibiliB 站视频youtube.com/youtu.be等youtubev.douyin.com/douyin.com/video/...等youtube短视频统一下载通道xhslink.com/xiaohongshu.com/explore|discovery/item/...xiaohongshu小红书*.m3u8路径m3u8HLS 流媒体其它direct直链下载这意味着猫爪面板里嗅探到的绝大多数资源——不管是 m3u8 直播流、B 站视频还是普通直链——只要url正确MediaGo 都会自动选用合适的下载引擎。如果遇到推断不准确的情况可在配置命令中追加typexxx显式指定。七、静默与自动下载silent与downloadNow的取舍原教程配置将silenttrue与downloadNowfalse组合使用效果是猫爪点击下载后MediaGo 静默接收任务并放入下载列表但不会立刻开始下载等待用户在客户端里确认或手动触发。如果你希望点击即下载可改用...silenttruedownloadNowtrue需要注意的是仓库代码中旧版协议的自动动作silent/downloadNow直接触发已被策略性禁用解析器遇到旧格式携带这两个参数时会生成一条legacy-auto-action-disabled警告而非直接执行见 share-intent-parser.ts 与对应测试用例因此请优先使用本文推荐的新版格式。八、常见问题与排查现象可能原因与排查点击下载无反应确认 MediaGo 已安装并至少启动过一次协议注册在启动时完成检查猫爪配置的协议前缀是否为mediago-community://提示协议无法识别客户端版本较旧或 scheme 已被其它程序占用在系统设置中检查协议关联下载开始但速度慢/失败资源本身防盗链严重确认配置已携带headers${referer|exists:Referer:*|to:urlEncode}任务被去重同一资源在 2 秒内重复点击会被客户端去重ShareIntentService 的DEDUP_WINDOW_MS稍等片刻再试即可中文文件名乱码检查name是否经过to:urlEncode编码未编码的特殊字符可能被截断九、补充猫爪面板中的批量选择猫爪面板支持在资源列表中勾选多条资源再点击底部的下载按钮此时配置的调用程序会按选中资源逐条生成协议链接并调起 MediaGo。MediaGo 侧的任务队列会依次接收并排队队列上限 20 条超出后丢弃最旧任务见 share-intent.service.ts因此批量下载时建议一次不要勾选过多以免最早的任务被挤出队列。结语通过猫爪的自定义调用程序与 MediaGo 的mediago-community://协议你可以在浏览器里完成嗅探 → 选中 → 一键下载的完整闭环且 MediaGo 端有协议白名单、长度上限、去重队列等多重防护调用过程安全可靠。若需更深入的协议解析细节可直接阅读仓库中的 share-intent-parser.ts、share-intent.ts 及其测试文件。赞分享音视频桌面应用后端【免费下载链接】mediago跨平台视频提取工具支持流媒体下载、视频下载、m3u8 下载及 B站视频下载提供 Windows 和 Mac 桌面客户端。Cross-platform video extraction tool: Supports streaming download, video download, m3u8 download, and Bilibili video download, with desktop clients for Windows and Mac.项目地址https://gitcode.com/caorushizi/mediago点击查看免费下载相关推荐猫抓Cat-Catch浏览器视频下载神器深度解析猫抓Cat Catch浏览器视频下载神器深度解析 在当今数字化时代网页视频已成为我们获取信息的重要渠道。然而许多在线视频资源并不提供直接的下载选项这让内音视频webnovel-writer 长篇网文辅助mainline_ready 到底查什么preflight 和 doctor 如何快速分清webnovel writer 长篇网文辅助mainline_ready 到底查什么preflight 和 doctor 如何快速分清 webnovel w人工智能AI 应用AI 写作RAGAI 插件AI 技能猫抓浏览器扩展一键解锁网页视频下载新境界猫抓浏览器扩展一键解锁网页视频下载新境界 猫抓浏览器扩展是一款功能强大的网页资源嗅探工具能够帮助用户轻松捕获和下载网页中的视频、音频等媒体资源。无论是在线课音视频上一篇Frogmouth开源项目安装与使用教程下一篇Doorkeeper开源OAuth2授权服务器实现创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表