Streaming Panel User Manual

Getting Started

Logging In

To access the streaming panel, navigate to the login page in your web browser. Enter your email address and password, then click Log In.

If two-factor authentication is enabled on your account, you will be prompted to enter a verification code from your authenticator app after entering your credentials.

Navigating the Dashboard

After logging in, you will see the main dashboard. If you have access to one or more stations, they will be listed on the dashboard. Click on a station name to open that station’s management interface.

The dashboard header contains:

• Station Player — A mini player that lets you listen to your station directly from the panel.
• User Menu (top-right) — Access your profile, help resources, and log out.

Understanding the Sidebar Menu

Once you enter a station’s management area, a sidebar menu appears on the left. The sidebar shows:

• Station Name — Displayed at the top of the sidebar, clickable to return to the station overview.
• Station Time — The current time in the station’s configured timezone, displayed below the station name.

The sidebar menu items depend on your permissions and on which features are enabled for the station. The following sections may appear:

Menu Item	Description
Overview	The station dashboard with now-playing info and status panels
Station Settings	Edit station name, description, and configuration
Public Pages	Branding and links to public-facing pages
Media	Music files, special views, SFTP users, bulk import/export
Playlists	Create and manage playlists for the AutoDJ
Podcasts	Manage podcasts and episodes
Live Streaming	Streamer/DJ accounts and Web DJ
Web Hooks	Configure webhooks and integrations
Reports	Station statistics, listener data, and playback history
Broadcasting	Mount points, HLS streams, remote relays, queue, fallback

Note: Menu items are only visible if you have the required permissions. If you do not see a menu item, contact your administrator to request access.

---

Station Overview

The Overview page is your station’s dashboard. It provides a real-time snapshot of your station’s current status, now-playing information, listeners, upcoming schedule, and stream details.

Now Playing

The Now Playing panel is the main information area on the dashboard. It displays:

• Album Art — The current song’s album artwork (click to enlarge).
• Song Title & Artist — The currently playing track.
• Elapsed Time / Duration — A progress indicator showing how far into the current track you are.
• Playlist — The name of the playlist the current song belongs to (if applicable).

Playing Next

When the AutoDJ is active (not during a live broadcast), the next scheduled song is shown below the current track, including its album art, title, artist, and playlist.

Live Broadcast Indicator

When a live DJ is streaming, a Live badge appears with the streamer’s display name instead of the “Playing Next” section.

Listener Count

The panel displays:

• Total Listeners — The total number of active connections across all streams.
• Unique Listeners — The number of distinct listeners (de-duplicated by IP).

Quick Actions

If you have broadcasting permissions, the following action buttons are available:

• Skip Song — Skips the current track and advances to the next one (only available when no live DJ is connected).
• Disconnect Streamer — Disconnects the currently live DJ (only available during a live broadcast).
• Update Metadata — Forces a metadata refresh for the current track.

Schedule

The Schedule panel shows upcoming scheduled events including playlists and streamer/DJ time slots. Each entry displays:

• Type — Either “Playlist” or “Streamer/DJ.”
• Name — The name of the scheduled playlist or streamer.
• Start & End Time — The scheduled time window.
• Time Until — How long until the event starts, or “Now” if it is currently active.

Streams

The Streams panel lists all active audio streams for your station, organized into sections:

Local Streams (Mount Points)

Each mount point shows:

• A Play button to listen directly in the panel.
• The mount point name.
• The stream URL (click to copy or open).
• Total and unique listener counts.

Remote Relays

Each remote relay shows the relay name, URL, and listener counts.

HLS (HTTP Live Streaming)

If HLS is enabled, the HLS stream URL and listener count are displayed.

Playlist Downloads

At the bottom of the Streams panel, you can download your station’s stream URLs as:

• PLS File — A standard playlist file compatible with most media players.
• M3U File — An alternative playlist format.

Public Pages

The Public Pages panel shows whether public pages are enabled or disabled for your station.

When enabled, you will see links to:

• Public Player Page — A web-based player your listeners can use.
• On-Demand Media — If enabled, a page where listeners can browse and play archived media.
• Podcasts — A public podcast listing page.
• Schedule — A public calendar showing your programming schedule.

Available Actions

• Embed Widgets — View embed codes to add the player widget to external websites.
• Edit Branding — Customize the look of your public pages (requires the appropriate permission).
• Enable / Disable — Toggle public pages on or off.

Song Requests

This panel shows whether song requests from listeners are enabled or disabled.

When enabled:

• View — Opens the pending and historical requests.
• Disable — Turns off song requests.

When disabled:

• Enable — Turns on song requests so listeners can request songs through the public player.

Streamers/DJs

This panel shows whether live DJ streaming is enabled or disabled.

When enabled:

• Web DJ — Link to the browser-based DJ interface (if public pages are enabled).
• Manage — Opens the streamer/DJ management page (requires the Streamers permission).
• Disable — Turns off live streaming.

When disabled:

• Enable — Turns on live DJ streaming.

Broadcasting Service

This panel shows the status of the streaming frontend (Icecast or Shoutcast).

Displayed information includes:

• Service Type — Icecast, Shoutcast, or Remote.
• Running Status — A badge indicating whether the service is running or stopped.

Credentials (Broadcasting Permission Required)

Click Show Credentials to reveal connection details:

• Admin Username & Password — For accessing the broadcast server’s admin interface.
• Port — The port number the service is running on.
• Source Credentials — Username and password for source connections.
• Relay Credentials — Username and password for relay connections.

Each credential field has a Copy button for easy copying.

Service Controls

• Restart — Restart the broadcasting service.
• Start — Start the service if it is stopped.
• Stop — Stop the service if it is running.

AutoDJ Service

This panel shows the status of the AutoDJ (Liquidsoap).

• Running Status — A badge indicating whether the AutoDJ is running or stopped.

Service Controls (Broadcasting Permission Required)

• Restart — Restart the AutoDJ.
• Start — Start the AutoDJ if it is stopped.
• Stop — Stop the AutoDJ if it is running.

---

Media Management

The Media section lets you upload, organize, and manage all of your station’s music files. You can access it via the Media > Music Files menu item in the sidebar.

Browsing Music Files

The media browser displays your files in a table with the following columns:

Column	Description
Name	File or folder name with a play button and album art thumbnail
Length	Audio duration (e.g., 3:45)
Size	File size (e.g., 5.2 MB)
Playlists	Which playlists the file belongs to
Actions	Edit and Rename buttons

Optional Columns

You can show or hide additional columns using the field selector:

• Media Title
• Song Artist
• Song Album
• Song Genre
• ISRC Code
• Custom Fields (if configured)
• Uploaded Time
• Last Processed Time

Navigation

• Use the breadcrumb bar at the top to navigate between folders.
• Click a folder name in the table to open it.
• Click any breadcrumb segment to jump back to that folder level.

Storage Quota

The quota indicator in the top-right corner of the media page shows how much storage space has been used and how much is available.

Uploading Media

You can upload audio files directly in the media browser:

1. Navigate to the folder where you want to upload files.
2. Drag and drop audio files onto the upload area, or click the upload area to browse your computer.
3. Files will be uploaded and automatically processed (metadata extracted, waveform generated, etc.).

Supported file types include common audio formats such as MP3, FLAC, OGG, AAC, and WAV.

Editing Song Metadata

Click the Edit button on any media file to open the edit modal. The modal has several tabs:

Basic Information

Field	Description
Song Title	The title of the track
Song Artist	The performing artist
Song Genre	The genre classification
Song Album	The album name
Song Lyrics	Full lyrics text
ISRC	International Standard Recording Code, used for licensing reports

Playlists

Select one or more playlists that should include this song. Check or uncheck the boxes next to each playlist name.

Album Art

• View the current album art.
• Upload a new image to replace the album art.
• Delete Album Art to remove the current image.

Custom Fields

If your station has custom metadata fields configured, they will appear here as additional input fields.

Visual Cue Editor

The waveform editor provides a visual way to set cue and fade points on a track:

• Cue In — The point where playback begins (skips any silence or intro).
• Cue Out — The point where playback ends (cuts off trailing silence or outro).
• Fade In — How long the track takes to fade in from silence.
• Fade Out — How long the track takes to fade out to silence.
• Fade Start Next — The point where the next track should begin overlapping.

Use the Play and Stop buttons to preview the audio. Click the corresponding Set buttons while the playback head is at the desired position, or drag the colored regions on the waveform:

• Blue region — Cue points (start and end of playback)
• Orange region — Fade start next point
• Red regions — Fade in and fade out zones

Advanced

Field	Description
Song Length	Duration of the track (read-only)
Amplify (dB)	Volume adjustment in decibels
Start Next (seconds)	Override when the next song starts playing
Fade-In Time	Override the fade-in duration in seconds
Fade-Out Time	Override the fade-out duration in seconds
Cue-In Point	Override the cue-in point in seconds
Cue-Out Point	Override the cue-out point in seconds

Leave any field blank to use the system default value.

Organizing Files and Folders

Creating a New Folder

1. Click the New Folder button in the media browser toolbar.
2. Enter a name for the folder.
3. Click Create Directory.

Renaming Files or Folders

1. Click the Rename button (pencil icon) next to a file or folder.
2. Enter the new name.
3. Click Rename.

Moving Files

1. Select one or more files using the checkboxes.
2. Click the Move button in the toolbar.
3. In the modal, navigate to the destination folder.
4. Click Move to Directory.

Bulk Actions

Select one or more files using the checkboxes, then use the toolbar to perform bulk actions:

Add to Playlists

1. Click the Playlists dropdown.
2. Check one or more playlists to assign the selected files to.
3. Optionally type a name in the “New Playlist” field to create and assign a new playlist.
4. Click Save.

Other Bulk Actions (via the “More” dropdown)

Action	Description
Queue	Add selected songs to the upcoming play queue
Play Now	Immediately play the selected song (if supported by your station)
Reprocess	Re-analyze and reprocess the selected files
Clear Extra Metadata	Remove fade points, cue points, and other manually set metadata

Delete

Click the Delete button to remove selected files. You will be asked to confirm before deletion.

Special File Views

The Media submenu includes several special views that filter your media library:

Duplicate Songs

Shows files that appear to be duplicates based on their metadata (title and artist). Use this view to identify and clean up redundant files.

Unprocessable Files

Shows files that could not be processed by the system — for example, corrupt files or unsupported formats.

Unassigned Files

Shows media files that are not assigned to any playlist. This helps you find orphaned tracks that may not be playing on air.

SFTP Users

If SFTP uploads are enabled for your station, you can manage SFTP user accounts via Media > SFTP Users.

SFTP provides a fast and reliable way to upload large batches of media files using any SFTP client (e.g., FileZilla, WinSCP).

The SFTP user list shows:

Column	Description
Username	The SFTP login username
Actions	Edit and Delete buttons

Creating an SFTP User

1. Click Add SFTP User.
2. Enter a username and password.
3. Click Save.

Use the provided connection details (server address and port) in your SFTP client to connect and upload files.

Bulk Media Import/Export (CSV)

The Bulk Media Import/Export page allows you to update song metadata in bulk using a CSV file.

Exporting to CSV

1. Click Export Media to CSV.
2. A CSV file will download containing all media metadata.
3. Open the file in a spreadsheet application (ensure UTF-8 encoding).

Importing from CSV

1. Edit the exported CSV file with your changes (update titles, artists, playlist assignments, etc.).
2. Return to the Bulk Media page.
3. Upload the modified CSV file.
4. Click Preview Changes to see a summary of what will be updated.
5. Review the changes in the preview table (old values vs. new values).
6. Click Proceed with Import to apply the changes.

After import, a results table shows which updates succeeded and any errors that occurred.

---

Playlists

Playlists control how and when music is played by the AutoDJ. You can access playlist management via the Playlists menu item in the sidebar.

The playlist page has two views:

• All Playlists — A table listing all playlists with their configuration.
• Schedule View — A calendar view showing when scheduled playlists are active.

Playlist Table

The playlist table displays the following information:

Column	Description
Playlist	Name, description, and status badges
Scheduling	How and when the playlist plays
# Songs	Number of tracks and total duration (click to view in media browser)
Actions	Edit, Delete, and additional actions

Status Badges

Each playlist may display one or more badges:

• Song-based or Remote URL — Indicates the playlist source.
• Jingle Mode — Song metadata is hidden from listeners.
• Sequential — Songs play in a fixed order.
• On-Demand — Included in the on-demand player.
• Scheduled — Has specific scheduled time slots.
• Disabled — The playlist is not active.

Creating a Playlist

Click Add Playlist to open the creation form. The form has three tabs: Basic Info, Schedule, and Advanced.

Basic Info

Field	Description
Playlist Name	A descriptive name for the playlist (required)
Enable	Whether the playlist is active in rotation
Description	Optional notes about the playlist
Source	Choose between “Song-Based” (local files) or “Remote URL”

Song-Based Playlist Options

When the source is set to Song-Based, additional options appear:

Field	Description
Avoid Duplicate Artists/Titles	Prevents the same artist or title from playing back-to-back
Include in On-Demand Player	Makes this playlist’s songs available for on-demand listening
Allow Requests from This Playlist	Lets listeners request songs from this playlist
Hide Metadata from Listeners (Jingle Mode)	Hides song title/artist from now-playing displays — useful for jingles and station IDs

Playlist Types

Choose how the playlist integrates into the rotation:

Type	Description
General Rotation	Songs play as part of the regular rotation. Set a Weight (1–25) — higher weight means the playlist plays more frequently relative to other playlists.
Once per X Songs	One song from this playlist plays every N songs. Set the Number of Songs Between Plays (0–150).
Once per X Minutes	One song from this playlist plays every N minutes. Set the Number of Minutes Between Plays (0–360).
Once per Hour	One song from this playlist plays at a specific minute of each hour. Set the Minute of Hour to Play (0–59).
Advanced	For custom scheduling using advanced AutoDJ rules.

Song Playback Order

Order	Description
Shuffled	The entire playlist is shuffled, then songs play in that shuffled order. Once all songs have played, the playlist is reshuffled.
Random	Each song is selected completely at random (songs may repeat before all have played).
Sequential	Songs play in the exact order you specify (use the Reorder function to set the order).

Remote URL Playlist Options

When the source is set to Remote URL, these options appear instead:

Field	Description
Remote URL	The URL of the remote stream or playlist file
Remote URL Type	Choose from: Icecast/Shoutcast Stream URL, Playlist (M3U/PLS) URL, or Other Remote URL (File, HLS, etc.)
Remote Playback Buffer (seconds)	Buffer size for remote playback (0–120). Shorter values may cause intermittent playback.

Schedule

The Schedule tab lets you define when a playlist is active. By default, a playlist with no schedule plays at all times.

Adding a Schedule Entry

Click Add Schedule Item to add a time slot. Each schedule entry has:

Field	Description
Start Time	When the playlist becomes active
End Time	When the playlist stops playing. If the end time is before the start time, the playlist plays overnight.
Start Date	Optional start date to limit the schedule to a date range
End Date	Optional end date
Loop Once	If checked, the playlist plays through once and stops (instead of looping)
Days of Week	Select specific days (Monday–Sunday). Leave blank to play every day.

Tip: To play a playlist once per day at a specific time, set the start and end time to the same value.

You can add multiple schedule entries to create complex programming schedules.

Advanced Options

The Advanced tab offers additional AutoDJ scheduling controls:

Option	Description
Interrupt other songs to play at scheduled time	The playlist will cut into whatever is currently playing when its scheduled time arrives
Only play one track at scheduled time	Plays a single song from the playlist at the scheduled time, then returns to normal rotation
Merge playlist to play as a single track	All songs in the playlist are treated as one continuous block
Prioritize over listener requests	This playlist takes priority when a listener request conflicts with the schedule

Managing Playlist Contents

Reordering Songs

For playlists with Sequential playback order:

1. Click the More button on a playlist row, then click Reorder.
2. In the reorder modal, drag and drop songs to rearrange them, or use the arrow buttons:
   • Move to Top
   • Move Up
   • Move Down
   • Move to Bottom
3. Use the play button next to each song to preview it.
4. Changes are saved automatically.

Importing from PLS/M3U

You can import songs into a playlist from a PLS or M3U file:

1. Click More > Import from PLS/M3U.
2. Upload a .pls or .m3u file.
3. Click Import.
4. The system will scan the file and match entries against your station’s media library.
5. A results table shows which songs were matched and which had no match.

Note: Media files must already be uploaded to your station before importing. The import matches file paths from the playlist file to existing media.

Viewing the Playback Queue

Click More > Playback Queue to see the remaining songs in the playlist’s internal queue and the order they will be played.

• The queue shows song Title and Artist.
• Click Clear Queue to reset the queue (the playlist will rebuild it).

Emptying a Playlist

Click More > Empty to remove all songs from the playlist without deleting the playlist itself.

Reshuffling a Playlist

Click More > Reshuffle to randomize the current playback order of a shuffled playlist.

Duplicating a Playlist

To create a copy of an existing playlist:

1. Click the More button, then Duplicate.
2. Enter a name for the new playlist (defaults to “[Original Name] – Copy”).
3. Choose what to copy:
   • Copy associated media and folders — Includes all song assignments.
   • Copy scheduled playback times — Includes the schedule configuration.
4. Click Save.

Applying a Playlist to Folders

You can automatically assign a playlist to all media files within specific folders:

1. Click More > Apply to Folders.
2. Select one or more folders from the directory list.
3. Optionally check Create New Playlist for Each Folder to generate separate playlists per folder.
4. Click Apply to Folders.

Exporting Playlists

You can export any playlist as a standard playlist file:

• Export as PLS — Downloads a .pls file.
• Export as M3U — Downloads a .m3u file.

These files can be used in external media players or imported into other stations.

Enabling and Disabling Playlists

Click the More button on a playlist and select Enable or Disable to toggle whether the playlist is included in the AutoDJ rotation. Disabled playlists remain configured but do not play.

---

Podcasts

The Podcasts section lets you create and manage podcasts directly from your station. Podcasts can be published with their own RSS feed and public page, making it easy for listeners to subscribe.

Access podcast management via the Podcasts menu item in the sidebar.

Podcast List

The podcast list shows all your station’s podcasts with the following information:

Column	Description
Art	Podcast artwork thumbnail
Podcast Title	Name of the podcast with status badges and public links
# Episodes	Total number of episodes
Actions	Edit, Delete, and Episodes buttons

Status Badges

• Playlist-Based — Episodes are automatically generated from a playlist.
• Unpublished — The podcast is not publicly visible.
• Explicit — The podcast is marked as containing explicit content.
• Disabled — The podcast is turned off on public pages.

When a podcast is published and enabled, links to the Public Episodes page and RSS Feed are displayed.

Creating a Podcast

Click Add Podcast to open the creation form. The form has several tabs:

Basic Information

Field	Description
Title	The name of your podcast (required)
Website Link	A URL to the podcast’s website or home page
Description	A description of the podcast (required, max 4,000 characters)
Language	The primary language of the podcast (required)
Author	The name of the podcast author or contact person
Email	Contact email address
Categories	One or more podcast categories (required) — used by podcast directories
Enable on Public Pages	Whether the podcast appears on your station’s public podcast page
Contains Explicit Content	Marks the podcast with an explicit content warning in the RSS feed

Source

Choose how episodes are added to the podcast:

Option	Description
Manually Add Episodes	You create and upload each episode individually
Synchronize with Playlist	Episodes are automatically created from a playlist’s media files

When using Synchronize with Playlist:

Field	Description
Select Playlist	Choose which playlist to sync episodes from
Auto-Publish New Episodes	Automatically publish new episodes as they are added to the playlist

Branding

Field	Description
Enable OP3 Analytics	Prefix podcast URLs with OP3 for open podcast analytics tracking
Custom HTML for Public Pages	Add custom HTML content to the podcast’s public page (HTML editor)

Artwork

Upload custom artwork for the podcast. This image is used on the public podcast page and in the RSS feed.

Managing Episodes

Click the Episodes button on a podcast to view and manage its episodes.

Episode List

The episode list shows:

Column	Description
Art	Episode artwork thumbnail
Episode	Title with status badges
Actions	Edit and Delete buttons

Creating an Episode

Click Add Episode to create a new episode:

Field	Description
Title	Episode title (required)
Description	Episode description/show notes
Season Number	Season number (optional, for serialized podcasts)
Episode Number	Episode number (optional)
Explicit	Whether this specific episode contains explicit content
Publish	Whether the episode is publicly visible
Publish Date	When the episode should become available

Media Tab

Upload the audio file for the episode, or select an existing media file from your library.

Artwork Tab

Upload custom artwork for this specific episode (overrides the podcast-level artwork).

Publishing and RSS Feed

Once a podcast is published and enabled:

• A Public Episodes link lets you share the podcast page with listeners.
• An RSS Feed link provides the standard podcast feed URL that listeners can use to subscribe in their preferred podcast app (Apple Podcasts, Spotify, etc.).

The RSS feed automatically includes all published episodes with their metadata, audio files, and artwork.

Deleting a Podcast

Click the Delete button on a podcast row to permanently remove it along with all its episodes. You will be asked to confirm before deletion.

---

Live Streaming

The Live Streaming section lets you create and manage DJ/streamer accounts so that live broadcasters can connect to your station and stream in real time. Access it via Live Streaming > Streamer/DJ Accounts in the sidebar.

Streamer List

The streamer table displays:

Column	Description
Art	Streamer artwork thumbnail
Display Name	The name shown to listeners during live broadcasts
Username	The login username (shown in code format)
Notes	Any internal notes about the streamer
Actions	Edit, Broadcasts, and Delete buttons

A Disabled badge appears next to streamers whose accounts are deactivated.

Creating a Streamer Account

Click Add Streamer to create a new DJ account.

Basic Info

Field	Description
Username	The username for connecting to the stream (required)
Password	The connection password (required when creating a new account)
Display Name	The name displayed on the public player when this DJ is live
Notes	Internal comments, visible only in the management panel
Enabled	Whether this account can log in and stream
Enforce Schedule	If checked, the streamer can only connect during their scheduled time slots

Schedule

You can set specific time slots when this streamer is allowed to broadcast. Schedule entries work the same as playlist schedules:

Field	Description
Start Time	When the streamer’s time slot begins
End Time	When the time slot ends
Start/End Date	Optional date range
Days of Week	Specific days (leave blank for every day)

If Enforce Schedule is enabled on the Basic Info tab, the streamer will be automatically disconnected when their time slot ends.

Artwork

Upload custom artwork for this streamer, displayed on the public player during their live broadcast.

Connection Details

After creating streamer accounts, DJs need the following information to connect using broadcasting software (such as BUTT, Mixxx, or OBS):

Icecast Connection

Setting	Value
Server/Host	Your station’s server URL
Port	The broadcasting port number
Mount Point	The mount point path (e.g., /live)
Username	The streamer’s username
Password	The streamer’s password

Shoutcast Connection

Setting	Value
Server/Host	Your station’s server URL
Port	The broadcasting port number
Password	The streamer’s password (formatted as username:password for Shoutcast)

Tip: Connection details are shown on the streamer management page. Share these with your DJs so they can configure their broadcasting software.

Broadcast History

Click the Broadcasts button on a streamer to view their broadcast history. The broadcasts modal shows:

Column	Description
Download	Play button and download link for the recording (if available)
Start Time	When the broadcast started
End Time	When the broadcast ended, or “Live” if currently streaming
Size	File size of the recording
Actions	Delete recording button

You can delete individual broadcast recordings or use batch operations to remove multiple recordings at once.

Web DJ (Browser-Based Streaming)

The Web DJ feature allows DJs to stream directly from their web browser without needing external software. Access it via Live Streaming > Web DJ in the sidebar, or through the public page link.

Settings Panel

Before connecting, configure:

Setting	Description
Username	The streamer’s username
Password	The streamer’s password
Sample Rate	Audio quality setting (8 kHz to 48 kHz). Higher values mean better quality.
Bit Rate	Audio bitrate (8 kbps to 320 kbps). Higher values mean better quality but more bandwidth.

Click Start Streaming to connect.

While Connected

Once streaming, you can update the track metadata:

Field	Description
Title	The song title to display to listeners
Artist	The artist name to display

Click Update Metadata to push the changes to listeners.

Microphone Panel

• Enable/Disable — Toggle microphone input on and off.
• Volume — Adjust microphone volume with the slider.
• Cue — Monitor the microphone audio locally.
• Source — Select which microphone/input device to use.
• A live volume meter shows the input level.

Playlist Panels (1 & 2)

The Web DJ provides two independent playlist decks:

• Add Files to Playlist — Load audio files from your computer.
• Play / Pause / Stop — Standard playback controls.
• Previous / Next Track — Navigate between loaded tracks.
• Volume — Adjust the deck volume.
• Cue — Monitor the deck audio locally.
• Track Progress — A seekable slider showing the current position.
• Continuous Play — Automatically advance to the next track.
• Loop — Repeat the playlist when it reaches the end.

Mixer

The mixer provides a crossfader between the two playlist decks:

• Slide left to favor Playlist 1.
• Slide right to favor Playlist 2.
• Center position plays both decks at equal volume.
• Right-click the slider to reset it to center.

Disconnecting

Click Stop Streaming to disconnect from the station and end your live broadcast.

Note: The Web DJ requires HTTPS and works best in Firefox for optimal audio quality.

---

Broadcasting

The Broadcasting section covers the technical configuration of how your station delivers audio to listeners. Access these pages through the Broadcasting submenu in the sidebar.

Mount Points

Mount points are the individual audio streams that listeners connect to. Each mount point can have its own audio format and bitrate, allowing you to serve multiple quality levels simultaneously.

Mount Point List

Column	Description
Name	Mount point name with a “Default Mount” badge if applicable
AutoDJ	Whether the AutoDJ feeds this mount, plus the format and bitrate
Actions	Edit and Delete buttons

Creating a Mount Point

Click Add Mount Point to create a new stream endpoint.

Basic Info

Field	Description
Mount Point URL	The URL path for this mount (must start with /, e.g., /radio.mp3) (required)
Display Name	A friendly name (auto-generated from the URL if left blank)
Show on Public Pages	Whether this mount appears on public player widgets
Set as Default	Makes this the primary mount point for the station
Relay Stream URL	Relay another external stream through this mount (optional)
Advertise to Directories	Whether to list this mount on public stream directories
Max Listener Duration	Maximum time (in seconds) a listener can stay connected. Set to 0 for unlimited.

Additional fields depending on your broadcast frontend:

• Shoutcast: Authorization Hash for YP directory.
• Icecast: Fallback Mount path (default: /error.mp3).

AutoDJ

Field	Description
Enable AutoDJ	Whether the AutoDJ sends audio to this mount point
Format	Audio format: MP3, OGG Vorbis, OGG Opus, AAC+ (HE-AAC v2), or FLAC (OGG FLAC)
Bitrate	Audio bitrate in kbps (not applicable for FLAC)

Intro File

Upload an audio file that plays when a listener first connects to this mount point (e.g., a station ID or welcome message).

Note: Adding or removing mount points will trigger a broadcasting service restart.

HLS Streams

HTTP Live Streaming (HLS) provides adaptive-bitrate streaming, which automatically adjusts audio quality based on the listener’s connection speed.

HLS Stream List

Column	Description
Name	Stream name
Format	Audio format (e.g., MP3, AAC)
Bitrate	Bitrate in kbps
Actions	Edit and Delete buttons

Creating an HLS Stream

Click Add HLS Stream and configure:

Field	Description
Stream Name	A name for this HLS variant
Format	Audio format
Bitrate	Audio bitrate in kbps

You can create multiple HLS streams at different bitrates to enable adaptive streaming.

Note: Adding or removing HLS streams will trigger a broadcasting service restart.

Remote Relays

Remote relays allow your station to pull in or push out audio to external streaming servers. This is useful for distributing your stream across multiple servers for better geographic coverage.

Remote Relay List

Column	Description
Name	Relay name (clickable link to the remote URL)
AutoDJ	Whether the AutoDJ broadcasts to this remote, plus format and bitrate
Actions	Edit and Delete buttons

Note: Some relays (auto-discovered) may not be editable.

Creating a Remote Relay

Click Add Remote Relay to configure a new relay:

Basic Info

Field	Description
Remote Station Type	Icecast v2.4+, Shoutcast v1, or Shoutcast v2 (required)
Display Name	A friendly name (auto-generated if blank)
Remote Station URL	The base URL of the remote server (required)
Mount Point / SID	The mount point path (e.g., /radio.mp3) or Shoutcast SID
Admin Password	Password for pulling detailed statistics from the remote server
Show on Public Pages	Whether this relay appears on public player widgets

AutoDJ (Broadcast to Remote)

If you want the AutoDJ to push audio to this remote server:

Field	Description
Enable AutoDJ	Enable broadcasting to this remote station
Format	Audio format (MP3, OGG Vorbis, OGG Opus, AAC+, FLAC)
Bitrate	Audio bitrate in kbps
Source Port	Override the broadcast port (optional)
Source Mount	Override the broadcast mount point (optional)
Source Username	Authentication username for the remote server
Source Password	Authentication password for the remote server
Advertise to Directories	Whether to list this on public stream directories

Custom Fallback File

The fallback file is played when no other audio is available — for example, when no media is scheduled and no DJ is live. It prevents your station from going silent.

Managing the Fallback File

• Upload — Drag and drop or select an audio file to set as the fallback.
• Download — Download the current fallback file.
• Clear File — Remove the fallback file (your station will use the system default).

Tip: Choose a short, loopable audio file such as a station ID or “We’ll be right back” message.

Upcoming Song Queue

The Upcoming Song Queue shows the songs that the AutoDJ has queued to play next.

Queue Table

Column	Description
Actions	Log and Delete buttons
Song Title	The track title and artist
Expected to Play At	The estimated time and relative countdown
Source	“Listener Request” or “Playlist: [name]”

Actions

• Log — View the AutoDJ’s decision log for why this song was selected.
• Delete — Remove a song from the queue (only available if the song hasn’t already been sent to the AutoDJ).
• Clear Upcoming Song Queue — Remove all queued songs at once (requires confirmation).

The queue refreshes automatically every 30 seconds.

Restarting Broadcasting

The Restart Broadcasting page lets you restart all broadcasting services for your station. Use this when you’ve made configuration changes that require a restart, or if you’re experiencing technical issues.

Click Restart to restart the broadcasting frontend (Icecast/Shoutcast) and the AutoDJ (Liquidsoap) together.

---

Reports & Analytics

The Reports section provides detailed analytics and statistics about your station’s performance, listeners, and playback history. Access reports via the Reports submenu in the sidebar.

Station Statistics

The Station Statistics page is the main analytics dashboard. Select a date range using the date picker in the top-right corner to filter all data.

The page is organized into the following tabs:

Best & Worst

Shows three tables:

• Best Performing Songs — Songs that gained the most listeners during the selected period. Each entry shows the song title, artist, and a trend indicator (green arrow up).
• Worst Performing Songs — Songs that lost the most listeners. Each entry shows a decline indicator (red arrow down).
• Most Played Songs — Songs with the highest play count during the period.

Listeners by Time Period

Provides visual charts showing listener trends:

• Toggle: Switch between “Average Listeners” and “Unique Listeners.”
• Daily Listeners Chart — A time-series graph showing listener counts for each day in the selected range.
• Day of Week Chart — A pie chart showing how listeners are distributed across days of the week.
• Listeners by Hour — A chart showing listener counts by hour of the day. Use the day selector to filter by a specific day of the week or view all days combined.

Listening Time

Shows how long listeners stay connected to your station:

• Pie Chart — Visual breakdown of listener distribution by session duration.
• Data Table — Detailed listing of time brackets (e.g., “0–5 minutes,” “5–15 minutes”) with the number of listeners in each bracket.

Streams

Shows performance by stream/mount point:

• Top Streams by Listeners — Which streams have the most listeners.
• Top Streams by Connected Time — Which streams have the longest total listening time.
• Includes pie charts and a data table.

Clients

(Available with full analytics enabled)

Shows which media players and devices listeners use:

• Top clients by listener count and connection time.
• Pie chart and data table.

Browsers

(Available with full analytics enabled)

Shows which web browsers listeners use:

• Top browsers by listener count and connection time.
• Pie chart and data table.

Countries

(Available with full analytics enabled)

Shows where your listeners are located:

• Top countries by listener count and connection time.
• Pie chart and data table.

Listeners

The Listeners page provides real-time and historical data about who is connected to your station.

Live Listeners Tab

Shows all currently connected listeners, refreshed automatically every 15 seconds.

Listener History Tab

Select a date range to view historical listener data.

Summary Statistics

• Unique Listeners — The total number of distinct listeners in the selected period.
• Total Listener Hours — The combined listening time across all listeners.

Filters

Narrow down the listener list using:

Filter	Description
Min. Connected Time	Only show listeners connected for at least this many seconds
Max. Connected Time	Only show listeners connected for no more than this many seconds
Listener Type	All Types, Mobile, Desktop, or Bot/Crawler

Click Clear Filters to reset.

Listener Table

Column	Description
IP Address	The listener’s IP address
Connected Time	Duration of the connection (HH:MM:SS)
Start Time	When the listener connected (in station timezone)
End Time	When the listener disconnected (in station timezone)
User Agent	The listener’s browser/player with a device type icon (desktop, mobile, or bot)
Stream	Which mount point the listener is connected to
Location	Country, region, and city (derived from IP geolocation)

Additional columns (connected time in seconds, etc.) can be shown or hidden using the field selector.

Listener Map

An interactive map displays listener locations with pins. Hovering over a pin shows the listener’s IP, location, connection time, and user agent.

Note: The map is automatically hidden when there are more than 3,000 listeners for performance reasons.

Export

Click Download CSV to export the listener data as a CSV file for further analysis.

Song Playback Timeline

The Song Playback Timeline shows a chronological log of every song played on your station.

Select a date range to filter the results.

Timeline Table

Column	Description
Date/Time (Station)	When the song played (station timezone)
Listeners	Number of listeners at the start of the song
Change	Listener count change during the song (green up arrow for gains, red down arrow for losses)
Song Title	The track title and artist
Source	How the song was selected: “Listener Request,” “Playlist: [name],” “Live Streamer: [name],” or blank for auto-rotation

An additional column for browser timezone can be enabled via the field selector.

Export

Click Download CSV to export the timeline data.

Song Requests

The Song Requests report shows all listener song requests.

Note: This page only appears if song requests are enabled for your station.

Pending Requests Tab

Lists all requests that haven’t been played yet:

Column	Description
Date Requested	When the listener submitted the request
Date Played	“Not Played” for pending requests
Song Title	The requested track
Requester IP	The IP address of the requester
Actions	Delete button

Click Clear Pending Requests to remove all pending requests at once.

Request History Tab

Shows all previously fulfilled requests with the same columns, including the date and time the song was played.

SoundExchange Royalties

The SoundExchange Royalties page generates compliance reports required for digital performance royalty payments (applicable for stations broadcasting in the United States).

Report Settings

Field	Description
Start Date	Beginning of the reporting period (defaults to first day of the previous month)
End Date	End of the reporting period (defaults to last day of the previous month)
Attempt to Automatically Retrieve ISRC When Missing	Connects to MusicBrainz to look up missing ISRC codes. Disabling this may improve report generation speed.

Important Notes

• The report assumes Category A transmission type.
• ATP (Actual Total Performances) are tracked automatically.
• Each song must have either an ISRC code or both an Album and Label for the report to be complete.
• You can look up ISRC codes manually using the MusicBrainz ISRC search tool.

Generating the Report

1. Set the date range.
2. Optionally enable automatic ISRC lookup.
3. Click Generate Report.
4. The report opens in a new browser tab, ready for download or submission.

---

Webhooks & Integrations

Webhooks let your station automatically send notifications and data to external services when specific events occur (such as a song change or a DJ going live). Access webhook management via the Web Hooks menu item in the sidebar.

Webhook List

The webhook table displays:

Column	Description
Name/Type	The webhook name and its type
Triggers	Which events trigger this webhook
Actions	Edit, Enable/Disable, Test, Duplicate, and Delete buttons

A Disabled badge appears next to inactive webhooks.

Creating a Webhook

Click Add Web Hook to create a new integration.

Step 1: Select Type

Choose the type of webhook you want to create:

Type	Description
Generic Web Hook	Send a custom HTTP POST request to any URL
Email	Send an email notification
TuneIn	Update your TuneIn AIR listing
Radio.de	Update your Radio.de listing
RadioReg	Update your RadioReg listing
GetMeRadio	Update your GetMeRadio listing
Discord	Post a rich embed message to a Discord channel
Telegram	Send a message to a Telegram chat
GroupMe	Post to a GroupMe group
Mastodon	Post a status to a Mastodon account
Bluesky	Post to a Bluesky account
Google Analytics V4	Send events to Google Analytics 4
Matomo Analytics	Send events to a Matomo analytics instance

Step 2: Configure the Webhook

After selecting a type, configure the webhook settings across the available tabs.

Basic Info (All Types)

Field	Description
Webhook Name	A descriptive name for identification (required)
Triggers	Select one or more events that fire this webhook
Rate Limit	Throttle how often the webhook fires (No Limit, 15s, 30s, 1m, 2m, 5m, 10m, 15m, 30m, 1h, up to 12h)

Available Triggers

Depending on the webhook type, the following triggers may be available:

Trigger	Description
Song Changed	A new song begins playing via the AutoDJ
Song Changed (Live DJ)	A live DJ changes the currently playing song
Live DJ Connected	A live DJ starts broadcasting
Live DJ Disconnected	A live DJ stops broadcasting
Station Online	The station starts broadcasting
Station Offline	The station stops broadcasting

Webhook Type Configuration

Each webhook type has its own configuration fields:

Generic Web Hook

Field	Description
Webhook URL	The endpoint URL to send POST requests to (required)
Basic Auth Username	HTTP Basic Authentication username (optional)
Basic Auth Password	HTTP Basic Authentication password (optional)
Timeout	Request timeout in seconds, 0–600 (optional)

Discord

Field	Description
Webhook URL	Your Discord webhook URL (create one in Discord channel settings)
Message Content	Text content above the embed
Title	Embed title (typically the song title)
Description	Embed description (typically the artist)
URL	Link URL in the embed (typically your stream URL)
Author	Author field (typically the streamer name)
Thumbnail	Thumbnail image URL (typically the album art URL)
Footer	Footer text
Color	Embed accent color (hex code, e.g., #FF0000)
Include Timestamp	Add a timestamp to the embed

Email

Field	Description
To Address	Recipient email address
Subject	Email subject line
Message	Email body content

Telegram

Field	Description
Bot Token	Your Telegram bot token (from BotFather)
Chat ID	The target chat, group, or channel ID
API URL	Telegram API URL (usually left as default)
Message Text	The message template
Parse Mode	Formatting mode: Markdown or HTML

Mastodon

Field	Description
Instance URL	Your Mastodon instance URL (e.g., https://mastodon.social)
Access Token	API access token (generate in Mastodon settings)
Visibility	Post visibility: Public, Unlisted, Private, or Direct

Bluesky

Field	Description
Handle	Your Bluesky handle
App Password	An app password (generate in Bluesky settings)

TuneIn

Field	Description
Station ID	Your TuneIn station ID
Partner ID	Your TuneIn partner ID
Partner Key	Your TuneIn partner API key

Google Analytics V4

Field	Description
API Secret	Your GA4 measurement protocol API secret
Measurement ID	Your GA4 measurement ID (e.g., G-XXXXXXXXXX)

Matomo Analytics

Field	Description
Matomo URL	Your Matomo instance URL
Site ID	The Matomo site ID
Token	Your Matomo authentication token

Testing a Webhook

Click the Test button on any webhook to send a test payload. After the test fires, a log is displayed showing the request and response details. Use this to verify your webhook is configured correctly before relying on it in production.

Enabling and Disabling Webhooks

Click the Enable/Disable toggle on a webhook to turn it on or off without deleting it. Disabled webhooks retain their configuration but do not fire.

Duplicating a Webhook

Click the Duplicate button to create a copy of an existing webhook. This is useful when you want to create a similar webhook with minor changes.

Deleting a Webhook

Click Delete to permanently remove a webhook. You will be asked to confirm before deletion.

---

Station Settings & Branding

The station settings and branding pages let you configure your station’s identity, behavior, and public appearance.

Station Settings

Access station settings via the Station Settings menu item in the sidebar. This page contains the full configuration form for your station.

Key settings you can configure include:

General Information

Field	Description
Station Name	The name of your station as displayed to listeners
Station Description	A short description of your station
Station Genre	The genre(s) your station plays
Station URL	Your station’s website URL
Time Zone	The timezone used for scheduling and display throughout the station

Public Pages

Field	Description
Enable Public Pages	Toggle whether public player, schedule, and podcast pages are accessible
Enable On-Demand Listening	Allow listeners to browse and play archived media on demand
Enable Song Requests	Allow listeners to request songs through the public player

Song Request Settings

Field	Description
Request Delay	Minimum time (in minutes) between requests from the same listener
Request Threshold	Minimum time (in minutes) before the same song can be requested again

AutoDJ Settings

Field	Description
AutoDJ Crossfade Duration	Duration (in seconds) of the crossfade between songs
Enable Manual AutoDJ Mode	Allows advanced manual control of the AutoDJ scheduling

Note: Some advanced settings may only be visible depending on your station’s backend configuration and enabled features.

After making changes, click Save Changes. The station will reload to apply the new configuration.

Station Branding

Access branding settings via Public Pages > Branding in the sidebar.

Custom Assets

Upload custom images used across your station’s public pages:

Public Page Background

Upload a custom background image for your station’s public-facing pages. This image appears behind the player and other public page content.

• Drag and drop an image file, or click to browse.
• The current background is shown as a preview.

Default Album Art

Upload a custom image to use as the default album art when a song has no artwork of its own.

• Drag and drop an image file, or click to browse.
• The current default art is shown as a preview.

Branding Settings

Field	Description
Station Offline Display Text	Custom text shown to listeners when your station is offline. Leave blank to use the default “Station Offline” message.
Default Album Art URL	A URL to an image used as fallback album art. Leave blank to use the standard placeholder.
Custom CSS for Public Pages	Add custom CSS styles that will be applied to all public-facing pages. Use this to customize colors, fonts, layouts, and other visual elements.
Custom JS for Public Pages	Add custom JavaScript that will be executed on all public-facing pages. Use this for analytics, custom interactions, or third-party integrations.

The CSS and JavaScript fields use a code editor with syntax highlighting.

Click Save Changes to apply your branding updates. Changes take effect immediately on public pages.

---

Public Pages

Your station can have several public-facing pages that listeners access directly. These pages do not require a login and are designed for your audience.

Note: Public pages must be enabled in your station settings for listeners to access them.

Public Player

The public player is an embeddable web-based audio player that lets listeners tune in directly from their browser.

Player Features

• Album Art — Displays the currently playing song’s artwork.
• Song Title & Artist — Shows what’s currently playing.
• Live Badge — When a live DJ is broadcasting, a “Live” badge appears with the streamer’s name.
• Station Offline Message — Displays when the station is not broadcasting.
• Track Progress — A progress bar showing elapsed time and total track duration.
• Play Button — A large, centered play/pause control.
• Stream Selector — If your station has multiple mount points or streams, listeners can choose which one to listen to from a dropdown menu.
• Volume Controls — A mute/unmute button and volume slider.
• Popup Player — A button to open the player in a floating popup window.

Embedding the Player

The public player can be embedded on external websites using an iframe. To get the embed code:

1. Go to your station’s Overview page.
2. Click Embed Widgets in the Public Pages panel.
3. Copy the provided embed code and paste it into your website’s HTML.

Full Player Page

The full player page is a standalone web page with the complete player experience. It includes:

• Station Name — Displayed as a heading at the top.
• Radio Player — The full audio player with all controls.
• Song History — A button to view recently played songs (opens a modal with album art, titles, and artists).
• Request Song — A button to submit a song request (if requests are enabled).
• Download Playlist — A button to download the station’s stream as a PLS/M3U file for use in external players.

Song History Modal

The song history shows a list of recently played tracks, including:

• Album art thumbnail
• Song title
• Artist name

Song Request Modal

When song requests are enabled, listeners can:

1. Click the Request Song button.
2. Browse or search through available songs.
3. Click Request next to the desired song.
4. A confirmation message appears when the request is submitted.

The request list shows:

• Album art thumbnail
• Song title and artist
• Album, genre, and custom fields (optional columns)

Schedule Page

The schedule page shows a calendar view of your station’s programming schedule.

• Displays scheduled playlists and streamer/DJ time slots.
• Events are color-coded for easy identification.
• All times are shown in the station’s configured timezone.
• Listeners can navigate between days, weeks, or months to see upcoming programming.

On-Demand Media

When on-demand listening is enabled, listeners can browse your media library and play individual tracks at any time.

On-Demand Page Features

• Inline Player — A mini player in the top-right corner for playback.
• Media Table — A searchable, sortable table of available tracks.

Table Columns

Column	Description
Play	Button to play the track
Album Art	Track artwork thumbnail
Title	Song title (sortable)
Artist	Song artist (sortable)
Album	Song album (optional, hidden by default)
Download	Download button (if enabled)

Additional custom field columns can be shown via the field selector.

Note: Only songs from playlists with “Include in On-Demand Player” enabled will appear here.

Song Requests Page

The standalone song requests page allows listeners to request songs without using the full player:

• Search — Listeners can search for songs by title, artist, album, or genre.
• Browse — Paginated table of all requestable songs.
• Request Button — Submit a request for any available song.

Table Columns

Column	Description
Song Name	Album art, title, and artist
Title	Song title (optional, sortable)
Artist	Song artist (optional, sortable)
Album	Song album (optional)
Genre	Song genre (optional)
Actions	Request button

After a request is submitted, a success notification confirms that it was received. Request limits (cooldown periods) are enforced as configured in your station settings.

---

My Account

The My Account page lets you manage your personal profile, security settings, and API keys. Access it from the user menu in the top-right corner of the dashboard.

Profile Overview

Your account page displays:

• Avatar — Your profile picture (pulled from linked services if available).
• Name — Your display name.
• Email — Your account email address.
• Roles — Badges showing the roles assigned to your account.

Editing Your Profile

Click Edit Profile to open the profile editor.

Available Fields

Field	Description
Name	Your display name
Show 24-Hour Time	Toggle between 12-hour (AM/PM) and 24-hour time format throughout the panel
Language	Choose your preferred language, or select “Use Browser Default” to match your browser’s language setting

Click Save to apply your changes.

Security

Two-Factor Authentication (2FA)

Two-factor authentication adds an extra layer of security to your account. When enabled, you’ll need to enter a code from your authenticator app each time you log in.

Enabling 2FA

1. Click Enable Two-Factor in the Security section.
2. A QR code will be displayed.
3. Scan the QR code with your authenticator app (e.g., Google Authenticator, Authy, 1Password).
4. Enter the verification code from the app to confirm setup.

Disabling 2FA

Click Disable Two-Factor to turn off two-factor authentication. You may be asked to confirm this action.

Important: It is strongly recommended to keep two-factor authentication enabled to protect your account.

Passkeys

Passkeys provide a passwordless, phishing-resistant login method using your device’s biometric sensor (fingerprint, face recognition) or security key.

Adding a Passkey

1. Click Add New Passkey.
2. Follow your browser’s prompts to register a passkey using your device.
3. Enter a nickname for the passkey (e.g., “Work Laptop” or “YubiKey”) so you can identify it later.

Managing Passkeys

The passkey table shows:

Column	Description
Passkey Nickname	The name you assigned to the passkey
Actions	Delete button

Click Delete to remove a passkey. You will be asked to confirm before deletion.

API Keys

API keys allow external applications and scripts to interact with the streaming panel on your behalf.

Viewing API Keys

The API Keys table shows:

Column	Description
Description	The comment/description you assigned to the key
Actions	Delete button

Creating an API Key

1. Click Add API Key.
2. Enter a description (e.g., “Mobile App” or “Automation Script”).
3. Click Create.
4. Copy the API key immediately — it will only be shown once and cannot be retrieved later.

Deleting an API Key

Click Delete next to any API key to revoke it. The key will immediately stop working for any applications using it.

Tip: Create separate API keys for different applications so you can revoke access individually without affecting other integrations.