scheme-handler-cross

项目概述

Scheme-Handler 是一个用 Rust 重写的跨平台 URL Scheme 工具，支持 Windows、Linux 与 macOS。它让你为桌面应用注册自定义协议，从而在浏览器中一键唤起本地程序并传入参数。工具还提供可选的本地 HTTP Bridge，用于把浏览器脚本拿到的 m3u8 文本内容交给播放器。

把浏览器里的视频链接一键交给你本地的播放器。

主要功能

• 注册协议：为桌面应用添加自定义 URL Scheme，供浏览器唤起
• 跨平台支持：Windows、Linux 与 macOS 使用同一套操作
• 自定义参数：通过 gzip 压缩参数传递任意启动命令
• 图形界面：点按即可添加应用并写入注册表
• HTTP Bridge：可选的本地服务，把 m3u8 文本提供给播放器
• 多种安装包：提供 Inno Setup 安装程序、deb 包与 dmg 镜像

适用人群

• 想用本地播放器打开网页视频的用户
• 需要把浏览器调用本地程序的用户
• 使用 Windows、Linux 或 macOS 的进阶用户
• 编写油猴脚本的开发者

快速上手

1. 前往 Releases 下载对应平台的安装包，并按 RELEASE.md 说明安装
2. 打开程序，点击 + 添加应用
3. 在左侧输入框填写应用名称，在右侧选择需要调用的应用可执行文件，如 mpv.exe
4. 点击 + Add to Registry 完成注册
5. 浏览器脚本通过 ush://${app_name}?${gzip_args} 发起唤起

核心优势

• 一次配置：注册后浏览器即可长期唤起本地程序
• 隐私安全：Bridge 仅绑定 127.0.0.1，不监听局域网地址
• 可控缓存：m3u8 只存于内存，默认 30 分钟后自动清理
• 职责单一：Bridge 只保存与提供 m3u8，不代理视频分片

系统要求

项目	要求
操作系统	Windows、Linux、macOS
支持架构	Windows x86_64、Linux amd64、macOS x86_64 与 arm64
安装包类型	Windows portable EXE、deb、dmg

注意事项

• 应用名称必须与脚本中唤起的名称一致，大小写也需相同
• 只有 URL 中带有 needServer=1 时才会启动 HTTP Bridge
• Bridge 不处理 Referer、Cookie、Authorization 等鉴权信息，由播放器自行请求
• 单个 m3u8 最大 16 MiB，长时间不访问的内容会被自动清理