Forked from https://github.com/Akasiek/Random-Plex-Movie
Docker container which chooses a random movie from your Plex and/or Jellyfin movie library.
- 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)
- All cast capable devices
- 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.
HOMEPAGE MODE
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 ;)
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:
plex-random-movie:
image: ghcr.io/sahara101/movie-roulette:latest
environment:
HOMEPAGE_MODE: "FALSE" #Set to TRUE if you want to use it as a Homeage widget without any buttons (Filter remains active)
PLEX_URL: "Your-Plex-URL" #FQDN preferred. Do not use if you only want Jellyfin function.
PLEX_TOKEN: "TOKEN" #Do not use if you only want Jellyfin function.
MOVIES_LIBRARY_NAME: 'Filme' #Option for Plex. Default 'Movies'. Used for IMDB, Trakt and TMDB links. Do not use if you only want Jellyfin function.
JELLYFIN_URL: "Your-Jellyfin-URL" #Do not use if you only want Plex function.
JELLYFIN_API_KEY: "API" #Do not use if you only want Plex function.
JELLYFIN_USER_ID: "USERID" #Do not use if you only want Plex function.
APPLE_TV_ID: "ID" #Optional
LGTV_IP: "IP" #Optional
LGTV_MAC: "MAC_Address" #Optional
volumes:
- ./movie_roulette_data:/app/data
network_mode: host
restart: unless-stopped
If you do not have an Apple TV you can also change the container network type.
Default container port is 4000
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.
Added the option to remove all buttons except Filter. 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, just change the ENV then to HOMEPAGE_MODE: FALSE
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.
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.
!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.
Navigate to settings and set 'Advertise as player' to 'On'
Navigate to settings - network and activate 'Enable local network discovery (GDM)'
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
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!
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.
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 playeroption 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: The client you expect does not support cast.
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.