An open API service indexing awesome lists of open source software.

https://github.com/cp0204/smartstrm

一个媒体库 STRM 文件生成工具。和 Emby 优雅配合,媒体资源丝滑入库,支持 302 直链播放,支持同步删除。 配合 Quark-Auto-Save, CloudSaver, Emby 力求即存即看。🥳
https://github.com/cp0204/smartstrm

115 alist cloud189 clouddrive2 emby jellyfin openlist strm

Last synced: about 1 month ago
JSON representation

一个媒体库 STRM 文件生成工具。和 Emby 优雅配合,媒体资源丝滑入库,支持 302 直链播放,支持同步删除。 配合 Quark-Auto-Save, CloudSaver, Emby 力求即存即看。🥳

Awesome Lists containing this project

README

          

# SmartStrm

一个媒体库 STRM 文件生成工具。

和 Emby 优雅配合,媒体资源丝滑入库,支持 302 直链播放,支持同步删除远端文件。

配合 Quark-Auto-Save/CloudSaver, OpenList, Emby 力求即存即看。🥳

[![releases][releases-image]][docker-url] [![docker pulls][docker-pulls-image]][docker-url] [![docker image size][docker-image-size-image]][docker-url] [![telegram][telegram-image]][telegram-url]

[telegram-image]: https://img.shields.io/badge/Telegram-2CA5E0?logo=telegram&logoColor=white
[releases-image]: https://img.shields.io/docker/v/cp0204/smartstrm
[docker-pulls-image]: https://img.shields.io/docker/pulls/cp0204/smartstrm?logo=docker&&logoColor=white
[docker-image-size-image]: https://img.shields.io/docker/image-size/cp0204/smartstrm?logo=docker&&logoColor=white
[github-url]: https://github.com/Cp0204/smartstrm
[docker-url]: https://hub.docker.com/r/cp0204/smartstrm
[telegram-url]: https://t.me/smartstrm

![run_log](https://github.com/Cp0204/SmartStrm/raw/refs/heads/main/img/main.png)

> [!TIP]
>
> 有不少新手提到希望有较详细的视频或图文教程,因为~~作者很懒~~ ~~想把有限的时间花在代码上~~ 写教程宁愿写代码。**即日起,各位大佬在公众号、B站、知乎、值得买等平台发布 SmartStrm 教程,图文视频均可,对其他用户有帮助的,根据内容质量可兑换1~2年Pro,已购可续**,内容可以但不限于在各NAS系统的部署方法、和 OpenList、QAS、CS 联动配置、Emby、Jellyfin 入库配置、302代理等。**注意,教程演示请勿使用国内版权资源。**
>
> **兑换方式:** 将内容链接、平台登录截图(证明账号所有权)邮件到 Cp0204#qq.com (#替换@),这则公告还挂着就长期有效。参加并兑换成功默认视为授权 SmartStrm 对内容公开引用、保留原作者信息前提下的[整理和转载](#第三方教程)。
>
> *如果教程涉及 Pro 功能,但你还没有,可以先邮件发内容规划(什么平台发什么内容),领取 5 天体验*

## 特性

- 支持 OpenList、WebDAV、Quark、115、天翼云盘 等网络驱动
- 任务管理
- 基于 Crontab 的定时任务
- 单个任务独立日志
- 任务工具箱:内容替换、一键清理
- STRM 生成
- 目录时间检查
- 增量/同步生成:可清理远端已删文件
- 指定生成的媒体后缀、文件大小阈值
- 指定复制的文件后缀
- Webhook
- 联动 QAS、CloudSaver 转存即触发任务
- Emby 中删除媒体,同步删除远端文件
- CloudDrive2 文件变更通知实时触发任务 (Pro)
- 粗糙但极其友好的管理页面
- 存储浏览、批量重命名
- 任务日志查看
- 一站式 Emby Jellyfin 302 直链播放 (Pro)

## 部署

部署命令

```bash
docker run -d \
--name smartstrm \
--restart unless-stopped \
--network host \
-v /yourpath/smartstrm/config:/app/config \ # 挂载配置目录
-v /yourpath/smartstrm/logs:/app/logs \ # 挂载日志目录,可选
-v /yourpath/smartstrm/strm:/strm \ # 挂载 STRM 生成目录
# 以上 /yourpath 改为你实际存放配置的路径
-e PORT=8024 \ # 管理端口,可选
-e ADMIN_USERNAME=admin \ # 管理用户名
-e ADMIN_PASSWORD=admin123 \ # 管理用户密码
-e LICENSE= \ # 许可证字符串(如有)
cp0204/smartstrm:latest
```

docker-compose.yml

```yaml
name: smartstrm
services:
smartstrm:
image: cp0204/smartstrm:latest
container_name: smartstrm
restart: unless-stopped
network_mode: host
volumes:
- /yourpath/smartstrm/config:/app/config # 挂载配置目录
- /yourpath/smartstrm/logs:/app/logs # 挂载日志目录,可选
- /yourpath/smartstrm/strm:/strm # 挂载 STRM 生成目录
# 以上 /yourpath 改为你实际存放配置的路径
environment:
- PORT=8024 # 管理端口,可选
- ADMIN_USERNAME=admin # 管理用户名
- ADMIN_PASSWORD=admin123 # 管理用户密码
- LICENSE= # 许可证字符串(如有)
```

一键更新

```bash
docker run --rm -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower -cR smartstrm
```

## 使用

**原理:** [STRM 文件](https://emby.media/support/articles/Strm-Files.html) 是一个网络资源的快捷方式,它使得无须在本地存储媒体文件,让 Emby 播放时再直接从网络上请求媒体资源,因扫描媒体库只识别文件名,而不用读取媒体文件内容,所以入库极快。支持 STRM 文件的有 Emby, Jellyfin, Kodi 等。

### SmartStrm 的使用步骤

1. 添加存储
2. 添加任务,生成 STRM 文件
3. 挂载 STRM 目录给媒体库容器的 /strm 路径
4. 扫描媒体库,识别 STRM 文件

完成以上步骤,Emby 已经能够直接从网盘直接提供播放,此时所有视频流量经过 Emby ,如果你在局域网外访问,可能受限于家中网络的上传带宽(特别是多人同时播放时)。你可能还需要:

5. 设置302代理服务器(Pro),改从 SmartStrm 提供的端口访问 Emby ,将直接从网盘获取视频流(需网盘支持),享受最顺畅的播放。

### 第三方教程

- [视频教程:10分钟搞定!飞牛OS部署 SmartStrm+Emby 最强联动](https://www.bilibili.com/video/BV14shdzaEY7/)
- [视频教程:SmartStrm 302 原理,使用演示,在外秒播云盘资源](https://www.bilibili.com/video/BV1DKaGzUEP7/)
- [保姆级图文:SmartStrm + Emby:夸克网盘 302 直链播放完全指南](https://club.fnnas.com/forum.php?mod=viewthread&tid=36387)
- [保姆级图文:SmartStrm 部署,配置 Emby 媒体库,CloudSaver+QAS 联动,一站式302](https://linux.do/t/topic/924963)
- [保姆级图文:QAS+SmartStrm 部署、追更秒入库丝滑体验](https://zhuanlan.zhihu.com/p/1943376528730756600)

> [!TIP]
>
> 🥰 **感谢:** 噜啦噜啦萝卜、Jochen、SunnyD、太阳营业了 为新手用户做出的贡献!🥰
> *(排名不分先后)*

## 进阶使用

### 转存自动生成STRM

支持和 `quark-auto-save` `CloudSaver` 联动,在转存后触发任务。支持**仅触发转存的那一个文件夹,秒级生成**。

#### quark-auto-save 插件

- **webhook**: SmartStrm Webhook 地址,从 `系统设置 - Webhook` 中获取
- **strmtask**: 相关的 SmartStrm 任务名,支持多个如 `tv,movie`
- **xlist_path_fix**: 路径映射, SmartStrm 任务使用 夸克网盘 驱动时无须填写;使用 OpenList 驱动时需填写如 `/storage_mount_path:/quark_root_dir` 的格式 ,例如把夸克根目录(/)挂载在 OpenList 的 /quark 下,则填写 `/quark:/`。**SmartStrm 会使 OpenList 强制刷新目录,无需再用 alist 插件刷新。**

#### CloudSaver 扩展

基本和 QAS 参数的逻辑相同,但需增加 `event` `savepath` 和调整 `xlist_path_fix` 参数。

- **webhook**: 同QAS
- **strmtask**: 同QAS
- **event**: `cs_strm`
- **savepath**: `/{savePath}`
- **xlist_path_fix**: 任务使用夸克网盘、天翼云盘驱动时无须填写;使用 OpenList 驱动时需填写,夸克网盘同QAS,天翼云盘 `/你挂载在oplist的路径:/全部文件` ,只改动 : 前面部分,后面 /全部文件 保持不变。

天翼网盘配置示例图

![cs_189_set](https://github.com/Cp0204/SmartStrm/raw/refs/heads/main/img/cs_189_set.png)

夸克网盘配置示例图

![cs_quark_set](https://github.com/Cp0204/SmartStrm/raw/refs/heads/main/img/cs_quark_set.png)

### Emby 删除同步

> **前提: SmartStrm 的 STRM 目录需挂载到 Emby 容器的 `/strm` 路径**
>
> 例如 SmartStrm 容器目录映射为 `/yourpath/strm:/strm` ,Emby 容器同样映射为 `/yourpath/strm:/strm`
>
> 如果你无法改变 Emby 的 STRM 目录(例如群晖套件版)的解决办法:
>
> 手动修改 SmartStrm 的配置文件 config.yaml ,找到 `strm_in_emby:` ,修改为 SmartStrm 的 STRM 目录在 Emby 中录路径,重启 SS 就能按新的识别。

在 `SmartStrm - Webhook - Emby 删除同步设置` 中启用功能,默认关闭。

在 `Emby - 后台管理 - 通知` 中设置:

- **网址**: SmartStrm Webhook 地址
- **请求内容类型**: application/json
- **Events**: 勾选 `媒体库-媒体删除`

### Webhook 运行任务

除了常用的 QAS、CloudSaver 触发外,SmartStrm 还支持通过自定义 Webhook 运行任务,供开发者调用。

```bash
curl --request POST \
--url http://127.0.0.1:8024/webhook/9dfb51234d483e83 \
--header 'Content-Type: application/json' \
--data '{
"event": "a_task",
"task": {
"name": "test",
"storage_path": "/drive/quark/test"
},
"strm": {
"media_ext": [
"mp4",
"mkv"
],
"url_encode": true,
"media_size": 100,
"copy_ext": [
"srt",
"ass"
]
}
}'
```

其中:

- `event` 是事件名,固定不变
- `task.name` 必须为已存在的任务名,仅支持单个
- `task.storage_path` 可选,填写时必须为任务的路径或子路径
- `strm` 字典可选,如缺省则使用系统设置

### CloudDrive2 文件变更通知触发任务

在 `SmartStrm - Webhook - CloudDrive2 文件变更触发设置` 中启用功能,默认关闭。

并设置 **存储映射** ,有两种联动方式:

1. 两边各添加同一网盘的同一账号(推荐):目前支持 115、天翼云盘,填写格式为 `A=A1,B=B1,C=C1,CD2_NAME=SS_NAME` 表示把 CD2 的 A 存储映射到 SS 的 A1 存储。

2. 利用 CD2 的 WebDAV 功能,把 CD2 添加为 WebDAV 存储,该方式所有文件请求流量经过CD2。
1. 如添加 CD2 名为 `115open` 的存储到 SS 的 `115openA` ,WebDAV 地址 `http://yoururl:19798/dav/115open` ,映射填写格式同上如 `115open=115openA`。
2. 也可以加整个 CD2 根目录,假如在 SS 名为 `CD2_DAV` 存储,填写格式为 `/=CD2_DAV`;但有以上指定存储映射时优先用指定的映射。

CloudDrive2 Webhook 配置

```ini
[global_params]
# 此处 base_url修改为你的 SmartStrm Webhook 地址,其他保持不变
base_url = "http://192.168.8.8:8024/webhook/9df1236ad884a83"
enabled = true

[global_params.default_headers]
content-type = "application/json"
user-agent = "clouddrive2/{version}"

[file_system_watcher]
url = "{base_url}/file_notify?device_name={device_name}&user_name={user_name}"
method = "POST"
enabled = true
body = '''
{
"device_name": "{device_name}",
"user_name": "{user_name}",
"version": "{version}",
"event_category": "{event_category}",
"event_name": "{event_name}",
"event_time": "{event_time}",
"send_time": "{send_time}",
"data": [
{
"action": "{action}",
"is_dir": "{is_dir}",
"source_file": "{source_file}",
"destination_file": "{destination_file}"
}
]
}
'''
```

## 302 代理

> 使用 SmartStrm 提供的 302 代理,将 Emby 客户端播放请求重定向,直接从直链获取视频流,不受 Emby 服务器的带宽限制。
>
> 测试支持绝大多数提供 http 直链的网盘,如使用 115VIP、天翼云盘、OpenList-支持302的盘 等方案较为完美。
>
> 图标示意: ✅兼容 ❌不兼容 🟡部分兼容 ⚫未测试

### 按驱动分

| 驱动 | Emby 302 | Jellyfin 302 | 备注 |
| ----------- | -------- | ------------ | ----------------------------------------------------- |
| OpenList | ✅ | ✅ | 如果 oplist 开启302,直链兼容性依赖于网盘能否提供直链 |
| 夸克网盘 | 🟡 | 🟡 | 默认使用转码直链,部分视频不兼容,可用智能回落到代理 |
| 115开放平台 | ✅ | ✅ | 直链完美兼容;但普通用户API限速,频繁报错 |
| 天翼云盘 | ✅ | ✅ | 直链完美兼容,速度完美 |

### 按客户端分

| 客户端 | Emby | Jellyfin | 备注 |
| ---------- | ---- | -------- | -------------------------------- |
| Web | 🟡 | 🟡 | 不兼容夸克部分转码资源,其他正常 |
| Android | ✅ | ⚫ | |
| Android TV | 🟡 | - | 不兼容夸克部分转码资源,其他正常 |
| VidHub | ✅ | ✅ | |
| Yamby | 🟡 | - | 不兼容夸克部分转码资源,其他正常 |
| AfuseKt | ✅ | ✅ | |

## Q&A

#### Q: 是否支持网盘转存、自动转存?
> A: 暂无计划,做好一件事,少即是多。市面上已经有不少转存工具,不重复造轮子,除非我有信心做成最好用的轮子。

#### Q: 免费和收费?
> A: 基础功能免费(STRM生成,Webhook等),已经能够满足绝大多数人需求,高级功能付费(302代理),定价极其合理。作者的免费开源项目 QAS 至今已迭代多个版本, SmartStrm 是打通网络存储和私有媒体库的最后一块拼图,从高级功能中获取一定的回报,更有利于项目的长远发展。
>
> 功能定位:
> - 免费功能:基础的功能、细节优化、大众的需求。
> - 高级功能:进阶的功能、小众的需求,尤其是一个功能我自己用不上,是为了满足用户们需求而开发,那将会是Pro功能。

#### Q: 302代理之后可以分享给家人和朋友用吗 这样会风控吗?
> A: 302代理后直接由客户端直接向网盘请求资源,理论上能识别到你的账号在异地下载。假设你家里登录了、公司在异地也登录了,少量属于正常的使用需求。但如果公开出去同时十几、几十处异地下载,只能说有风险,风险自担。

#### Q: 关于目录时间检查选项的工作机制?
> A: 这个选项是为了最小化地请求接口,和最快的速度执行任务。远端目录的修改时间更新了、比本地新,就会往下检查。已知115新增/删除文件都会更新父目录的修改时间;夸克网盘新增会更新但删除不会;各个盘可能机制不一,建议自行验证。

#### Q: 映射了 302 代理端口访问 Emby ,还要不要映射 SmartStrm 端口?
> A: 不需要,如果用 SS 的 302 代理功能,分享代理后的 Emby 端口出去,STRM 地址可以直接用内网,代理会自行处理。别人访问不到 SmsrtStrm 或 STRM 的地址,能访问的只有代理后的 Emby 服务,所以我称之为 “一站式 Emby Jellyfin 302 直链播放” 。

#### Q: 能否支持 Jellyfin 的删除 Webhook 通知?
> A: Jellyfin 的通知中缺少一些关键信息,导致 SS 无法得知要删除的路径,所以没办法支持。

#### Q: 夸克播放部分视频偏色?
> A: 这是个已知问题。目前的结论是偏色不是夸克转码的问题,是把杜比视界视频当流媒体处理时,播放器不支持杜比视界造成的。(当302时,直接由客户端解码杜比视界原文件,理论上只要是302和客户播放器不支持杜比视界都会偏色,和用哪个网盘无关)如果到夸克客户端、夸克TV播这个资源验证一下,也会是一样的偏色。目前已知同一个资源,调用 PotPlayer 播放不会偏色,如果客户端不支持只能换资源。

#### Q: Emby 提示没有兼容的流如何排查?
> 1. 找到对应的 .strm 文件,用文本编辑器打开,里面有个 URL ,复制到浏览器看能否访问。
> 2. 检查 Emby 容器和以上 URL 的连接,如果是局域网,是否在同一个网段。
> 3. 检查 URL 中的媒体格式,部分媒体格式可能无法被网页端解码,尝试用客户端播放。

## 第三方许可证信息

SmartStrm 是一个闭源项目,但站在巨人的肩膀上使用了多个开源库。我们尊重并遵守所有第三方库的许可证要求。

本项目使用的第三方开源库及其许可证信息:[《第三方开源项目许可》](https://github.com/Cp0204/SmartStrm/raw/refs/heads/main/THIRD-PARTY-LICENSES.md)

## 最后

感谢你看到这里,感谢你了解这个项目。这个项目起源于我在用过同类 STRM 工具后,始终找不到一款符合完美期望的,于是尝试自己写一个。

SmartStrm 的定位是媒体库 STRM 生成工具,是打通网络存储和私有媒体库的最后一块拼图。

如果说 QAS 是练手项目,那么 SmartStrm 就是用心之作,其中包含了大量相互联动的巧思、对新手友好的设计。

正如其名,它希望尽可能地为你减少繁杂的操作和配置,让你感觉就是“好用”!

希望你能喜欢。