# 流媒体下载

**Repository Path**: zhecodefactory/streaming-media-download

## Basic Information

- **Project Name**: 流媒体下载
- **Description**: 流媒体下载软件开源版本
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-22
- **Last Updated**: 2026-09-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# M3U8 嗅探下载工具

一套完整的 M3U8 流媒体嗅探下载解决方案，包含浏览器插件和 Tauri 桌面客户端。

## 项目结构

```
├── chrome-extension/          # 浏览器插件项目
│   ├── manifest.json         # 插件配置文件
│   ├── popup.html            # 弹窗界面
│   ├── popup.css             # 样式文件
│   ├── popup.js              # 弹窗逻辑
│   ├── background.js         # 后台脚本
│   └── icons/                # 插件图标
│
└── tauri-client/             # Tauri 客户端项目
    ├── src/                  # Vue3 前端源码
    │   ├── views/           # 页面组件
    │   ├── App.vue          # 主组件
    │   └── main.ts          # 入口文件
    ├── src-tauri/            # Rust 后端源码
    │   ├── src/             # Rust 源码
    │   └── Cargo.toml       # Rust 依赖配置
    └── package.json          # 前端依赖配置
```

## 功能特性

### 浏览器插件
- 实时嗅探网页中的 M3U8 流媒体链接
- 自动过滤广告和无效链接
- 一键复制链接
- 一键唤醒本地客户端下载
- 支持 Chrome/Edge 浏览器

### Tauri 客户端
- **插件联动下载**：接收浏览器插件传递的 M3U8 链接
- **手动链接解析**：输入网页 URL，自动解析隐藏的 M3U8 资源
- 内置 FFmpeg，无需额外安装
- 支持批量下载
- 下载进度实时显示
- 自动转码为 MP4 格式

## 安装使用

### 浏览器插件安装

1. 打开 Chrome/Edge 浏览器，进入扩展管理页面
2. 开启"开发者模式"
3. 点击"加载已解压的扩展程序"
4. 选择 `chrome-extension` 目录

### Tauri 客户端运行

```bash
# 进入客户端目录
cd tauri-client

# 安装依赖
npm install

# 开发模式运行
npm run tauri dev

# 打包构建
npm run tauri build
```

## 使用流程

### 模式一：浏览器插件联动下载

1. 在浏览器中访问包含视频的网页
2. 插件自动嗅探 M3U8 链接
3. 点击插件图标，查看嗅探结果
4. 点击"下载"按钮，唤醒本地客户端
5. 客户端自动开始下载并转码

### 模式二：手动链接解析

1. 打开 Tauri 客户端
2. 进入"手动解析"页面
3. 输入视频网页 URL
4. 点击"解析"按钮
5. 选择要下载的资源
6. 点击"下载"按钮

## 技术栈

- **浏览器插件**：Manifest V3, Chrome Extension API
- **桌面客户端**：Tauri 2.0, Vue 3, Element Plus, Rust
- **编解码**：FFmpeg (内置)

## 注意事项

1. 请确保已安装 FFmpeg 并配置到系统 PATH
2. 部分网站可能有反爬机制，解析可能失败
3. 下载的视频仅供个人学习使用，请勿用于商业用途

## 开发说明

### 修改唤醒协议

编辑 `chrome-extension/popup.js` 中的 `buildSchemeUrl` 函数。

### 调整解析规则

编辑 `tauri-client/src-tauri/src/parser.rs` 中的过滤规则。

### 升级 FFmpeg

替换 `tauri-client/src-tauri/bin/` 目录下的 FFmpeg 可执行文件。