Metadata-Version: 2.4
Name: hs-m3u8
Version: 0.1.5
Summary: m3u8 下载器
Project-URL: homepage, https://github.com/x-haose/hs-m3u8
Project-URL: repository, https://github.com/x-haose/hs-m3u8
Project-URL: documentation, https://github.com/x-haose/hs-m3u8
Author-email: 昊色居士 <xhrtxh@gmail.com>
License-Expression: MIT
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: BSD
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: hssp>=0.4.4
Requires-Dist: m3u8>=6.0.0
Description-Content-Type: text/markdown

# hs-m3u8

m3u8 视频下载工具。支持大部分的m3u8视频下载。后续增加UI界面。

## 功能

- aes解密
- 自动选择高分辨m3u8
- 合并MP4
- 可选择保留ts文件
- 内置Windows平台ffmpeg可执行文件（由于Linux及Mac下权限问题，需自行安装ffmpeg文件）

## 计划

- 增加cli功能，通过终端执行命令去下载
- 增加支持curl参数功能。直接在curl里面读取请求头及cookie
- 编写详细文档
- 选择一个合适的技术栈，增加UI界面

## 安装

### pip包安装

```shell
pip install hs-m3u8
```

### 克隆代码安装

见下面开发文档

## 使用

```python
url = "https://surrit.com/6d3bb2b2-d707-4b79-adf0-89542cb1383c/playlist.m3u8"
name = "SDAB-129"
dl = M3u8Downloader(
    url=url,
    save_path=f"downloads/{name}",
    max_workers=64
)
await dl.run(del_hls=False, merge=True)
```

- del_hls 为True时会删除ts、m3u8、key等文件，否则会经过处理后保留，以便直接使用
- merge 为True时会自动合并为mp4

## 开发

### 先安装rye

rye网站：https://rye.astral.sh/

### 使用rye 安装包及虚拟环境

```bash
rye sync
```