joshjryan/jf-sleep-timer

sleep-timer

Jellyfin的简易睡眠定时器
https://github.com/joshjryan/sleep-timer

这是一个小型副业项目，仍有很大改进空间，欢迎提交Pull Requests。

镜像概述和主要用途

由于大多数Jellyfin客户端没有“仍在观看？”功能，本应用提供了一种解决方案。它利用Jellyfin官方Webhook插件的事件，统计特定设备上任何用户播放的剧集数量。当用户在小于设定时间间隔内连续播放超过指定数量的剧集时，将自动停止下一集的播放。

核心功能和特性

• 播放事件监控：通过Jellyfin Webhook插件接收“播放开始”事件
• 连续播放检测：统计指定时间间隔内的连续播放剧集数量
• 自动停止播放：当连续播放达到设定数量时，自动停止下一集播放
• 可配置参数：支持自定义剧集时间间隔和停止播放的剧集数量

使用场景和适用范围

适用于Jellyfin用户，尤其是使用缺乏“仍在观看确认”功能的客户端时，可防止因用户睡着或离开而持续播放剧集的情况，节省资源并提升观看体验。

使用方法和配置说明

前提条件

1. 启动sleep-timer Docker容器
2. 安装https://github.com/jellyfin/jellyfin-plugin-webhook
3. 添加通用目标，Webhook URL设置为http://{docker地址}:5553/webhook（将{docker地址}替换为实际容器地址）
4. 选择“Playback Start”通知类型，并选择要使用此睡眠定时器的用户

Docker Compose配置示例

以下是使用Docker Compose部署sleep-timer的示例：

yaml
version: '3.8'

services:
  sleep-timer:
    image: docker.xuanyuan.run/joshjryan/jf-sleep-timer:latest
    container_name: jf-sleep-timer
    ports:
      - "5553:5553"
    environment:
      # 必填项。Jellyfin服务器地址（例如：http://192.168.1.100:8096）
      JELLYFIN_API_URL: "value1"
      # 必填项。从Jellyfin服务器生成的API密钥
      JELLYFIN_API_TOKEN: "value2"
      # 可选项。连续剧集开始时间间隔（分钟），默认60
      EPISODE_START_INTERVAL: 60
      # 可选项。触发停止播放的剧集数量，默认4
      EPISODE_COUNT: 4
    restart: unless-stopped

环境变量说明