Movie Roulette

Can't decide what to watch? Movie Roulette helps you pick random movies from your Plex and/or Jellyfin libraries, with features like cinema poster mode, service integrations, and device control.

Main Interface

Additional Views

• Cinema Poster Mode
• Collections Page
• Collections Page Details
• Collections View
• Homepage Widget
• PWA on Mobile
• Login Page

Rich Information

• Cast & Crew Details
• Movie Details
• Filmography View
• Collection View

Star History

Contributing

This project was extended with the assistance of AI tools. The core functionality is based on Random-Plex-Movie and has been expanded with additional features and integrations.

Features

• Media Server Support: Get random movies with Plex, Jellyfin, Emby
• Cinema Poster Mode: Digital movie poster display with real-time progress
• Collections Page: Find al collections with missing watched movies. Optional connect Trakt to include more data
• Smart Discovery: Filter by watch status, genre, year, and rating
• Watch With (Plex): Pick a random movie from a shared pool — Watchlist mode intersects plex.tv watchlists (no app account needed for partner), Library mode finds movies neither user has seen from the full library (partner must have logged in once)
• PWA Support: Install as app on mobile and desktop
• Device Control: Power on Apple TV and TV devices directly in the selected service application
• Service Integration:
• Trakt for global watch status
• Seerr or Ombi for requests
• YouTube for trailers
• Authentication System: Login with Media Servers, local admin (pass/passkey), Plex Managed User.

Note: Ensure your client devices and Plex server are on the same network. On the first run, a Plex cache file will be created to enhance movie loading speeds.

Tested Players

Plex

• Apple TV - with turn on function and app start
• Plex HTPC MacOS Client
• iPhone
• Plex for LGTV (WebOS) - with turn on function and app start
• Xiaomi MI TV Box S (Android)

Jellyfin

• All cast capable devices
• Apple TV - with turn on function and app start
• Jellyfin for LGTV (WebOS) - with turn on function and app start

Emby

• All cast capable devices
• Apple TV - with turn on function and app start
• Emby for LGTV (WebOS) - with turn on function and app start

Quick Start

Container Images

latest is a multi-arch manifest — Docker and Kubernetes will automatically pull the correct image for your node's architecture. Instead of latest you can also use the version number (e.g. v5.4.3).

services:
  movie-roulette:
    image: #See above
    container_name: movie-roulette
    ports:
      - "4000:4000"
    volumes:
      - ./movie_roulette_data:/app/data
    restart: unless-stopped

Visit http://your-server:4000 and configure your services.

Note: For device control (Apple TV/LG TV), use network_mode: host instead of port mapping.

Native Clients

For MacOS non-docker application please check here

First Run

1. Automatically redirects to settings if no services are configured
2. Set up at least one media server (Plex/Jellyfin/Emby)
3. Optional: Enable Auth
4. Automatic redirection to admin user setup page
5. Wait for initial cache building for Plex
6. Optional: Configure additional services (Trakt, Seerr, etc.)

Key Configuration

Media Servers

Plex

• Server URL
• Token (OAuth available)
• Movie Libraries (auto-scan available)

Jellyfin

• Server URL
• API Key
• User ID

Emby

• Server URL
• API Key
• User ID

Integrations

• TMDb (built-in key provided or custom API)
• Trakt (built-in app or custom credentials)
• Seerr or Ombi (optional, for requests)

Devices

• Apple TV (auto-discovery available)
• LG WebOS, Samusng Tizen (pre-alpha), Android Sony (pre-alpha) (network scanning available)

See sample-compose.yml for full configuration options.

Features in Action

1. Standard Mode

   • Random movie selection
   • Filter options
   • Search movies
   • Movie details and trailers
   • Cast/crew filmographies

2. Cinema Poster Mode

   • Real-time playback status
   • Now Playing display
   • Screensaver Mode
   • Custom default text in Default Poster Mode
   • Multiple user monitoring

3. Homepage Mode

   • Minimalist widget

4. Collections Page

   • Request individual movies which are missing from library
   • Request movies in bulk in each collection
   • Availabe buttons/status:
     • Watch and Watch Again
     • Request
     • Requested
     • Watched on Trakt
   • Integration with trakt for a full list of collections
   • Search and display a random collection

Setup

UI vs ENV Configuration

Movie Roulette offers two ways to configure the application:

1. Settings UI (Recommended)

   • Easy-to-use interface at /settings
   • Auto-discovery features
   • Real-time validation
   • Visual configuration

2. Environment Variables

   • Override UI settings
   • Lock settings in UI

⚠️ Important: When a setting is configured through ENV variables, it will:

• Take precedence over UI settings
• Show as "Set by environment variable" in UI
• Be locked/disabled in settings interface

Environment Variables

Required (if using service)

Optional, but highly recommended

Optional Features

Request Service (Optional)

Device Control (Optional)

Note: Replace with your chosen TV identifier (e.g., TV_LIVING_ROOM_TYPE: "webos"). Only use letters, numbers, and underscores.

Cinema Poster (Optional)

Note: POSTER_MODE options: default or screensaver ; POSTER_DISPLAY_MODE options: first_active or preferred_user

Custom Trakt (Optional)

Plex Configuration

Plex Client

Navigate to settings and enable Advertise as Player.

Plex Server

Go to settings → Network and activate Enable Local Network Discovery (GDM).

Advanced Configuration

Apple TV Setup with ENV

1. Get Apple TV ID:

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

2. Note the Apple TV Identifier (format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)

3. Add to environment: environment: APPLE_TV_ID: "your-apple-tv-identifier"

4. Pair with Apple TV:

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

5. Enter PIN shown on Apple TV

TV Device Setup

Movie Roulette supports multiple TV instances using a dynamic naming pattern. Each TV is configured with a name and its required parameters. The application supports multiple TV platforms:

Supported TV Types:

• webos: LG WebOS TVs
• tizen: Samsung Tizen TVs
• android: Android-based TVs

Configuration example:

environment:
  # Example for LG WebOS TV in living room
  TV_LIVING_ROOM_TYPE: "webos"
  TV_LIVING_ROOM_IP: "192.168.1.100"
  TV_LIVING_ROOM_MAC: "AA:BB:CC:DD:EE:FF"
  
  # Example for Samsung TV in bedroom
  TV_BEDROOM_TYPE: "tizen"
  TV_BEDROOM_IP: "192.168.1.101"
  TV_BEDROOM_MAC: "11:22:33:44:55:66"
  
  # Example for Android TV in kitchen
  TV_KITCHEN_TYPE: "android"
  TV_KITCHEN_IP: "192.168.1.102"
  TV_KITCHEN_MAC: "CC:DD:EE:FF:00:11"

Homepage Integration

Add to Homepage's services.yaml:

- Movie Roulette:
    - Movie Roulette:
        icon: /images/icons/movie-roulette.png
        widget:
          type: iframe
          src: "http://your-server:4000"
          classes: h-96 w-full
          referrerPolicy: same-origin

Troubleshooting

Plex

Issue: Pressing the "WATCH" button doesn’t show any client.

• Verify Advertise as Player is enabled on the Plex client and restart the app.
• Check for active clients using:

curl -X GET "http://PLEXIP:32400/clients?X-Plex-Token=PLEXTOKEN"

• (Apple TV) Disable and re-enable Advertise as Player, force close the app, and restart.

Issue: Apple TV doesn’t turn on.

• You need to re-pair the Apple TV after recreating the container.

Issue: Browser doesn’t load the poster or background.

• Use the FQDN (Fully Qualified Domain Name) for Plex/Jellyfin in the environment variables/settings instead of the IP address.

Support

If you find Movie Roulette useful, consider supporting development: