Stream Manager

The Stream Manager provides real-time monitoring of active media streams and tools to manage server availability.

Active Sessions

The sessions view shows all currently active streams across your connected servers. It polls every 5 seconds as a baseline, and — when Real-Time Sync is enabled — pushes updates within ~2 seconds of a play, pause, or stop via the server’s WebSocket. Real-time events also let the maintenance, blackout, and transcode enforcers see a new stream within about half a second instead of up to 30 seconds.

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

Working with Sessions

• Click a session card to open its detail panel with full overview, stream, media, and transcode information.
• Tick the checkbox in a card’s corner to select sessions, then use Terminate Selected — or Select All / Terminate All for everything at once.
• The strip along each card’s bottom edge shows playback progress, colored by state (accent while playing, amber while paused).

Maintenance Mode

Temporarily pause all streaming activity for server maintenance.

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

When maintenance mode is enabled:

1. A grace period countdown begins (configurable delay)
2. Active streams receive a notification
3. After the delay, sessions are terminated
4. New connection attempts are rejected with the custom message
5. Discord notification sent (if configured)

When maintenance mode is disabled:

1. Normal streaming resumes immediately
2. Discord notification sent (if configured)

Note

The maintenance enforcer polls every 30 seconds to check compliance. Some players may not see the maintenance message immediately — there can be a brief delay before enforcement takes effect.

Transcode Manager

Automatically terminate streams that match transcoding criteria.

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

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

The enforcer checks active streams every 30 seconds. Sessions matching any enabled criterion are terminated after the configured delay.

Caution

Enforcement depends on what your media server reports about each stream. Some player apps may not accurately report their status.

Blackout Schedules

Schedule recurring or one-time maintenance windows when streaming is automatically paused.

Schedule Types

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

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

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

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

• 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