sahara101/movie-roulette Docker Image Overview

sahara101/movie-roulette

sahara101

Movie Roulette是一款从Plex、Jellyfin或Emby媒体库中随机选择电影的应用，支持电影院海报模式、设备控制、服务集成及PWA功能，帮助用户轻松决定观看内容。

2 收藏0 次下载

💣 CI/CD 卡在拉镜像？问题不在代码，在镜像源

中文简介版本下载

💣 CI/CD 卡在拉镜像？问题不在代码，在镜像源

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) - 支持开机功能和应用启动

容器镜像

镜像仓库	架构	版本	镜像路径
Docker Hub	AMD64	最新版	`sahara101/movie-roulette:latest`
Docker Hub	ARM64/ARMv7	最新版	`sahara101/movie-roulette:arm-latest`
GHCR	AMD64	最新版	`ghcr.io/sahara101/movie-roulette:latest`
GHCR	ARM64/ARMv7	最新版	`ghcr.io/sahara101/movie-roulette:arm-latest`

可将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应用请查看此处

首次运行

如未配置服务，会自动重定向到设置页面
至少设置一个媒体服务器（Plex/Jellyfin/Emby）
可选：启用认证
自动重定向到管理员用户设置页面
等待Plex初始缓存构建完成
可选：配置额外服务（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获取完整配置选项。

功能演示

标准模式
- 随机电影选择
- 筛选选项
- 电影搜索
- 电影详情和预告片
- 演员/剧组 filmography
电影院海报模式
- 实时播放状态
- 正在播放显示
- 屏保模式
- 默认海报模式下的自定义文本
- 多用户监控
首页模式
- 极简小部件

配置方式

UI配置 vs 环境变量配置

Movie Roulette提供两种配置方式：

设置UI（推荐）
- 易于使用的/settings界面
- 自动发现功能
- 实时验证
- 可视化配置
环境变量
- 覆盖UI设置
- 锁定UI中的设置

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

优先于UI设置

在UI中显示为“由环境变量设置”

在设置界面中被锁定/禁用

环境变量

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

变量	描述	默认值	UI替代方案
`PLEX_URL`	Plex服务器URL	-	✅ 带测试的设置
`PLEX_TOKEN`	Plex认证令牌	-	✅ OAuth流程
`PLEX_MOVIE_LIBRARIES`	电影库名称	"Movies"	✅ 库扫描器
`JELLYFIN_URL`	Jellyfin服务器URL	-	✅ 设置
`JELLYFIN_API_KEY`	Jellyfin API密钥	-	✅ 自动设置
`JELLYFIN_USER_ID`	Jellyfin用户ID	-	✅ 自动设置
`EMBY_URL`	Emby服务器URL	-	✅ 设置
`EMBY_API_KEY`	Emby API密钥	-	✅ 设置
`EMBY_USER_ID`	Emby用户ID	-	✅ 设置

可选但推荐变量

变量	描述	默认值	UI替代方案
`FLASK_SECRET_KEY`	用于会话cookie签名的安全密钥	启动时随机生成	-

可选功能变量

变量	描述	默认值	UI替代方案
`AUTH_ENABLED`	启用认证	FALSE	✅ 设置
`AUTH_SESSION_LIFETIME`	认证会话时长（秒）	86400	✅ 设置
`AUTH_PASSKEY_ENABLED`	启用Passkey	FALSE	✅ 设置
`AUTH_RELYING_PARTY_ID`	Passkeys的域名标识符	✅ 设置
`AUTH_RELYING_PARTY_ORIGIN`	Passkeys的完整基础URL	✅ 设置
`ENABLE_MOVIE_LOGOS`	显示TMDB标题logo	FALSE	✅ 设置
`LOAD_MOVIE_ON_START`	直接显示电影还是显示按钮	TRUE	✅ 设置
`DISABLE_SETTINGS`	锁定设置页面	FALSE	-
`HOMEPAGE_MODE`	首页小部件模式	FALSE	✅ 设置
`TMDB_API_KEY`	自定义TMDb密钥	内置密钥	✅ 设置
`USE_LINKS`	显示链接按钮	TRUE	✅ 设置
`USE_FILTER`	显示筛选按钮	TRUE	✅ 设置
`USE_WATCH_BUTTON`	显示观看按钮	TRUE	✅ 设置
`USE_NEXT_BUTTON`	显示下一个按钮	TRUE	✅ 设置
`ENABLE_MOBILE_TRUNCATION`	移动端是否截断描述	FALSE	✅ 设置

请求服务（可选）

变量	描述	默认值	UI替代方案
`OVERSEERR_URL`	Overseerr URL	-	✅ 设置
`OVERSEERR_API_KEY`	Overseerr API密钥	-	✅ 设置
`JELLYSEERR_URL`	Jellyseerr URL	-	✅ 设置
`JELLYSEERR_API_KEY`	Jellyseerr API密钥	-	✅ 设置
`OMBI_URL`	Ombi服务器URL	-	✅ 设置
`OMBI_API_KEY`	Ombi API密钥	-	✅ 设置
`REQUEST_SERVICE_DEFAULT`	默认请求服务	"auto"	✅ 设置
`REQUEST_SERVICE_PLEX`	Plex请求服务覆盖	"auto"	✅ 设置
`REQUEST_SERVICE_JELLYFIN`	Jellyfin请求服务覆盖	"auto"	✅ 设置
`REQUEST_SERVICE_EMBY`	Emby请求服务覆盖	"auto"	✅ 设置

设备控制（可选）

变量	描述	默认值	UI替代方案
`APPLE_TV_ID`	Apple TV标识符	-	✅ 自动发现
`TV_<NAME>_TYPE`	TV类型（`webos`、`tizen`、`android`）	-	✅ 自动发现
`TV_<NAME>_IP`	TV IP地址	-	✅ 自动发现
`TV_<NAME>_MAC`	TV MAC地址	-	✅ 自动发现

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

电影院海报（可选）

变量	描述	默认值	UI替代方案
`TZ`	海报时区	UTC	✅ 设置
`DEFAULT_POSTER_TEXT`	默认文本	-	✅ 设置
`PLEX_POSTER_USERS`	要监控的Plex用户	-	✅ 用户选择器
`JELLYFIN_POSTER_USERS`	要监控的Jellyfin用户	-	✅ 用户选择器
`EMBY_POSTER_USERS`	要监控的Emby用户	-	✅ 用户选择器
`POSTER_MODE`	无电影播放时显示的海报类型	Default	✅ 设置
`POSTER_DISPLAY_MODE`	播放电影时优先显示内容	first_active	✅ 设置
`SCREENSAVER_INTERVAL`	屏保更新频率（秒）	300	✅ 设置
`PREFERRED_POSTER_USER`	始终显示的用户	-	✅ 用户选择器
`PREFERRED_POSTER_SERVICE`	上述用户所属的服务	-	❌ 自动

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

自定义Trakt（可选）

变量	描述	默认值	UI替代方案
`TRAKT_CLIENT_ID`	自定义Trakt应用ID	内置应用	✅ 内置认证
`TRAKT_CLIENT_SECRET`	自定义Trakt密钥	内置应用	✅ 内置认证
`TRAKT_ACCESS_TOKEN`	自定义访问令牌	-	✅ 内置认证
`TRAKT_REFRESH_TOKEN`	自定义刷新令牌	-	✅ 内置认证

Plex配置

Plex客户端

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

Plex服务器

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

高级配置

使用环境变量配置Apple TV

获取Apple TV ID：

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

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

添加到环境变量：

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

与Apple TV配对：

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

在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"