StreamMonitor
Made Simple
Everything you need to monitor, manage, and respond to your audio streams — without any technical background required.
Logging In
Access StreamMonitor by visiting the web address provided to you. You'll land on the sign-in page.
Open the site
Navigate to your StreamMonitor URL in any web browser (Chrome, Firefox, Safari, Edge all work).
Enter your credentials
Type your email address and password into the Sign In form, then click Sign In.
Forgot your password?
Click Forgot password? on the sign-in screen. Enter your email and you'll receive a reset link.
First-time setup
New accounts may prompt you to Set Password & Sign In via an invite link. Follow the on-screen steps to create your password.
The Dashboard
After signing in, you'll see the main Streams dashboard. This is your home base — it shows every stream you're monitoring in one place.
🔢 Summary Counters
At the top of the stream list you'll see three numbers: total streams, connected streams, and streams in alarm. These give you an instant health check.
📋 Stream List
Each row in the table represents one stream. Columns show the stream name, what's currently playing, left/right audio levels, bitrate, connection type, and current status.
⚡ Quick Actions
Use the ❄ Freeze button to pause the display, ▶ Start All to connect all streams at once, or ■ Stop All to disconnect everything. These are at the top of the stream list.
Stream Status & Meters
Each stream shows a colored status dot on the left side of its row. Here's what each color means:
OK
Stream is live and healthy
Pre-Alarm
Audio is low — watch closely
Audio Alarm
Silence or level problem detected
Metadata Alarm
Song/show info is missing
Disabled
Monitoring is turned off
The L R columns show a live left/right audio level bar for each stream, and dBFS shows the actual decibel reading. A healthy stream typically reads between -20 dBFS and -6 dBFS.
-∞ dBFS or the level bars go silent for several seconds, an audio alarm may trigger.The ⚡ Bitrate column shows the stream's data rate in kbps. A sudden drop can indicate connection trouble before audio silence occurs.
Adding & Managing Streams
To start monitoring a new stream, click + Add Stream at the top of the stream list. A panel will slide open with the following fields:
| Field | What to enter |
|---|---|
| Name | A friendly label for the stream (e.g. "WKRP-FM Live") |
| URL | The full stream address (starts with http:// or https://) |
| Auto-connect | Check this to have the stream connect automatically when you open the app |
| Disabled | Check to add the stream without actively monitoring it yet |
| Email on alarm | Check to receive email notifications when this stream has a problem |
| Threshold dBFS | The audio level below which an alarm fires (leave blank to use your default) |
| Alarm delay (s) | How many seconds of silence before triggering an alarm |
| Email notifications | Comma-separated list of email addresses to alert |
Click Save when done. The stream will appear in the list and begin connecting.
✎ Edit a Stream
Click the pencil icon or the stream name to open its settings and make changes.
🗑 Delete a Stream
Select the checkbox next to one or more streams, then click Delete Selected at the top.
📥 Import via CSV
Use Tools → Import CSV to bulk-add many streams at once from a spreadsheet file.
📤 Export Streams
Use Export All (or filtered exports) from the toolbar to download your stream list as a CSV.
Alarms & Muting
StreamMonitor can alert you by email when something goes wrong. There are two types of alarms to be aware of:
🔔 Audio Alarm
Fires when the audio level drops below your threshold for longer than the alarm delay. Usually means silence on air.
📖 Metadata Alarm
Fires when the "Now Playing" song/show data stops updating. Useful for catching automation issues.
Muting alarms lets you silence notifications during scheduled times (overnight, during maintenance, etc.) without turning off monitoring entirely.
Mute a single stream
Select the stream checkbox and click 🔔 Mute Audio or 📖 Mute Metadata from the toolbar to suppress alarms for that stream.
Set a mute schedule for a stream
Open the stream's edit panel and scroll to Email Mute Schedule. Click + Add muting schedule to define time windows when emails are suppressed.
Set your personal mute schedule
From the sidebar menu, go to 🕐 My Schedule to suppress alarm emails to your address during specific hours (times are in UTC).
Analytics & Now Playing
The 📊 Analytics section lets you review historical stream data — what was playing, when alarms fired, and usage patterns over time.
🎵 Now Playing History
Search what was playing on any stream during any date range. Filter by station, sort by time, title, or artist, and export results to CSV for reporting.
🕐 Day × Hour Heatmap
A visual grid showing when your streams were most active or had issues, broken down by day of week and hour of day. Great for spotting recurring problems.
📥 Export Events
Use Export Events DB from the toolbar to download a full log of audio alarms, metadata alarms, and Now Playing data for any date range and set of stations.
To use Analytics, set a From and To date, select your stations from the dropdown, then click the search or export button.
User Management
If you have an admin role, you can manage who has access to StreamMonitor from the 👥 Users panel in the sidebar menu.
| Role | What they can do |
|---|---|
| User | View streams and analytics; cannot change settings or add streams |
| Group Admin | Manage streams and users within their assigned group |
| Owner Admin | Full control over all groups and streams they own |
| Super Admin | Complete access to everything, including your settings |
Add a new user
Open Users, click + Add User, fill in their email, username, password, and role, then click Save & Send Invite to email them their login details.
Organize with Groups
Groups let you bundle streams together and assign users to only see what they need to. Click + Add Group, give it a name, assign an owner, and optionally grant access to all streams.
Disable a user
Find the user in the list, open their profile, and check the Disabled checkbox to revoke access without deleting their account.
Settings & Configuration
Settings apply to all of your streams unless overridden at the individual stream level. Access them from ⚙ Settings in the sidebar menu.
🎚 Default Thresholds
Set the default audio level threshold (in dBFS), alarm delay in seconds, and return-to-normal delay. Individual streams can override these values.
📧 Email Configuration
Configure how alarm emails are sent — choose between SMTP, SendGrid, or Mailgun. Set a default alert email address that receives notifications for all streams unless a specific address is set per-stream.
🔕 Muting Schedule
Set time windows (in UTC) during which no alarm emails are sent to anyone — regardless of individual settings. Useful for overnight maintenance windows.
🔇 Mute on Startup
Enable this to suppress alarms for a set number of seconds when the app first connects to streams — prevents false alarms during startup.
To change your own password at any time, click 🔑 Change Password from the sidebar menu and enter your new password (minimum 8 characters).