Rules
Define what to watch for and what happens when conditions match. Rules are evaluated in real-time against every stream event, giving you fine-grained control over your media server access policies.
Common Uses
- Limit concurrent streams per account or per person across all their servers
- Detect account sharing through geographic anomalies
- Restrict transcoding for specific users or devices
- Block access from certain countries or IP ranges
- Enforce quality limits based on network or device type
- Send notifications when specific events occur
How Rules Work
Each rule consists of conditions that define when it triggers and actions that define what happens.
Conditions
Conditions are evaluated against stream metadata. Multiple conditions are combined with AND/OR logic.
Actions
Actions execute when all conditions match. Multiple actions can run for a single rule.
Rule Scopes
Every rule is scoped to exactly one of the following. Person-level scoping follows a merged identity across every server it touches.
Global
Applies across every server and every account you monitor.
Per-Server
Scoped to a single media server, leaving the rest untouched.
Per-Account
Scoped to one account on one server.
Per-Person
Scoped to a merged identity, following that person across every account they hold.
Person-scoped rules can optionally enforce across every one of that person's accounts, not just the account that triggered the match. This cross-server enforcement toggle is off by default—you opt in per rule.
24 Conditions Across 6 Categories
Session Behavior
- Concurrent Streams
- Distance Between Sessions
- Travel Speed
- Unique IPs in Window
- Unique Devices in Window
- Days Inactive
- Current Pause Duration
- Total Pause Duration
Stream Quality
- Source Resolution
- Output Resolution
- Is Transcoding
- Transcode Downgrade
- Source Bitrate
User Attributes
- User
- Trust Score
- Account Age
Device & Client
- Device Type
- Client/Player
- Platform/OS
Network & Location
- Local Network
- Country
- IP Range
Scope
- Server
- Media Type
Examples
Common rule configurations to get you started.
Person-Wide Stream Limit
Allow up to 3 concurrent streams for a person, counted across every account they hold on every server. Additional streams are terminated with a friendly message.
No Transcoding for Remote
Remote users must direct play. Transcoding streams are stopped to preserve server resources.
Impossible Travel Alert
Flag when the same account streams from two distant locations within an hour.
Country Whitelist
Only allow streams from approved countries. Useful for content licensing compliance.
Ready to set up your rules?
Check the documentation for detailed guides or get started with the GitHub repository.