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.

• Cinema Poster Mode
• Homepage Widget
• PWA on Mobile

• Cast & Crew Details
• Movie Details
• Filmography View

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.

• 🎬 Media Server Support: Works with both Plex and Jellyfin
• 🎫 Cinema Poster Mode: Digital movie poster display with real-time progress
• 🔍 Smart Discovery: Filter by genre, year, and rating
• 📱 PWA Support: Install as app on mobile and desktop
• 🎮 Device Control: Power on Apple TV and LG TV devices
• 🔄 Service Integration:
  • Trakt for watch status
  • Overseerr/Jellyseerr for requests
  • YouTube for trailers

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.

• 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)

• All cast capable devices

Instead of latest you can also use the version number.

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.

For MacOS non-docker application please check here

1. Automatically redirects to settings if no services configured
2. Set up at least one media server (Plex/Jellyfin)
3. Wait for initial cache building
4. Optional: Configure additional services (Trakt, Overseerr, etc.)

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

• Server URL
• API Key
• User ID

• TMDb (built-in key provided)
• Trakt (built-in app or custom credentials)
• Overseerr/Jellyseerr (optional, for requests)

• Apple TV (auto-discovery available)
• LG TV (network scanning available)

See sample-compose.yml for full configuration options.

1. Standard Mode

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

2. Cinema Poster Mode

   • Real-time playback status
   • Now Playing display
   • Custom default text
   • Multiple user monitoring

3. Homepage Mode

   • Minimalist widget

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

Navigate to settings and enable Advertise as Player.

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

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

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

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.

If you find Movie Roulette useful, consider supporting development: