DRM Monitoring: Widevine, PlayReady, and ClearKey Session Tracking

Stream Probe introduces DRM monitoring in this update, adding reactive session tracking and scheme detection for protected video streams.

TL;DR

Debugging DRM-protected streams used to mean digging through logs to find license errors or session failures. Stream Probe now detects the DRM scheme in use, tracks session lifecycle events, and shows everything in a dedicated DRM tab inside the player overlay.

What's New

• DRM scheme detection: Automatically identifies Widevine, PlayReady, and ClearKey from active sessions via DrmSchemeDetector
• Session lifecycle tracking: DrmSessionTracker captures session open, key loading, license request, and error events in real time
• New DRM tab in the overlay: Dedicated tab showing session state, scheme info, and a timeline of DRM events
• DRM summary row: At-a-glance DRM status visible without opening the full tab
• Protected stream badges: The app layer now badges streams that require DRM in the stream list
• SessionStore integration: DRM state flows wired into the existing SessionStore for consistent reactive updates
• Unit test coverage: Tests added for detection logic, session tracking, and event formatting

How to Use

No extra configuration needed for detection. Stream Probe picks up DRM sessions automatically when playing protected content. If you want to pass custom DRM configuration (license URL, headers), the app layer now accepts a DRM config object at stream setup.

Once a protected stream is playing, open the overlay and tap the DRM tab. You'll see:

1. Active DRM scheme (Widevine / PlayReady / ClearKey)
2. Current session state
3. Timestamped event timeline for license requests and errors

FAQ

[ { "question": "Which DRM schemes does Stream Probe detect?", "answer": "Stream Probe detects Widevine, PlayReady, and ClearKey automatically from the active media session. No manual configuration is required for detection." }, { "question": "Do I need to change my existing setup to use DRM monitoring?", "answer": "No. Detection is automatic for existing setups. Custom DRM config (like license server URLs or request headers) is optional and only needed if your stream requires it." }, { "question": "Where do DRM errors appear in the overlay?", "answer": "DRM errors show up in the DRM tab timeline, timestamped alongside session events. They're separate from the playback error timeline so you can tell whether an issue is a DRM failure or a general playback failure." }, { "question": "Is DRM session data included in the existing error tracking timeline?", "answer": "DRM events have their own dedicated tab and timeline. The existing error tracking timeline covers general playback errors and is not merged with DRM session events." } ]