# drip-player

**Repository Path**: ggtool/drip-player

## Basic Information

- **Project Name**: drip-player
- **Description**: 媒体播放器，可以在线下载油管等视频。
- **Primary Language**: Rust
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-01
- **Last Updated**: 2026-06-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Drip Player

Drip Player 是一个基于 Tauri 2、Vue 3 和 Rust 的桌面媒体播放器，面向本地课程视频、音频资料和在线视频链接管理。它支持添加本地文件或文件夹，解析 YouTube、Bilibili 等在线媒体，并通过媒体探测自动选择合适的播放方式。

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![Tauri](https://img.shields.io/badge/Tauri-2.x-orange.svg)](https://tauri.app/)
[![Vue](https://img.shields.io/badge/Vue-3.x-42b883.svg)](https://vuejs.org/)
[![Rust](https://img.shields.io/badge/Rust-2021-b7410e.svg)](https://www.rust-lang.org/)

![Drip Player 截图](drip-player.png)

## 功能特性

- 本地媒体库：支持添加单个文件，也支持递归导入整个文件夹。
- 播放列表和文件夹树：按文件夹浏览导入的媒体，双击即可播放。
- 探测优先播放：使用 `ffprobe` 读取真实容器和音视频编码，再选择播放引擎。
- 浏览器视频播放：浏览器原生支持的格式通过 `video.js` 播放。
- 自动转封装缓存：对 H.264/AAC 等可兼容浏览器播放的文件执行无损转封装，例如 FLV 容器转 MP4。
- 音频后端兜底：音频通过 Rust 后端和 `rodio` 播放，必要时使用 FFmpeg 兜底。
- 外部播放器兜底：浏览器无法播放、也无法转封装的视频，可使用 MPV 播放。
- 在线媒体：通过 `yt-dlp` 解析和下载在线视频。
- 字幕发现：自动扫描同目录下的 `.srt`、`.vtt`、`.ass`、`.ssa` 字幕。
- 桌面体验：深色模式、自定义标题栏、播放控制、音量、倍速、字幕和侧边栏。

## 媒体格式策略

Drip Player 不再只根据文件后缀决定播放方式。本地文件和缓存文件会先探测：

1. 如果容器和编码属于浏览器原生支持范围，直接用内置视频播放器播放。
2. 如果可以无损转封装成浏览器兼容 MP4，则写入本地 remux 缓存后播放。
3. 如果是纯音频，交给 Rust 音频后端播放。
4. 如果是视频但浏览器链路无法处理，则在安装 MPV 时使用 MPV 播放。
5. 只有探测失败时，才根据文件后缀做最后兜底。

常见输入格式：

- 音频：`mp3`、`wav`、`ogg`、`flac`、`m4a`、`aac`、`opus`
- 浏览器常见视频：`mp4`、`m4v`、`webm`
- 探测或外部播放器视频：`mkv`、`avi`、`mov`、`flv`、`wmv`、`ts`、`m2ts`、`mpg`、`mpeg`、`3gp`

为了获得更稳定的格式支持，建议安装 FFmpeg 工具集，让应用可以调用 `ffprobe` 和 `ffmpeg`。

## 环境要求

- Node.js 18+
- pnpm
- Rust stable toolchain
- 当前系统对应的 Tauri 2 构建环境
- Windows 用户需要 Microsoft Visual Studio C++ Build Tools

安装 pnpm：

```bash
npm install -g pnpm
```

## 可选外部工具

应用会优先查找项目根目录下的 `lib/`，如果没有找到，再尝试使用系统 `PATH` 中的工具。`lib/` 已被 Git 忽略，不会提交到仓库。

Windows 示例：

```text
drip-player/
├── lib/
│   ├── ffmpeg.exe
│   ├── ffprobe.exe
│   ├── yt-dlp.exe
│   └── mpv.exe
```

推荐工具：

- `ffmpeg` 和 `ffprobe`：媒体探测、时长识别、音频兜底、转封装缓存。
- `yt-dlp`：在线视频解析和下载。
- `mpv`：浏览器无法处理的视频格式兜底播放。

非 Windows 系统使用不带 `.exe` 的对应可执行文件名。

## 快速开始

克隆项目：

```bash
git clone git@gitee.com:ggtool/drip-player.git
cd drip-player
```

安装依赖：

```bash
pnpm install
```

开发模式启动桌面应用：

```bash
pnpm tauri dev
```

构建发布包：

```bash
pnpm tauri build
```

前端检查：

```bash
pnpm build
```

Rust 后端检查：

```bash
cd src-tauri
cargo check
```

## 项目结构

```text
drip-player/
├── public/                 # 前端静态资源
├── src/                    # Vue 前端
│   ├── components/          # 播放器、侧边栏、文件树、弹窗等组件
│   ├── store/               # Pinia 播放器状态
│   ├── utils/               # 前端媒体辅助函数
│   ├── App.vue
│   └── main.ts
├── src-tauri/               # Rust/Tauri 后端
│   ├── capabilities/         # Tauri 权限配置
│   ├── icons/                # 应用图标
│   ├── src/
│   │   ├── handlers/         # Tauri 命令处理
│   │   ├── models/           # 播放列表和播放器模型
│   │   ├── services/         # 播放、探测、转封装、持久化、在线解析
│   │   └── main.rs
│   └── tauri.conf.json
├── package.json
├── pnpm-lock.yaml
└── README.md
```

## 运行时数据

以下目录被 Git 忽略：

- `lib/`：本地外部工具。
- `cache/`：运行时缓存。
- `downloads/`：下载的媒体文件。
- `doc/`：本地设计文档或私有说明。

转封装缓存会自动清理。应用会按文件年龄和缓存总大小删除旧的 remux 文件。

## 在线媒体说明

在线媒体功能依赖 `yt-dlp`。部分平台或内容可能需要浏览器 Cookie 或登录状态。Drip Player 不绕过平台限制，只调用用户本地配置的工具完成解析和下载。

## 贡献

欢迎提交 Issue 和 Pull Request。

提交改动前建议运行：

```bash
pnpm build
cd src-tauri
cargo check
```

播放方式的选择应集中在后端 playback plan 中。前端 UI 不应自行根据文件后缀决定播放引擎。

## 许可证

本项目基于 [MIT License](LICENSE) 开源。

## 免责声明

Drip Player 不提供、托管或分发任何媒体内容。用户需要自行确保本地文件、在线播放和下载行为符合相关法律法规、版权规则以及目标平台的服务条款。

FFmpeg、yt-dlp、MPV 等第三方工具不随本仓库分发。请根据这些工具各自的许可证和使用条款安装、配置和使用。