sahara101/movie-roulette Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Movie Roulette

无法决定看什么？Movie Roulette帮助你从Plex、Jellyfin和/或Emby媒体库中随机选择电影，具备电影院海报模式、服务集成和设备控制等功能。

![Docker Pulls]([] ![GHCR Downloads]([] ![GitHub Sponsor]([] ![]([***]

主要界面

额外视图

• 电影院海报模式
• 首页小部件
• 移动设备PWA
• 登录页面
• 带背景和Passkeys的登录页面
• 缓存管理
• 主题测试

丰富信息展示

• 演员和剧组详情
• 电影详情
• filmography 视图
• 收藏视图

核心功能

• 🎬 媒体服务器支持：从Plex、Jellyfin、Emby获取随机电影
• 🎫 电影院海报模式：数字电影海报显示，带实时播放进度
• 🔍 智能发现：按观看状态、类型、年份和评分筛选
• 📱 PWA支持：可在移动设备和桌面端作为应用安装
• 🎮 设备控制：直接在选定服务应用中开启Apple TV和电视设备
• 🔄 服务集成：
  • Trakt用于全局观看状态
  • Overseerr/Jellyseerr/Ombi用于请求
  • ***用于预告片
• 认证系统：支持媒体服务器登录、本地管理员（密码/Passkey）、Plex托管用户

注意：确保客户端设备和Plex服务器在同一网络。首次运行时，会创建Plex缓存文件以提高电影加载速度。

支持的播放器

Plex

• Apple TV - 支持开机功能和应用启动
• Plex HTPC MacOS客户端
• iPhone
• Plex for LGTV (WebOS) - 支持开机功能和应用启动
• 小米MI TV Box S (Android)

Jellyfin

• 所有支持投射的设备
• Apple TV - 支持开机功能和应用启动
• Jellyfin for LGTV (WebOS) - 支持开机功能和应用启动

Emby

• 所有支持投射的设备
• Apple TV - 支持开机功能和应用启动
• Emby for LGTV (WebOS) - 支持开机功能和应用启动

容器镜像

可将latest替换为具体版本号。

yaml
services:
  movie-roulette:
    image: # 参见上表
    container_name: movie-roulette
    ports:
      - "4000:4000"
    volumes:
      - ./movie_roulette_data:/app/data
    restart: unless-stopped

访问[***]并配置服务。

注意：如需设备控制（Apple TV/LG电视），请使用network_mode: host而非端口映射。

原生客户端

MacOS非Docker应用请查看此处

首次运行

1. 如未配置服务，会自动重定向到设置页面
2. 至少设置一个媒体服务器（Plex/Jellyfin/Emby）
3. 可选：启用认证
4. 自动重定向到管理员用户设置页面
5. 等待Plex初始缓存构建完成
6. 可选：配置额外服务（Trakt、Overseerr等）

关键配置

媒体服务器

Plex

• 服务器URL
• Token（支持OAuth）
• 电影库（支持自动扫描）

Jellyfin

• 服务器URL
• API密钥
• 用户ID

Emby

• 服务器URL
• API密钥
• 用户ID

集成服务

• TMDb（提供内置密钥或自定义API）
• Trakt（内置应用或自定义凭据）
• Overseerr/Jellyseerr/Ombi（可选，用于请求）

设备

• Apple TV（支持自动发现）
• LG WebOS、三星Tizen（预alpha）、安卓Sony（预alpha）（支持网络扫描）

参见示例docker-compose.yml获取完整配置选项。

功能演示

1. 标准模式

   • 随机电影选择
   • 筛选选项
   • 电影搜索
   • 电影详情和预告片
   • 演员/剧组 filmography

2. 电影院海报模式

   • 实时播放状态
   • 正在播放显示
   • 屏保模式
   • 默认海报模式下的自定义文本
   • 多用户监控

3. 首页模式

   • 极简小部件

配置方式

UI配置 vs 环境变量配置

Movie Roulette提供两种配置方式：

1. 设置UI（推荐）

   • 易于使用的/settings界面
   • 自动发现功能
   • 实时验证
   • 可视化配置

2. 环境变量

   • 覆盖UI设置
   • 锁定UI中的设置

⚠️ 重要：当通过环境变量配置设置时，它将：

• 优先于UI设置
• 在UI中显示为“由环境变量设置”
• 在设置界面中被锁定/禁用

环境变量

必要变量（如使用对应服务）

可选但推荐变量

可选功能变量

请求服务（可选）

设备控制（可选）

注意：将<NAME>替换为自定义TV标识符（如TV_LIVING_ROOM_TYPE: "webos"）。仅使用字母、数字和下划线。

电影院海报（可选）

注意：POSTER_MODE选项：default或screensaver；POSTER_DISPLAY_MODE选项：first_active或preferred_user

自定义Trakt（可选）

Plex配置

Plex客户端

进入设置并启用“Advertise as Player”（作为播放器广播）。

Plex服务器

进入设置→网络，启用“Enable Local Network Discovery (GDM)”（启用本地网络发现）。

高级配置

使用环境变量配置Apple TV

1. 获取Apple TV ID：

   bash
   docker exec -ti movie-roulette /bin/sh
   atvremote scan
   

2. 记录Apple TV标识符（格式：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx）

3. 添加到环境变量：

   yaml
   environment:
     APPLE_TV_ID: "你的-apple-tv-标识符"
   

4. 与Apple TV配对：

   bash
   docker exec -ti movie-roulette /bin/sh
   atvremote --id YOUR-ID --protocol companion pair
   

5. 在Apple TV上输入显示的PIN码

TV设备配置

Movie Roulette支持多个TV实例，使用动态命名模式。每个TV通过名称和所需参数配置。支持的TV平台：

支持的TV类型：

• webos：LG WebOS电视
• tizen：三星Tizen电视
• android：安卓电视

配置示例：

yaml
environment:
  # 客厅LG WebOS电视示例
  TV_LIVING_ROOM_TYPE: "webos"
  TV_LIVING_ROOM_IP: "192.168.1.100"
  TV_LIVING_ROOM_MAC: "AA:BB:CC:DD:EE:FF"
  
  # 卧室三星电视示例
  TV_BEDROOM_TYPE: "tizen"
  TV_BEDROOM_IP: "192.168.1.101"
  TV_BEDROOM_MAC: "11:22:33:44:55:66"
  
  # 厨房安卓电视示例
  TV_KITCHEN_TYPE: "android"
  TV_KITCHEN_IP: "192.168.1.102"
  TV_KITCHEN_MAC: "CC:DD:EE:FF:00:11"

首页集成

添加到Homepage的services.yaml：