一款专为 Emby 媒体服务器设计的插件,用于优化 strm 文件的媒体信息管理和播放体验。
当前版本:v2.6.0
如果你想用在Jellyfin上,请移步Jellyfin分支:https://github.com/jinlin-teck/StrmTool/tree/jellyfin
推荐搭配:如果你还需要从 OpenList/Alist 网盘批量生成 strm 文件,可参考本人另外一个项目:openlist-strm——从 OpenList/Alist 目录生成 .strm 文件的轻量服务,带 WebUI,配合本插件可在 Emby/Jellyfin 上完美播放 strm 媒体文件。
- 自动提取:当新的 strm 文件入库时,自动解析音视频编码、章节、字幕、图片等媒体信息
- 智能处理:仅处理缺少完整媒体信息的 strm 文件,避免重复操作
- 播放加速:通过预提取媒体信息,显著提升 strm 文件的起播速度
- 兜底扫描:内置计划任务(默认凌晨3点,可自定义)确保无遗漏
- 自动备份:提取媒体信息后自动导出为 JSON 备份文件(自动跳过已有的同名json文件,自动提取和手动任务提取均生效)
- 文件位置:备份文件保存在 strm 文件同目录下,格式为
{filename}-mediainfo.json - 一键恢复:支持从 JSON 备份文件快速恢复媒体信息
- 智能检测:恢复时自动识别需要处理的文件(缺少音视频信息的文件)
- 将
StrmTool.dll文件放入 Emby 插件目录 - 重启 Emby 服务器
- 插件将自动启用并开始工作
在 Emby 管理后台的「计划任务」中可找到以下功能:
| 任务名称 | 功能说明 | 默认执行时间 |
|---|---|---|
| 提取 Strm 媒体信息 | 兜底扫描,确保所有 strm 文件信息完整 | 每天凌晨3点 |
| 导出 STRM 媒体信息 | 手动导出所有 strm 文件的媒体信息 | 手动执行 |
| 恢复 STRM 媒体信息 | 从 JSON 备份文件恢复媒体信息 | 手动执行 |
v2.5.1开始提供配置页面,在emby设置面板插件栏找到本插件,点击插件名称即可打开。提供的设置项如下:
| 配置项 | 说明 | 默认值 |
|---|---|---|
| 启用自动提取 | 检测到新 STRM 文件时是否自动提取媒体信息 | true |
| 处理延迟(毫秒) | 探测远程媒体信息前的延迟时间(毫秒),从 JSON 恢复不延迟 | 2000 |
| 最大并发数 | 同时处理的最大文件数量 | 3 |
其他说明:
- 计划任务:可根据需求调整执行时间
- 备份策略:自动备份,无需手动干预
- Emby 版本:已在 4.8.11.0 和 4.9.1.80 版本测试通过,其他版本请自行测试
- 插件自动注册事件处理器,安装后立即生效
- 手动刷新媒体库可能导致已提取信息丢失,建议使用备份恢复功能
- 恢复功能仅在需要时手动执行,不会自动运行
使用提示:建议定期检查计划任务执行情况,确保媒体信息始终保持最新状态,另外下载dll文件注意版本,emby就下载emby版本的dll文件,jellyfin的下载jellyfin版本
A plugin designed specifically for Emby media server to optimize strm file media information management and playback experience.
Current version: v2.6.0
If you want to use it with Jellyfin, please go to the Jellyfin branch: https://github.com/jinlin-teck/StrmTool/tree/jellyfin
Recommended companion: If you also need to batch-generate strm files from OpenList/Alist, check out my other project: openlist-strm — a lightweight service with WebUI that generates .strm files from OpenList/Alist directories. Combined with this plugin, you can play strm media files perfectly on Emby/Jellyfin.
- Auto-extraction: When new strm files are added to the library, automatically parse audio/video codecs, chapters, subtitles, images and other media information
- Smart processing: Only process strm files that lack complete media information, avoiding redundant operations
- Playback acceleration: Pre-extracting media information significantly improves the startup speed of strm files
- Scheduled scan: Built-in scheduled task (default 3 AM, customizable) ensures no files are missed
- Auto backup: Automatically export to JSON backup file after extracting media info (auto-skip existing same-name json files, works for both auto-extraction and manual task extraction)
- File location: Backup files are saved in the same directory as strm files, format is
{filename}-mediainfo.json - One-click restore: Quickly restore media information from JSON backup files
- Smart detection: Automatically identify files that need processing during restore (files lacking audio/video info)
- Place
StrmTool.dllinto the Emby plugins directory - Restart Emby server
- The plugin will automatically enable and start working
Find the following features in "Scheduled Tasks" in Emby admin dashboard:
| Task Name | Description | Default Execution Time |
|---|---|---|
| Extract Strm Media Info | Scheduled scan to ensure all strm files have complete info | Daily at 3 AM |
| Export STRM Media Info | Manually export media info for all strm files | Manual execution |
| Restore STRM Media Info | Restore media info from JSON backup files | Manual execution |
Starting from v2.5.1, a configuration page is available. Locate this plugin in the Plugins section of the Emby admin dashboard and click on the plugin name to open it. The following settings are provided:
| Configuration Option | Description | Default Value |
|---|---|---|
| Enable Auto Extract | Whether to auto-extract media info when new strm files are detected | true |
| Processing Delay (ms) | Delay before probing remote media info (ms); restoring from JSON is not delayed | 2000 |
| Max Concurrency | Maximum number of files to process simultaneously | 3 |
Additional notes:
- Scheduled tasks: Execution time can be adjusted as needed
- Backup strategy: Auto backup, no manual intervention needed
- Emby version: Tested on 4.8.11.0 and 4.9.1.80, please test other versions yourself
- The plugin automatically registers event handlers and takes effect immediately after installation
- Manually refreshing the media library may cause extracted info to be lost, recommend using backup/restore feature
- Restore function only runs manually when needed, it won't run automatically
Usage tips: It is recommended to regularly check the scheduled task execution to ensure media information is always up to date. Also pay attention to the DLL version when downloading - use the emby version for emby and jellyfin version for jellyfin.