jellyfin-srfPlay/USAGE_GUIDE.md
Duncan Tourolle ac6a3842dd
Some checks failed
🏗️ Build Plugin / call (push) Failing after 0s
📝 Create/Update Release Draft & Release Bump PR / call (push) Failing after 0s
🧪 Test Plugin / call (push) Failing after 0s
🔬 Run CodeQL / call (push) Failing after 0s
first commit
2025-11-12 22:05:36 +01:00

93 lines
3.1 KiB
Markdown

# 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