diff --git a/README.md b/README.md index 9b33de4..eb6834b 100644 --- a/README.md +++ b/README.md @@ -16,9 +16,9 @@ Docker container which chooses a random movie from your Plex and/or Jellyfin mov - All cast capable devices # Functions -- NEW Use as a [Homepage](https://gethomepage.dev/main/) widget for simple movie recommandation. +- Use as a [Homepage](https://gethomepage.dev/main/) widget for simple movie recommandation. - Fetch Random unwatched movies from Plex and/or Jellyfin server. -- Filter by genre, year, and/or rating. Genre and years display only existing movies. +- 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. @@ -27,15 +27,15 @@ Docker container which chooses a random movie from your Plex and/or Jellyfin mov - PWA support. - Seamless switch between the two services. -image +image image HOMEPAGE MODE -image +image # DISCLAIMER -I am no programmer! Code is expanded with help of ChatGPT. Feel free to modify the code as you please. Also open to criticism ;) +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/ @@ -49,7 +49,6 @@ 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. @@ -61,11 +60,12 @@ services: 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 network host mode to use other external port. +If you do not have an Apple TV you can also change the container network type. Default container port is 4000 @@ -74,9 +74,9 @@ The power button displays the devices dynamically, meaning you HAVE to add the ` 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 button except Filter. This way you can have a more minimalistic Homepage Widget using iFrames. ENV for this is `HOMEPAGE_MPODE: TRUE` Of course you can use the iFrame with full functionality as well, just change the ENV then to `HOMEPAGE_MODE: FALSE` +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 following config to the Homepage services.yml +Add the following config to the Homepage services.yml ``` - Movie Roulette: - Movie Roulette: @@ -102,10 +102,11 @@ 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. -![image](https://github.com/user-attachments/assets/ffb29414-8886-4376-952c-2949af401b68) +![image](https://github.com/user-attachments/assets/82bba616-9de0-4098-998e-78b77d2fd931) # 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' @@ -144,14 +145,14 @@ Press the ```TURN ON DEVICE``` button and select your ```LGTV (webOS)```. A magi ## Plex Issue: Pressing the WATCH button does not show any client. -- Plex: Check above Plex and Plex client config. Restart your 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. -## Jellfin +## Jellyfin - Jellyfin: The client you expect does not support cast. # General @@ -164,6 +165,6 @@ Issue: Apple TV does not turn on - You need to re-pair. This needs to be done each time you recreate the container. -Issue: Browser does not load the poster and background. +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.