CatCatch

M3U8 视频流下载器 — 从浏览器嗅探到本地下载转码，一站式完成。

English | 中文

---

功能特性

内置浏览器 + 智能嗅探

• 内置浏览器直接浏览网页，自动嗅探 M3U8/HLS 视频流
• 5 种嗅探模式（自动 / 网络拦截 / DOM 监听 / 深度扫描 / 伪装）
• 支持加密视频（AES-128-CBC 自动解密）
• 按域名配置嗅探模式，书签持久化绑定

高速下载

• 多线程并发分片下载（默认 8 并发，可配置 4/16/32）
• 断点续传，自动重试（指数退避）
• 多任务队列管理（最多 3 个同时下载）
• 部分分片失败时智能跳过，>=80% 成功率继续合并保存

转码与输出

• TS → MP4 自动转码（FFmpeg-kit / 系统原生 双后端）
• 自定义下载目录，支持 SD 卡（SAF）
• 下载完成通知，支持直接播放和打开目录

浏览器联动

• URL Scheme：catcatch://add?url=...&title=...
• 浏览器分享（ACTION_SEND）
• 静默模式：一键自动添加下载任务

更多功能

• 广告拦截（多层过滤，可配置开关）
• 书签管理（Favicon 自动获取）
• 多标签页浏览
• 深色模式（跟随系统 / 浅色 / 深色）
• SSL 严格模式（可选）

---

安装

从 Releases 页面下载最新 APK 安装。

最低版本：Android 8.0（API 26）

---

快速开始

方式一：内置浏览器

1. 打开 App → 窗口（浏览器）
2. 输入视频网站地址，浏览目标页面
3. 嗅探到 M3U8 后自动弹出结果面板
4. 选择链接 → 添加下载

方式二：手动添加

1. 复制 M3U8 链接
2. 打开 App → 主页 → 粘贴链接
3. 点击「开始下载」

方式三：浏览器插件联动

1. 在外部浏览器中嗅探到 M3U8 链接
2. 通过 URL Scheme 或分享功能发送到 CatCatch
3. 自动添加下载任务（静默模式）或手动确认

---

设置

设置项	说明
下载目录	手动输入或 SAF 选择器（支持 SD 卡）
并发任务数	1-5 个同时下载
分片并发数	4 / 8 / 16 / 32
转码模式	FFmpeg-kit（推荐）/ 系统原生 / 自动
静默添加	Deep Link 自动添加任务，跳过确认
广告拦截	自动过滤广告请求（默认开启）
嗅探超时	页面嗅探等待时间（默认 30 秒）
默认嗅探模式	按域名配置嗅探策略
SSL 严格模式	严格校验证书（默认关闭）
深色模式	跟随系统 / 浅色 / 深色
缓存管理	分类清理：浏览器缓存 / 下载缓存

---

URL Scheme

catcatch://add?url={M3U8_URL}&title={标题}&headers={JSON}

参数	必填	说明
url	是	M3U8 播放列表地址
title	否	视频标题（自动填充文件名）
headers	否	JSON 请求头，如 {"origin":"https://example.com"}

---

系统要求

• Android 8.0+（API 26）
• 存储权限（Android 10 以下）/ SAF（Android 10+）
• 通知权限（Android 13+）

---

开发

技术文档和开发指南请参阅 DEVELOPMENT.md。

# 调试版构建
./gradlew assembleDebug

# 发布版构建
./gradlew assembleRelease

---

许可证

MIT License