Fluent-M3U8 是一款基于PySide6和QFluentWidgets构建的跨平台M3U8/MPD视频下载器

核心依赖:
- Python: 版本 3.11 (推荐，项目在Python 3.11下开发测试)。
- 包管理器: 推荐使用 conda 管理环境，当然 venv 或 virtualenv 也可以。
必要工具 (需手动下载):
- FFmpeg: 用于视频处理和合并。
- N_m3u8DL-RE: 一个功能强大的流媒体下载器，是项目的核心下载引擎。
- 重要: 你需要将这两个工具的可执行文件放置到项目特定的目录中。

🚀 第一步：获取代码与环境

克隆仓库

1 2	git clone https://github.com/zhiyiYo/Fluent-M3U8.git cd Fluent-M3U8

创建并激活虚拟环境
项目推荐使用 conda，但你也可以使用 python -m venv。

# 使用 conda (推荐)
conda create -n fluent-m3u8 python=3.11
conda activate fluent-m3u8

# 或使用 venv
python -m venv .venv
source .venv/bin/activate  # Linux/macOS
# .\.venv\Scripts\activate  # Windows

安装Python依赖
1
pip install -r requirements.txt

🛠️ 第二步：配置核心工具

这是关键一步，你需要手动下载FFmpeg和N_m3u8DL-RE，并将它们放入项目指定的 tools 文件夹中。

下载工具:
- 访问 FFmpeg官网下载适合你操作系统的静态编译版本。
- 访问 N_m3u8DL-RE的GitHub发布页下载适合你操作系统的可执行文件。
放置可执行文件:
- 在项目根目录下，找到或创建 tools 文件夹。
- 将下载的 ffmpeg (Linux/macOS) 或 ffmpeg.exe (Windows) 放入 tools 目录。
- 将下载的 N_m3u8DL-RE (Linux/macOS) 或 N_m3u8DL-RE.exe (Windows) 放入 tools 目录。
- 确保这些文件具有可执行权限 (Linux/macOS: chmod +x tools/*)。

🖥️ 第三步：运行与使用

完成上述配置后，即可启动应用。

1 2	conda activate fluent-m3u8 # 激活环境 python Fluent-M3U8.py

应用启动后，你可以通过其图形界面添加M3U8或MPD链接，并进行下载管理。

📦 第四步：打包与分发 (可选)

如果你想将应用打包成独立的可执行文件，可以运行项目提供的部署脚本。

执行打包脚本

1 2	conda activate fluent-m3u8 python deploy.py

复制工具文件
打包完成后，你需要将 tools 文件夹手动复制到打包输出目录中：
- Windows/Linux: dist/Fluent-M3U8.dist/tools
- macOS: dist/Fluent-M3U8.app/Contents/MacOS/tools

❗ 注意事项

Python版本: 请严格遵守 Python 3.11。使用其他版本可能会导致依赖安装失败或运行时错误。
工具依赖: 应用的核心下载功能完全依赖 N_m3u8DL-RE 和 FFmpeg。如果 tools 目录下缺少这两个可执行文件，应用将无法正常工作。
网络环境: 下载视频时，请确保网络连接稳定，并遵守相关网站的版权规定和服务条款。
系统要求: 这是一个跨平台应用，支持Windows、Linux和macOS，但具体功能表现可能因操作系统而异。