Forked from https://github.com/Akasiek/Random-Plex-Movie

Movie Roulette

Docker container which chooses a random movie from your Plex and/or Jellyfin movie libraries. Cinema Posters function added.

Breaking change v1.6.1 - v2.0 check new compose file

Tested Players

Plex

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

Jellyfin

• All cast capable devices

Functions

• Use as a Homepage widget for simple movie recommandation.
• Fetch Random unwatched movies from Plex and/or Jellyfin server.
• Filter by genre, year, and/or PG rating. Filters show data only from existing movies.
• See movie info.
• URLs to TMDB, Trakt and IMDB.
• Trailers on Youtube.
• Play movie on above tested players.
• Turn on Apple TV and LGTV ((webOS) directly in Plex or Jellyfin app).
• PWA support.
• Seamless switch between the two services.
• Cinema Posters using the Plex/Jellyfin movie posters with playing status, start/end time, progress bar and PG/Audio/Video information. See info below!!
• Default poster with configurable text. See info below!!

HOMEPAGE MODE

Cinema Poster

DISCLAIMER

I am no programmer! Code is expanded with help of ChatGPT a bit and mostly ClaudeAI. Feel free to modify the code as you please. Also, open to criticism ;)

docker-compose.yml

How to get the Plex token: https://support.plex.tv/articles/204059436-finding-an-authentication-token-x-plex-token/

How to get the Jellyfin API: Administration - Dashboard - API Keys - +

How to get the Jellyfin UserID: Profile - check the URL - copy the userId string

services:
  movie-roulette:
    image: ghcr.io/sahara101/movie-roulette:latest
    container_name: movie-roulette
    environment:
      #Homepage ENV
      HOMEPAGE_MODE: "FALSE"
      #Plex ENV
      PLEX_URL: ""
      PLEX_TOKEN: ""
      PLEX_MOVIE_LIBRARIES: "Filme" #Default movies, add more with comma delimiter A,B,C
      #Poster ENV
      TZ: "Europe/Bucharest"
      DEFAULT_POSTER_TEXT: "My Cool Cinema"
      PLEX_POSTER_USERS: "" #Plex username, add more with comma delimiter A,B,C
      JELLYFIN_POSTER_USERS: "" #Jellyfin username, add more with comma delimiter A,B,C
      #Jellyfin ENV
      JELLYFIN_URL: " "
      JELLYFIN_API_KEY: " "
      JELLYFIN_USER_ID: " "
      #Client ENV
      APPLE_TV_ID: " " 
      LGTV_IP: " " 
      LGTV_MAC: " "
      #Miscellaneous
      USE_LINKS: TRUE
      USE_FILTER: TRUE
      USE_WATCH_BUTTON: TRUE
      USE_NEXT_BUTTON: TRUE
    network_mode: host
    volumes:
      - ./movie_roulette_data:/app/data
    restart: unless-stopped

If you do not have an Apple TV you can also change the container network type.

Default container port is 4000

Posters are under :4000/poster

The power button displays the devices dynamically, meaning you HAVE to add the APPLE_TV_ID ENV in order to see the corresponding button and both LGTV_IP and LGTV_MAC for LG.

A switch between services is displayed if both Jellyfin and Plex are configured. Last used service will be remembered.

Homepage Mode

Added the option to remove all buttons. This way you can have a more minimalistic Homepage Widget using iFrames. ENV for this is HOMEPAGE_MODE: TRUE Of course you can use the iFrame with full functionality as well, or even pick and choose from the miscellaneous part. Just change the ENV to HOMEPAGE_MODE: FALSE or modify #Miscellaneous.

Add the following config to the Homepage services.yml

- Movie Roulette:
    - Movie Roulette:
        icon: /images/icons/movie-roulette.png
        widget:
          type: iframe
          src: "<url>"
          classes: movie-roulette # optional, use tailwind height classes
          referrerPolicy: same-origin # optional, no default
          allowPolicy: autoplay; fullscreen; gamepad # optional, no default

custom.css

.movie-roulette {
    width: 100%;
    height: 380px; /* Set your desired height here */
    border: none; /* Optional: remove the border */
  }

You can configure the widget to your liking, check the Homepage documentation.

PWA Support

Since version 1.3.1 you can 'install' as a webapp. On iOS go to share - add to homescreen. On Mac go to Safari File - add to dock. In Chrome you will see an install button.

First Use

!important! - Your client devices and plex need to be in the same network. On the first start a cache file for plex will be created which will make the movies load faster.

Plex Client Config

Navigate to settings and set 'Advertise as player' to 'On'

Plex Server Config

Navigate to settings - network and activate 'Enable local network discovery (GDM)'

Apple TV

Get the Apple TV ID

First start the container without adding the ID ENV since you do not have it yet.

docker exec -ti random-plex-movie /bin/sh
atvremote scan

Note down the Apple TV Identifier, usually the first long one: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Add it to the container ENV and restart it with docker-compose up -d

Pair with Apple TV

You will see a PIN on the Apple TV which you need to type in the docker sh

docker exec -ti random-plex-movie /bin/sh
atvremote --id xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --protocol companion pair
Enter PIN on screen: 
Pairing seems to have succeeded, yey!

LGTV (WebOS)

Get the TV IP and MAC and set them up in the ENV. You can see both in the TV settings. If you want to copy the MAC just ping the TV followed by the linux command ip neigh show

Press the TURN ON DEVICE button and select your LGTV (webOS). A magic packet will be sent and the TV will turn on. Accept the new connection. This will store the connection details in the container.

Cinema Posters

Playing a movie through movie roulette and also outside movie roulette from Plex/Jellyfin clients will show the movie poster with playing status, start/end time, progress bar and PG/Audio/Video information. Poster is to be found under :4000/poster URL.

Playing statuses are the following: NOW PLAYING, PAUSED, ENDED and STOPPED.

After a 5 minute timeout in STOPPED state a default poster will be shown. You can choose what text is displayed. I tested with max 3 words.

It is recommended to set the browser in full-screen mode.

!!IMPORTANT: I do not have a vertical monitor so could NOT test how the default and movie posters behave. It works for me on my laptop in landscape and on my tablet in landscape and portrait.

Troubleshooting

Plex

Issue: Pressing the WATCH button does not show any client.

• Plex: Check the above Plex and Plex client config. Restart your client.
• If Plex API does not find any players, neither will this App. You can get a list of active clients using:

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

• (Apple TV) Plex Apple TV is buggy and often it forgets it has the Advertise as player option active. You will need to deactivate it, force close the app, start the app and activate the option again, restart Plex app.
• (Apple TV) You will need to deactivate the option, logoff and force close the app. Start the app, skip login and activate the option. Then you can login back.

Jellyfin

• Jellyfin: The client you expect does not support cast.

General

Issue: Pressing the WATCH button does nothing.

• Check the docker logs, if you get an access denied error, check your Plex Token, it might've changed.
• Inspect the page. Collect the errors and open an issue.

Issue: Apple TV does not turn on

• You need to re-pair. This needs to be done each time you recreate the container.

Issue: The browser does not load the poster and background.

• You are probably using RPM with a reverse proxy URL but configured the container with the Plex/Jellyin IP. Change the ENV to Plex/Jellyfin FQDN.