KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #ai-agents #dsh-plugin #codex #developer-tools #claude-code #windows #desktop-app #typescript #rust #ai-agent #cli

Jellyfin-betterJellyfinWebPlayer-extension

★ 10 Open GitHub ↗

更适合中国宝宝体质的Jellyfin播放器插件，体验与B站视频播放基本一致。A Jellyfin player plugin that is more suitable for the Chinese audience, offering a viewing experience that is basically consistent with Bilibili video playback.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Jellyfin 沉浸式播放控制扩展

更适合中国宝宝体质的 Jellyfin 播放器增强插件，提供类似 B 站的播放体验。

## 支持的客户端

- **Jellyfin Web** - 完整功能支持
- **Jellyfin Android** - 使用网页播放器时支持
- **Jellyfin iOS**

## 核心功能

### 🎮 键盘控制增强
- **右键短按**：快进 10 秒
- **右键长按**：2 倍速播放（松开恢复正常速度）
- **智能倍速显示**：倍速时显示呼吸灯动画效果

### 📱 移动端触摸控制
- **长按屏幕**：2 倍速播放
- **水平滑动**：调节播放进度
  - 滑动时调节播放进度并显示时间预览
  - 每 100 像素对应 10 秒时长
  - 拖动时如果媒体库有生成预览图，会在左下角显示预览图
- **双击播放/暂停**：快速控制播放状态

## 安装方法

### 方法一：用户脚本管理器（推荐）

1. 安装用户脚本管理器：
   - [Tampermonkey](https://www.tampermonkey.net/) （推荐）
   - [Violentmonkey](https://violentmonkey.github.io/)

2. 安装脚本：
   - 点击 [此处](https://greasyfork.org/zh-CN/scripts/545518-jellyfin-%E6%B2%89%E6%B5%B8%E5%BC%8F%E6%92%AD%E6%94%BE%E6%8E%A7%E5%88%B6-%E9%94%AE%E7%9B%98-%E8%A7%A6%E6%91%B8%E5%A2%9E%E5%BC%BA-%E5%80%8D%E9%80%9F-%E6%BB%91%E5%8A%A8%E8%BF%9B%E5%BA%A6-%E6%99%BA%E8%83%BDosd) 在 Greasyfork 安装脚本
   - 或手动创建新脚本，将 `batter_player.js` 中的代码复制粘贴进去

3. 保存并启用脚本，刷新 Jellyfin 网页界面即可使用

### 方法二：Nginx 反向代理部署

适用于有自己服务器的用户，可以为所有用户自动启用增强功能。

1. 将 `batter_player.js` 文件上传到服务器：
```bash
# 创建目录
sudo mkdir -p /usr/share/nginx/html/js/

# 上传脚本文件
sudo cp batter_player.js /usr/share/nginx/html/js/
```

2. 配置 Nginx，参考项目中的 `jellyfin.conf`：

3. 重启 Nginx 服务：
```bash
sudo systemctl restart nginx
```

## 使用说明

### 桌面端使用
安装成功后，在 Jellyfin 播放器中：

1. **快进操作**：按住键盘右方向键短按（< 300ms）快进 10 秒
2. **倍速播放**：按住键盘右方向键长按（≥ 300ms）开启 2 倍速，松开恢复正常
3. **倍速指示**：倍速时屏幕上方会显示速度指示器和呼吸灯动画

### 移动端使用
在移动设备上使用时：

1. **双击播放/暂停**：双击视频区域控制播放状态
2. **长按倍速**：长按视频区域开启 2 倍速播放
3. **滑动调节进度**：
   - 水平向右滑动：快进
   - 水平向左滑动：快退
   - 滑动时显示时间预览和自定义进度条
   - 松手时跳转到目标时间点

## 常见问题

### Q: 脚本没有生效怎么办？
A: 请检查：
1. 用户脚本管理器是否正确安装并启用
2. 脚本是否激活
3. 刷新页面后重新进入播放器
4. 检查浏览器控制台是否有错误信息

### Q: 移动端触摸功能不工作？
A: 确保：
1. 触摸操作在视频播放区域进行
2. 不要触摸到 OSD 控制按钮区域
3. 滑动距离足够长（超过 20 像素）

### Q: 倍速功能与 Jellyfin 原生倍速冲突？
A: 本脚本与原生倍速功能独立，不会冲突。脚本倍速仅在按键期间生效。

## 更新日志

### v1.0 (2024-08-12)
- 🎉 首次发布
- ✨ 键盘右键快进和倍速功能
- ✨ 移动端触摸滑动进度调节
- ✨ 智能 OSD 隐藏
- ✨ 倍速呼吸灯动画效果

## 支持与反馈

如果您在使用过程中遇到问题或有功能建议，请在 [GitHub Issues](https://github.com/guiyuanyuanbao/Jellyfin-betterJellyfinWebPlayer-extension/issues) 中提交。

## 开源协议

本项目基于 [MIT License](LICENSE) 开源，欢迎贡献代码和建议。

## 相关链接

- [项目主页](https://github.com/guiyuanyuanbao/Jellyfin-betterJellyfinWebPlayer-extension)
- [Greasyfork 脚本页面](https://greasyfork.org/zh-CN/scripts/545518-jellyfin-%E6%B2%89%E6%B5%B8%E5%BC%8F%E6%92%AD%E6%94%BE%E6%8E%A7%E5%88%B6-%E9%94%AE%E7%9B%98-%E8%A7%A6%E6%91%B8%E5%A2%9E%E5%BC%BA-%E5%80%8D%E9%80%9F-%E6%BB%91%E5%8A%A8%E8%BF%9B%E5%BA%A6-%E6%99%BA%E8%83%BDosd)
- [Jellyfin 官网](https://jellyfin.org/)

---

💡 **提示**：如果觉得这个项目对您有帮助，请给个 ⭐ Star 支持一下！

Jellyfin-betterJellyfinWebPlayer-extension

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README