first commit

USAGE_GUIDE.md

@@ -0,0 +1,92 @@
+# SRF Play Plugin - Usage Guide
+
+## Finding the Channel in Jellyfin
+
+After installing and enabling the plugin, you can access SRF Play content through the **Channels** feature in Jellyfin.
+
+### Step-by-Step Instructions:
+
+1. **Open Jellyfin** in your web browser
+
+2. **Navigate to Channels**:
+   - On the Jellyfin home screen, look in the left sidebar menu
+   - Click on **"Live TV & Channels"** or **"Channels"**
+   - You should see "SRF Play" listed among your available channels
+
+3. **Browse Content**:
+   - Click on the "SRF Play" channel
+   - You'll see two main folders:
+     - **Latest Videos** - Recently published SRF content
+     - **Trending Videos** - Popular content from SRF
+
+4. **Watch Videos**:
+   - Click into either folder to browse videos
+   - Click on any video to play it
+   - Videos will stream directly via HLS
+
+### Alternative Navigation:
+
+If you don't see a "Channels" section in the sidebar:
+
+1. Go to **Dashboard** (gear icon or Admin menu)
+2. Click on **"Live TV"** in the left menu
+3. Look for **"Channels"** section
+4. Enable the "SRF Play" channel if it's not already enabled
+
+### Configuration:
+
+To configure the plugin (change business unit, quality, etc.):
+
+1. Go to **Dashboard** → **Plugins**
+2. Find **"SRF Play"** in the list
+3. Click on it to access settings
+4. Configure:
+   - **Business Unit**: SRF, RTS, RSI, RTR, or SWI
+   - **Quality Preference**: Auto, SD, or HD
+   - **Enable Latest Content**: Show latest videos
+   - **Enable Trending Content**: Show trending videos
+
+### Troubleshooting:
+
+**Channel not appearing?**
+- Restart Jellyfin after installing the plugin
+- Check Dashboard → Plugins to ensure SRF Play is enabled
+- Check the plugin configuration (Dashboard → Plugins → SRF Play)
+
+**No videos showing?**
+- Ensure "Enable Latest Content" and/or "Enable Trending Content" are checked in plugin settings
+- Check Jellyfin logs for any error messages (Dashboard → Logs)
+- Verify your Jellyfin server has internet access to reach `il.srgssr.ch`
+
+**Videos won't play?**
+- Check your Jellyfin server can access HLS streams
+- Verify firewall settings allow outbound HTTPS connections
+- Check the quality setting - try "Auto" if HD/SD isn't working
+
+### What Content is Available?
+
+- **Latest Videos**: The most recently published content from the selected business unit (SRF, RTS, etc.)
+- **Trending Videos**: Popular/trending content from the business unit
+- All videos are VOD (Video on Demand) - no live TV channels due to DRM restrictions
+
+### Content Expiration:
+
+SRF content has expiration dates. The plugin:
+- Automatically filters out expired content
+- Runs scheduled tasks to remove expired items from your library
+- Checks expiration every 24 hours (configurable)
+
+### Notes:
+
+- Only non-DRM content is accessible (no Widevine protected streams)
+- Live TV channels are not available due to DRM
+- Content availability depends on the selected business unit and SRF's content policies
+- The plugin shows up to 50 videos per category
+
+## Need Help?
+
+If you encounter issues:
+1. Check Jellyfin logs (Dashboard → Logs)
+2. Verify plugin configuration
+3. Ensure your network allows access to `il.srgssr.ch`
+4. Report issues on the plugin's GitHub repository