jellyfin-srfPlay/USAGE_GUIDE.md

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