Global Music Library (GML)

Concepts and Description

The Global Music Library (GML) is a BoomBox exclusive add-on which supplies station operators with an extensive library of fully licensed music content for exclusive use within the SoniXCast Broadcast Network (SBN).

In cooperation with all major labels, SoniXCast regularly receives music content (a.k.a. Musters) which after normalization and processing is made available to station operators for use when generating their own programming schedules.

The Global Music Library can be found in the BoomBox file manager tool under the folder ‘GML’. Audio files are organized according to Genre/Mood and station operators can simply select, drag and drop (or copy and paste) individual tracks into their own playlist folders in the file manager.

Station operators cannot delete, rename or move tracks in the GML, however once copied into local playlist folders, operators may manipulate the individual tracks like any other uploaded track. Read Requirements and Restriction for more information.

Encoding and Normalization

All tracks are encoded as Moving Picture Experts Group Layer-3 (mp3) files at a constant bitrate (CBR) of 256Kbps, frequency of 44100KHz with Joint Stereo channel polyphonic phase correction which is the most compatible industry standard for use with SoniXCast systems. Each track has replaygain parameters preset to ensure constant and reliable volume leveling and smooth crossover during playback.

Song metadata is encoded as id3v2 frames within each track and is normalized and cross referenced with the iTunes music library for maximum accuracy and compatibility during playback. Each track has at least the Artist, Title and Genre as well as Album, Track Number and Duration parameters for compatibility with older flash-based players.

Each track is watermarked with the SoniXCast digital signature and encoded with an audio overlay that will repeat for the entire duration if playback occurs over non-SoniXCast systems. The audio watermark is disabled (cannot be heard) during playback through SoniXCast stream servers.

Restrictions and Requirements

All tracks within the GML are licensed for rebroadcast over SoniXCast Broadcasting Network only and are exclusively available in BoomBox. BoomBox Trial Accounts and CentovaCast DO NOT have access to the GML.

Station operators are authorized to copy GML tracks into their playlists folders using the BoomBox file manager only. DO NOT DOWNLOAD AUDIO FILES TO YOUR LOCAL SYSTEM AS THAT WOULD VIOLATE THE LICENSE AGREEMENT CAUSING YOU CONSIDERABLE RISK. WHICH MAY INCLUDE, BUT IS NOT LIMITED TO, FINES AND INCARCERATION.

Each audio file is digitally signed and traceable by law enforcement. In addition each copy operation made by each station operator is logged in order to comply with licensing requirements.

The station operator is personally liable for the responsible handling of audio files once they have been copied into their playlist folders regardless of who is ultimately found in possession of the audio file. It is imperative that station operators comply with GML usage restrictions and requirements.

Terms and Nomenclature

  • Global Music Library (GML): A repository of audio files made available to operators of the BoomBox radio automation platform and licensed for exclusive broadcast over the SoniXCast Broadcast Network.
  • SoniXCast Broadcast Network (SBN): A logical grouping of systems both Terrestrial and Internet based which broadcast content for consumer consumption over platforms like iHeartRadio (Clear Channel) Sony and iTunes.
  • Track (Audio File): A digital audio file that can be streamed through SoniXCast systems for consumer consumption.

Frequently Asked Questions

I have a 320Kbps streaming package. Will audio quality suffer when using GML tracks?

I shouldn’t. All tracks are encoded at the maximum quality that can be appreciated by the majority of listeners. Some Audiophiles may be able to hear the difference between an audio file encoded at 320kbps and a GML track, however, the majority of the listener population will not. GML tracks are used for professional broadcast by terrestrial radio stations, so it should be good enough for Webcasting as well.

AutoDJ Manager

The AutoDJ service (otherwise known as a transcoder) provides professional grade programming (Playlist) and broadcast user (DJ) management. Producers can schedule Daily programming, Spots and Jingles as well as allowing broadcast users access to override regular programming to broadcast live. The AutoDJ settings page in BoomBox (top menu, microphone icon) gives Producers the option to make global configuration changes that affect all Playlists and DJ’s.

Configuration Settings:

Important: It is imperative that you enter accurate values for name, genre, homepage, facebook, twitter and google+ as this metadata is what will allow your station to be found on 3rd party aggregators like iTunes, Amazon Music and Roku.

  • Enabled: Completely enable or disable the AutoDJ
  • Name: the name of your radio station
  • Genre: the genre of your radio station
  • Homepage: the website url (homepage) of your radio station
  • Facebook: the facebook page of your radio station
  • Twitter: the twitter page of your radio station
  • Google+: the google+ page of your radio station
  • DJ Port: This is the port to be used in the source client for live broadcasting
  • Encoder: Set the encoder (MP3 or AAC+) you would like to use for playback
  • Channels: This will set your stream to broadcast in Mono or Stereo
  • Shuffle: globally enables or disables the random playback of tracks. This will override individual playlist shuffle settings, so you should disable it unless desired
  • Normalize: normalizes (compresses) the output volume sent to the stream server so that your Playlists and DJ’s all have the same loudness when broadcasting
  • Source Protocol: Choose which protocol you would like to use for source client connections
    • Version 1: is the most compatible, but does not supply extended track metadata for modern players and devices
    • Version 2: is for modern players and devices, but will not work with flash players.
  • Bitrate: sets the total output quality sent to the stream server. (Important) this value must equal that of your broadcasting software (source client) in order to avoid drops when connecting for live broadcasting
  • Crossfade: Crossfade sets the total time with which the volume will be faded between tracks
  • Threshold: sets the curve in seconds the volume crossfade will be applied to each track

Menu Options

To the left of the top of the page next to the ‘Save’ (floppy icon) and ‘Help’ (question icon) buttons is a pull out menu which offers additional AutoDJ features and options. In addition to the standard option (Save and Help) the following operations are provided:

Service Management Options:

From time to time you may need to test service operation. These operations will help.

  • Restart: stops and restarts the service
  • Start: starts the service (is ignored if already running)
  • Stop: stops the service (is ignored if not running or disabled)

Playlist Management Options

These operations apply to all enabled playlists and may crash the service if Playlists or DJ’s are not properly configured. Use with caution.

  • Reload Current Playlist: flushes and re-reads the playlist cache (restarts the playlist from the beginning)
  • Toggle Shuffle: enables or disables global track playback randomization
  • Skip to Next Track: forces the playback of the next track in the playlist queue
  • Rotate Log Files: instructs the system to save the current log file under a different name and to begin logging anew

Demo Options

We provide an extensive demo framework that is updated when new features are added. Installing the demo will setup and configure DJ’s and Playlists that will allow producers to quickly understand how the AutoDJ feature works. Installation and De-installation will not affect your current setup or configuration, but may override priorities.

  • Install Demo: installs the demonstration framework
  • Uninstall Demo: uninstalls the demonstration framework

 

Server Manager

Concepts and Description

BoomBox employs the latest hybrid build of ShoutCast Server 2.5.5 as the primary streaming platform. ShoutCast was chosen for its widespread use, acceptance and backwards compatibility with the ShoutCast.com yellow pages (YP) service. The SoniXCast ShoutCast streaming service is built with custom extensions which enables seamless integration into the Global Relay Network (based upon Icecast) to facilitate maximum compatibility with popular streaming platforms, players and devices.

Configuration Settings:

  • Admin Password (Required): This password is required for gaining access to the media server administration control panel.
  • Source Password (Required): This password is required for broadcasting directly to the media server.
  • Adaptive Buffer (Recommended): By enabling AnyCastIP™ adaptive buffering, your listeners will be able to tune in faster, at higher quality and with more reliability. You should only disable this feature if you are having trouble listening with some older flash players.
  • Name Lookups (Not Recommended): Performs a reverse DNS hostname lookup based upon the ip-address of the connecting listener (shows hostname instead of ip-address in the connection log). Enabling the feature could slow down the time in which a listener will be able to hear your stream by as much as 30 seconds.
  • Source Port: This is the port to be set in the connection settings of your source client (broadcast software) when broadcasting in ‘Server Direct’ mode
  • Redirect Port: This is the port used by the AnyCastIP™ Global Redirector to point listeners to your stream
  • Mount Point: This is the mount point used by the AnyCastIP™ Global Relay Network to point listeners to your stream
  • Authorization Hash (Optional): The authorization hash is required only if you wish your stream to be displayed at shoutcast.com (you must register first).

Menu Options

To the left of the top of the page next to the ‘Save’ (floppy icon) and ‘Help’ (question icon) buttons is a pull out menu which offers additional AutoDJ features and options. In addition to the standard option (Save and Help) the following operations are provided:

  • Restart: stops and restarts the service
  • Start: starts the service (is ignored if already running)
  • Stop: stops the service (is ignored if not running or disabled)
  • Kick Broadcast Source: removes the current source be it a DJ or AutoDJ from the stream server
  • Rotate Log Files: instructs the system to save the current log file under a different name and to begin logging anew

API

[revision 20171203] This documentation is under constant development and you are encouraged to check often for updates.

The BoomBox API (v.2.4) provides a REST programmers interface to the BoomBox core system. Publically exposed interface calls can be found and tested at https://api.sonixcast.com/test.html. Data responses are in the JSON data format decorated with a request and response section.

The request section contains information about the request including relevant server and performance data.

The response section contains the response data queried in the request section.

Jquery request example:

$.getJSON("https://api.sonixcast.com/Server/Status/?licenseKey=3A62904B6B0A52FF5C1F8A84C905F3D1", function(data) {
myElement.val(data);
});

JSON response example

{
"request": {
"origin": null,
"class": "Server",
"function": "Status",
"method": "GET",
"parameters": {
"licenseKey": "3A62904B6B0A52FF5C1F8A84C905F3D1",
"uid": "testAccount",
"hostname": "cabhsdev.sonixcast.com"
},
"timestamp": "2017-03-12T12:50:20+00:00"
},
"response": {
"online": 1,
"uptime": {
"etime": "23:41:44",
"humanreadable": "0 Days, 23 Hours, 41 Minutes, 44 Seconds"
},
"uptimeLong": "0 Days, 23 Hours, 41 Minutes, 44 Seconds",
"restartRequired": 0,
"version": "2.4.7.256 (posix(linux x86))",
"listed": 0
}
}

Playlist Manager

Playlist-Manager Version 3.1sc allows producers to setup and manage music playlists and injectable jingles or spots into programmed or live playback.

Table View

The table provides overview and basic management of all users on the systems. To add a user, click on  ‘Add Playlist’ icon and you will be redirected to the “Create Playlist” Form. The help icon refers to this manual.

Table View Fields

  • Name: The name or alias of the Playlist
  • Folder: The directory (ordered under the Music folder in the Finder file manager) from which music tracks will be played.
  • Priority: Provides a dropdown for determining the broadcast priority of the selected playlist over other playlists. Important: All Playlist’s must be prioritized lower than DJ’s in order to give DJ’s live broadcasting precedence.
  • Recurrence: Provides a dropdown of scheduling schemas in which the Playlist will broadcast (further scheduling options can be found on the Playlist Editor Form).
  • Actions Toolbar: (to the right of each playlist) Provides advanced playlist management features (more below).

Actions Toolbar

  • Enable: (on/off switch icon) Enable or disable playlist playback.
  • Edit: (user-pencil icon) Opens the Playlist Editor Form.
  • Delete: (user-minus icon [Red]) Deletes a Playlist.

Playlist Editor Form

The Playlist Editor Form allows for more advanced configuration and scheduling of the Playlist.

Playlist Field Descriptions:

  • Name [Required]: Enter a useful display name or alias for the playlist (i.e. My Music, Super Playlist). This is useful for the Playlist profile page on SoniXFM.com. Spaces and special characters are allowed.
  • Folder [Required (Disabled when creating a new playlist)]:The directory (ordered under the Music folder in the Finder file manager) from which music tracks will be played.
  • Shuffle [Optional]: Enables random track shuffling during playback.
  • Repeat [Optional]: Restarts the playlist from the beginning once the end has been reached.
  • Profile: Enter Playlist profile information for display on your SoniXFM.com Station Page (HTML allowed).

Advanced Scheduling Field Descriptions

All advanced event scheduling options are in Server Time (UTC/GMT). Refer to the time utility to translate your local time to server time.

  • Recurrence [Required]: Provides a dropdown of scheduling schemas in which the Playlist will broadcast.
  • Priority [Required]:
  • Provides a dropdown for determining the broadcast priority of the selected playlist over other playlists. Important: All Playlist’s must be prioritized lower than DJ’s in order to give DJ’s live broadcasting precedence.
  • Date Range: Determines the start and end date in which the Playlist will broadcast. Optional: Click the calendar icon next to each field to display the date chooser
  • Start Time: Determines the time in hour:minutes:seconds format for which the Playlist will broadcast. Optional: Click the associated stopwatch icon to display the time chooser.
  • Time Offset: Determines the time in hour:minutes:seconds format for which the Playlist will broadcast. Optional: Click the associated stopwatch icon to display the time chooser
  • Duration: Determines how long in hour:minutes:seconds format for which the Playlist will broadcast. Optional: Click the associated stopwatch icon to display the time chooser

Local Time Conversion

Events are triggered on the server based upon Server Time (UTC). To aid in calculating UTC from your local (computer) time we have provided a clock which displays the current server and local time and timezone offset which can be switched between 24 hour or am/pm format. Using basic math one can calculate the time difference by adding or subtracting the offset value or use the convenient time zone conversion utility (clock icon).

Example:

Spot Injecting Example: Use the following settings to inject a short spot to run all day, every day, every 5 minutes:

  1. Enter a Name for the playlist (i.e. ‘My Playlist’)
  2. Select ‘No’ for the Shuffle setting
  3. Select ‘No’ for the Repeat setting
  4. Set Permissions to “Time Periodic”
  5. Set Start Time to “00:00:00” (tells the scheduler to start at midnight UTC)
  6. Set Duration to “00:05:00” (tells the scheduler to repeat every 5 minutes)

BoomBox v3.3

bb33_home

BoomBox is the code name for our cutting edge Radio Automation Control Panel for Professional and Terrestrial Radio Stations. Designed from the ground up to run on any device that can connect to the Internet, BoomBox manages all aspects of Station Automation, Reporting and Popularization.

Highlights

Smart

BoomBox is intuitive, self-healing and maintains all technical aspects of your streaming service automatically.

Simple

BoomBox packs easily understandable demographics and statistics information right on the dashboard page.

Secure

SoniXCast’s globally recognized and respected broadcast license will ensure you are broadcasting legally at all times.

BoomBox is much more than just a Control Panel

BoomBox is True Professional Radio Automation which features User and Program Management, Popularization, Reporting, Global Licensing and more…

Intuitively Ergonomic

BoomBox’s beautiful high contrast layout is designed for use in low light broadcasting booths and live concert settings which also makes it easy to use on mobile devices even in full daylight. Our New adaptive architecture optimizes reading comfort and is accessible reader ready.

Industry standard icons ensures the UI is clean and organized, but usage remains highly intuitive. Tooltips give detailed information, so with little learning curve anyone can be a Power User.

Build your Listener Base

BoomBox makes sure that your station can be found (and heard) on a variety of 3rd party platforms including Sony (i.e. Playstation), Apple (i.e. iTunes, iPod, iPad), Microsoft (i.e. WMC, XBox), Google (i.e. Play, Chromecast), iHeartRadio (NBC, CBS, Nobex, TuneIn et al), Roku and many more…

SoniXFM™ is a media content aggregation and popularization platform developed in 2009 in conjunction with Sony Interactive which serves as the backbone for music services like Amazon, iTunes and Google Play.

Extensive Music Library

Save programming time and effort by plugging in music from our library of tracks and soundbytes in just about every language, genre or mood ranging from the 1930s jazz to the current popular hits.

We receive musters from all major labels on a regular basis which are normalized and encoded to the highest listening standards and made available in BoomBox. With a simple drag and drop, they can be added to any playlist.

True Radio Automation

Much of the administrative drudgery found in other applications is completely automated in BoomBox. But don’t be fooled by its simplicity, BoomBox is full fledged radio automation with features professionals want and need.

BoomBox is self healing and watches services to make sure they are available at all times. Day or Night. Settings are tested against known working values all but eliminating possible configuration mistakes.

Familiar File Management

BoomBox’s file manager is designed to work like those found on Windows or Macs with features you already know. You can also download backups or log files directly to your computer for peace of mind and extra security.

Update your playlists by selecting and deleting tracks or dragging files from your computer (or the BoomBox music library) right into playlist folders. Changes are picked up immediately by the AutoDJ without drop-outs or restarting

Worldwide Broadcast Network

Each BoomBox station has a unique registered callsign (CSNX-XXXX) in the world’s largest radio broadcasting network made up of an estimated 400,000 terrestrial and internet radio stations with an estimated 42 million daily listener reach.

BoomBox stations are everywhere to be found thanks to our patented AnyCastIP™ network which includes port 80 proxying for listening through corporate firewalls and direct port access for use with third party software and tools.

Dashboard

The Dashboard menu option gives the operator quick and intuitive access to all common Station Operations, Information and Statistics [more: Dashboard Section]

Panic Button Feature

The panic button (heartbeat icon, upper right menu) feature executes repair routines that will fix issues most commonly reported by producers. Here is a list of repair routines:

  • Repairs directory permissions
  • Synchronizes Passwords (Services, FTP and Account)
  • Rotates Service Logs
  • Cleans Temporary Directories
  • Re-Writes Service Configuration Files
  • Restarts Services (Server, AutoDJ)

While the panic button feature will not repair all issues, it does allow producers to help themselves quickly without going through the process of contacting the support team and is recommended to try first before submitting a support request.

Encoder Section

These are the encoder settings for use in most broadcasting software (source clients).
Please refer to your manufacturer’s documentation for detailed information on how to setup your software for broadcast (Live) streaming.

  • Mode: This is the currently active mode. Two modes are supported:
    • Server Direct: In Server Direct mode your broadcasting software will stream directly to the server. Important: This mode does not include advanced DJ authentication and scheduling features available in DJ Manager mode.
    • DJ Manager: In DJ Manager mode your broadcasting software will stream through the AutoDJ enabling enhanced DJ management features.
  • Hostname: This represents the ‘host’ or ‘ip-address’ setting in your broadcasting software.
  • Port: This represents the ‘Port’ setting in your broadcasting software.
  • Login: The login credentials (username:password) required to authenticate broadcasting. Two modes are supported:
    • Server Direct: The username is always ‘admin’. The password is the same as the ‘Source Password’ setting on the Server Settings page.
    • DJ Manager: Display’s a list of active DJ’s. Refer to each individual DJ setting for detailed information and scheduling.