Merge branch 'main' of https://github.com/sahara101/movie-roulette

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. 
 
-<img width="1728" alt="image" src="https://github.com/user-attachments/assets/7181ebc1-b909-4e7a-b7e0-a30472515c82">
+<img width="1728" alt="image" src="https://github.com/user-attachments/assets/163936e1-a112-483c-8977-6ac260f94619">
 <img width="1727" alt="image" src="https://github.com/user-attachments/assets/ff5b33f4-d632-41e3-a4a2-1dc33ef2eff6">
 
 HOMEPAGE MODE
 
-<img width="935" alt="image" src="https://github.com/user-attachments/assets/022c733b-9d2c-418f-aa4b-dbfa4bfb83c7">
+<img width="905" alt="image" src="https://github.com/user-attachments/assets/b086dafd-9a4d-4e81-b9ad-9592631b7a90">
 
 # 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.