Jellyscrub跨平台使用指南：Web、桌面、iOS全客户端适配技巧
项目地址: https://gitcode.com/gh_mirrors/je/jellyscrub Jellyscrub是一款专为Jellyfin媒体服务器设计的强大插件，它能够为视频文件生成平滑的鼠标悬停预览功能，让用户在浏览视频时间轴时获得无缓冲的快速预览体验。这个跨平台工具支持Web浏览器、桌面客户端和移动设备，为用户提供一致的高质量视频浏览体验。无论您是在Windows、macOS、Linux还是iOS设备上使用Jellyfin，Jellyscrub都能为您带来流畅的视频预览功能。
📱 Jellyscrub跨平台功能概览
Jellyscrub的核心功能是通过生成Roku .bif格式的预览文件，实现无缓冲的视频时间轴预览。与Jellyfin原生的预览功能相比，Jellyscrub提供了更快速、更流畅的预览体验，即使在通过Cloudflare等代理服务访问时也能保持出色性能。
主要优势：
- 零缓冲预览：即使在代理环境下也能实现即时预览
- 全平台支持：兼容Web、桌面、Android和iOS客户端
- 高效存储：90分钟电影仅需约6MB存储空间
- 自定义配置：可调整预览间隔时间和分辨率
- 多种生成模式：支持库扫描时生成、计划任务生成或按需生成
🔧 快速安装配置步骤
基础安装方法
- 添加插件仓库：在Jellyfin插件管理中添加
https://raw.githubusercontent.com/nicknsy/jellyscrub/main/manifest.json作为插件源 - 安装Jellyscrub插件：从仓库中找到并安装Jellyscrub插件
- 重启Jellyfin服务器：安装完成后重启服务使插件生效
- 脚本注入：插件会自动向Jellyfin的
index.html文件注入客户端脚本 - 清除缓存：清除浏览器缓存和本地存储以获取更新后的页面
权限问题解决方案
如果遇到权限问题导致脚本无法自动注入，可以手动添加以下代码到 index.html 文件的body标签末尾：
<script plugin="Jellyscrub" version="1.0.0.0" src="/Trickplay/ClientScript"></script>
注意：如果设置了基础路径，需要相应调整src属性为 src="/YOUR_BASE_PATH/Trickplay/ClientScript"。
🖥️ Web客户端配置优化
配置页面设置
访问Jellyscrub的配置页面可以调整以下关键参数：
- 预览生成间隔：默认10秒，可根据需要调整
- 目标分辨率：支持多种分辨率设置（如320px宽度）
- 生成时机：可选择在库扫描时生成、作为计划任务生成或客户端请求时生成
- 存储位置：可选择保存到媒体文件夹或内部元数据文件夹
Jellyfin原生预览功能（最小5分钟间隔）
Jellyscrub预览功能（默认10秒间隔，320px宽度）
性能优化技巧
- 硬件加速配置：在支持硬件加速的系统上启用此功能可以显著提升预览生成速度
- 线程设置：根据服务器CPU核心数合理设置生成线程数
- 进程优先级：调整生成任务的进程优先级以避免影响主要服务
- HDR色调映射：为HDR内容启用正确的色调映射设置
💻 桌面客户端适配指南
Jellyfin Media Player配置
对于Jellyfin Media Player（JMP）桌面客户端（版本≥1.8.1）：
- 点击用户头像进入"客户端设置"
- 在插件支持部分勾选"Jellyscrub"选项
- 重启JMP客户端使设置生效
跨平台兼容性
Jellyscrub的桌面客户端支持基于以下技术实现：
- Windows：完全兼容所有现代版本
- macOS：支持macOS 10.15及以上版本
- Linux：兼容主流发行版（Ubuntu、Fedora、Arch等）
📱 iOS移动端配置
iOS客户端支持
Jellyscrub在iOS设备上提供与Web端相同的流畅预览体验。iOS客户端的集成通过相同的JavaScript脚本实现，确保跨平台功能一致性。
Jellyscrub在iOS设备上的预览效果
移动端优化建议
- 网络优化：Jellyscrub的无缓冲特性特别适合移动网络环境
- 分辨率适配：为移动设备选择合适的分辨率设置以平衡质量和性能
- 缓存策略：合理利用客户端缓存减少重复请求
🔄 文件转换与迁移
BIF文件转换
从Jellyscrub 2.0.0版本开始，插件主要功能已迁移至Jellyfin 10.9.0的原生trickplay功能。Jellyscrub现在专注于将现有的.bif文件转换为Jellyfin原生格式：
- 更新插件：通过Jellyfin插件管理更新到最新版本
- 重启服务器：应用更新后重启Jellyfin服务
- 访问配置页面：进入插件配置页面开始转换过程
- 自动转换：系统会自动检测并转换现有的.bif文件
文件结构说明
Jellyscrub生成的预览文件采用以下结构：
媒体文件夹/
├── video.mp4
└── video.bif (预览文件)
或
元数据文件夹/
└── jellyscrub/
└── video.bif (预览文件)
🛠️ 故障排除与维护
常见问题解决
问题1：预览功能不工作
- 检查插件是否成功安装并启用
- 确认脚本已正确注入到index.html
- 清除浏览器缓存和本地存储
问题2：预览生成失败
- 检查服务器是否有足够的磁盘空间
- 确认FFmpeg已正确安装和配置
- 查看服务器日志获取详细错误信息
问题3：权限问题
- 确保Jellyfin服务用户有适当的文件权限
- 对于Docker部署，检查用户和组权限设置
定期维护建议
- 监控存储使用：定期检查预览文件占用的磁盘空间
- 更新插件：保持Jellyscrub插件为最新版本
- 性能调优：根据服务器负载调整生成设置
- 备份配置：定期备份插件配置以防意外丢失
📊 性能对比与数据
存储效率分析
| 视频时长 | 预览间隔 | 分辨率 | 存储大小 |
|---|---|---|---|
| 90分钟 | 10秒 | 320×180 | 约6MB |
| 120分钟 | 10秒 | 320×180 | 约8MB |
| 90分钟 | 5秒 | 320×180 | 约12MB |
| 90分钟 | 10秒 | 640×360 | 约24MB |
生成时间参考
| 硬件配置 | 90分钟视频生成时间 |
|---|---|
| 低端CPU | 4-6分钟 |
| 中端CPU | 2-4分钟 |
| 高端CPU | 1-2分钟 |
| 硬件加速 | 1分钟以内 |
🎯 最佳实践总结
部署建议
- 生产环境：建议在库扫描时生成预览，避免影响实时观看体验
- 测试环境：可以先在小规模库上测试配置，再应用到生产环境
- 监控设置：启用日志记录以监控预览生成状态和性能
配置优化
- 间隔时间：根据内容类型调整预览间隔（电影10秒，电视剧5秒）
- 分辨率选择：平衡预览质量和存储空间
- 生成策略：大型库建议使用计划任务在非高峰时段生成
跨平台一致性
通过统一的配置和相同的预览文件格式，Jellyscrub确保了在所有客户端平台上的一致体验。无论用户使用哪种设备访问Jellyfin服务器，都能获得相同质量的视频预览功能。
🔮 未来发展与兼容性
随着Jellyfin 10.9.0将trickplay功能原生集成，Jellyscrub的发展方向已转向文件转换和维护。用户可以从以下方面受益：
- 平滑过渡：现有.bif文件可以无缝转换为Jellyfin原生格式
- 持续兼容：Jellyscrub确保向后兼容性
- 社区支持：活跃的开发者社区提供持续更新和支持
通过本指南，您应该能够成功部署和配置Jellyscrub，在您的Jellyfin媒体服务器上实现跨平台的流畅视频预览体验。无论您是家庭用户还是小型企业部署，Jellyscrub都能显著提升您的媒体浏览体验。🚀
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
