feat: add configurable stream monitoring to plex guide template

Add conditional stream kill explanations in "Having Issues?" section
with per-rule toggles: has_stream_monitoring (master), has_geo_restriction,
has_transcode_protection, has_stream_limits, has_impossible_travel.

Updated setup.sh with interactive prompts for new variables.

Author: bakerboy448

plex-guide/docs/index.md

@@ -34,7 +34,55 @@ tags:
 
 ## Having Issues?
 
-??? warning "Click here if something isn't working"
+{% if has_stream_monitoring %}
+If your stream was stopped or you're having trouble, find your situation below.
+
+!!! failure "Your Stream Was Stopped"
+
+    If you received a message that your stream was terminated, here's why and what to do:
+{% if has_geo_restriction %}
+
+    **"Streaming is restricted to the United States..."**
+
+    Your connection appears to be outside the permitted region. This is usually caused by a VPN.
+
+    1. **Disable your VPN** and try again — this is the most common fix
+    2. If you're not using a VPN, your ISP may be routing through another country — try a different network (e.g., switch from WiFi to cellular)
+    3. Still blocked? {{ admin_contact }} — they can whitelist your location
+{% endif %}
+{% if has_transcode_protection %}
+
+    **"4K content requires direct play..."**
+
+    Your device can't play this file directly, so the server is converting it — which lowers quality and uses server resources.
+
+    1. In the Plex app, set quality to **Original** or **Maximum** (see [quality settings](#the-picture-looks-bad-or-blurry))
+    2. If that doesn't help, your device may not support 4K — try a different device (see [recommended devices](#recommended-streaming-devices))
+    3. {{ admin_contact }} if you need help
+{% endif %}
+{% if has_stream_limits %}
+
+    **"This account is limited to X streams..."**
+
+    Too many people are watching on this account at the same time.
+
+    1. Ask others sharing the account to stop one of their streams
+    2. If you're not the account holder, [create your own free Plex account](#not-the-account-holder) — it takes 2 minutes
+    3. {{ admin_contact }} if this doesn't seem right
+{% endif %}
+{% if has_impossible_travel %}
+
+    **"Suspicious activity detected..."**
+
+    Your account was used from locations too far apart to be the same person.
+
+    1. If you recently traveled, wait a few minutes and try again
+    2. If someone else has your login, [secure your account](#account-security) immediately
+    3. {{ admin_contact }} if you believe this is an error
+{% endif %}
+
+{% endif %}
+!!! warning "General Troubleshooting"
 
     **Can't find {{ server_name }}?**
 

plex-guide/mkdocs.sample.yml

@@ -78,6 +78,13 @@ extra:
   server_cost: ""                         # Monthly server cost (e.g., "~$50/month")
   speedtest_url: ""                        # Speed test URL (e.g., "speedtest.example.com"). Falls back to fast.com if empty
 
+  # --- Stream monitoring (set to true if you use Tracearr/Tautulli kill rules) ---
+  has_stream_monitoring: false              # Master toggle — shows "Your Stream Was Stopped" section in Having Issues
+  has_geo_restriction: false               # Geo-based stream kills (VPN / out-of-country)
+  has_transcode_protection: false          # 4K transcode protection kills
+  has_stream_limits: false                 # Per-user simultaneous stream limit kills
+  has_impossible_travel: false             # Impossible-travel detection kills
+
   # --- Contact card (bot-protected, decoded via JavaScript) ---
   # Each method: type, label, value, preferred (optional)
   # Types: email, phone, signal_url, signal_username, telegram, discord, whatsapp, imessage

plex-guide/setup.sh

@@ -138,6 +138,21 @@ fi
 
 prompt speedtest_url "Speed test URL (leave blank for fast.com)" ""
 
+# Stream monitoring
+printf "\n%b=== Stream Monitoring ===%b\n\n" "$YELLOW" "$NC"
+
+prompt_bool has_stream_monitoring "Do you use stream monitoring (Tracearr/Tautulli kill rules)?" "false"
+has_geo_restriction="false"
+has_transcode_protection="false"
+has_stream_limits="false"
+has_impossible_travel="false"
+if [[ "$has_stream_monitoring" == "true" ]]; then
+  prompt_bool has_geo_restriction "Geo-based stream kills (VPN / out-of-country)?" "false"
+  prompt_bool has_transcode_protection "4K transcode protection kills?" "false"
+  prompt_bool has_stream_limits "Per-user stream limit kills?" "false"
+  prompt_bool has_impossible_travel "Impossible-travel detection kills?" "false"
+fi
+
 # Update config
 printf "\n%bUpdating %s...%b\n" "$YELLOW" "$CONFIG_FILE" "$NC"
 
@@ -170,6 +185,11 @@ update_config "has_migration" "$has_migration" true
 update_config "show_costs" "$show_costs" true
 update_config "server_cost" "$server_cost"
 update_config "speedtest_url" "$speedtest_url"
+update_config "has_stream_monitoring" "$has_stream_monitoring" true
+update_config "has_geo_restriction" "$has_geo_restriction" true
+update_config "has_transcode_protection" "$has_transcode_protection" true
+update_config "has_stream_limits" "$has_stream_limits" true
+update_config "has_impossible_travel" "$has_impossible_travel" true
 
 printf "%bConfiguration updated.%b\n\n" "$GREEN" "$NC"