Stream Manager
The Stream Manager provides real-time monitoring of active media streams and tools to manage server availability.
Active Sessions
Section titled “Active Sessions”The sessions view shows all currently active streams across your connected servers, refreshing every 5 seconds.
Information Displayed
Section titled “Information Displayed”For each active stream:
| Field | Description |
|---|---|
| Server | Which media server is streaming |
| User | Username and avatar |
| Title | Media title (movie, episode, or track) |
| Type | Movie, Episode, or Track |
| Quality | Resolution, codec, container, bitrate |
| Player | App name, device, platform, playback state |
| Connection | Local or remote |
| Bandwidth | Network bandwidth consumed |
| Progress | Current position / total duration |
| Transcoding | Whether the stream is being converted, and hardware acceleration status |
Maintenance Mode
Section titled “Maintenance Mode”Temporarily pause all streaming activity for server maintenance.
Configuration
Section titled “Configuration”| Setting | Description |
|---|---|
| Custom Message | Message displayed to users explaining the maintenance |
| Delay | Seconds to wait before terminating active streams (default: 30) |
| Excluded Users | Users who can continue streaming during maintenance |
Behavior
Section titled “Behavior”When maintenance mode is enabled:
- A grace period countdown begins (configurable delay)
- Active streams receive a notification
- After the delay, sessions are terminated
- New connection attempts are rejected with the custom message
- Discord notification sent (if configured)
When maintenance mode is disabled:
- Normal streaming resumes immediately
- Discord notification sent (if configured)
Transcode Manager
Section titled “Transcode Manager”Automatically terminate streams that match transcoding criteria.
Criteria
Section titled “Criteria”| Criterion | Description |
|---|---|
| Any Transcoding | Terminate sessions where video or audio is being transcoded |
| Video Transcoding | Terminate sessions where video is being transcoded |
| Audio Transcoding | Terminate sessions where audio is being transcoded |
| 4K Transcoding | Terminate sessions that are transcoding 4K content |
| Remote Transcoding | Terminate remote (non-local) sessions that are transcoding |
Settings
Section titled “Settings”| Setting | Description |
|---|---|
| Delay | Seconds to wait before terminating matching streams (default: 30) |
| Custom Message | Message displayed to users when their session is terminated |
| Excluded Users | Users who bypass transcode restrictions |
Enforcement
Section titled “Enforcement”The enforcer checks active streams every 30 seconds. Sessions matching any enabled criterion are terminated after the configured delay.
Blackout Schedules
Section titled “Blackout Schedules”Schedule recurring or one-time maintenance windows when streaming is automatically paused.
Schedule Types
Section titled “Schedule Types”Recurring
Section titled “Recurring”Set repeating windows on specific days and times.
- Days of week: Select one or more days
- Start/End time: 24-hour format
- Example: Monday, Wednesday, Friday — 2:00 AM to 4:00 AM
One-Time
Section titled “One-Time”Set a single maintenance window with specific start and end dates/times.
- Example: December 25, 2024 12:00 AM to December 26, 2024 11:59 PM
Blackout Behavior
Section titled “Blackout Behavior”During a blackout window:
- Active sessions are terminated after a configurable delay
- Custom message displayed to users
- User exclusions supported
- Discord notification sent (if configured)
Actions
Section titled “Actions”| Action | Description |
|---|---|
| Terminate Immediately | Stop sessions as soon as the blackout starts |
| Warn Then Terminate | Send a warning, then terminate after a configurable delay |
| Block New Only | Allow existing sessions to continue but block new connections |
Limitations
Section titled “Limitations”- Stream data accuracy depends on the media server’s API reporting
- Maintenance mode and blackout enforcement have up to a 30-second delay between checks
- Some player apps may not immediately respond to a stop request
- Stream conversion detection relies on what your media server reports, which varies by player app