1. Home
  2. BoomBox v3.5
  3. Playlist Manager

Playlist Manager

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

Important Note: The classic ShoutCast transcoder (sc_trans) is no longer supported and will be completely retired with the release of BB version 3.5. Therefore, all customers are encouraged to change the transcoder type to liquidsoap and adjust playlists as soon as possible as there is no guarantee that they will work when BB 3.5 is released and playlists are migrated. All further documentation refers to the liquidsoap transcoder only.

Table View

The table provides overview and basic management of all playlists. To add a playlist, click on ‘Create Playlist’ icon and you will be redirected to the “Create Playlist” Form.

Table View Fields

  • Name: The name or alias of the Playlist and provides advanced playlist management features (more below)
  • Folder: The directory (ordered under the Media folder in the Finder file manager) from which music tracks will be played.
  • Recurrence: Provides a dropdown of scheduling schemas in which the Playlist will broadcast (further scheduling options can be found on the Playlist Editor Form).

Playlist Editor Form

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

Playlist Field Descriptions:

  • Name: 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 sbn.sonixcast.com. Spaces and special characters are allowed.
  • Section Tracks: Tracks are digital music files (mp3, ogg, wav) read from a subdirectory of the Media folder. BB watches these folders for changes according to the patterns below which gives the radio producer maximum flexibility and control over programing playback.
    • Folder: The directory (ordered under the Media folder in the Finder file manager) from which music tracks will be played.
    • Watch Mode: The watch method applied to the track folder
      • Seconds: Checks for changes every <interval> seconds.
      • Rounds: Checks for changes every <interval> cycles (tracks played).
      • Watch: Continuously watches for track changes.
    • Watch Interval: The interval at which track changes will be polled (0.0 to disables all watches).
  • Section Scheduling: Playback is scheduled according to patterns assisted by pre-defined templates with resolution defined in days, hours, minutes and seconds.
    • Template: Scheduling templates to assist in building basic playback patterns.
    • Pattern: The pattern to be applied to playback (see: Pattern Scheduling)
  • Section Encoder: Global playback encoder settings
    • Normalize: Normalize or ‘even out’ the volume (gain) of all tracks in the playlist.
    • Shuffle: Enables or disables random track shuffling during playback.
  • Section Crossfade: Globally apply linear crossfading to all tracks in the playlist.
    • Duration: The total crossfade duration (encapsulates Fade-In and Fade-Out).
    • Fade In: Fade (in seconds) applied to the beginning of each track.
    • Fade Out: Fade (in seconds) applied to the end of each track.

Pattern Scheduling (Clocks)

Track playback is scheduled according to liquidsoap patterns which gives radio producers absolute flexibility and control over programing. Patterns can be defined in days, hours, minutes and seconds (absolute dates are not supported at this time).

Pattern Structure

Patterns can incorporate the day of week tokenized by a ‘w’ (i.e. Sunday: 7w), time formats tokenized by ‘h’ for hour, ‘m’ for minute and ‘s’ for seconds (i.e. 12:53:23: 12h53m23s) or absolute millisecond formats (i.e. .1200 for 1.2 seconds) and can be mixed with ‘or’ and ‘and’ operators to determine the final playback resolution of the pattern. Templates provide basic working scenarios from which finalized patterns can be built.

Note: All time formats are in 24 hour or Military time formats (i.e. 1pm = 13:00 or 13h).

Default or Fallback Playlists

Playlists which play all day, every day will ensure that there is no ‘dead’ air time between playlists or live events and are defined by a simple ‘true’ pattern. They are automatically prioritized to be overridden by other playlists and live events.

Operator Chaining

Operators can be used to chain event patterns (i.e. 7w or 1w) and/or qualify chained patterns (i.e. 7w or 1w and 12h-13h) whereas the time pattern is applied to the previously defined day pattern(s).


The following examples will help radio producers to understand how to build simple and complex playback patterns.

Default Playlist that plays between 06:00 to 08:00

  1. add ‘and 6h-8h’ to the Pattern value. The entire value should look like this ‘6h-8h’.

Playlist Weekdays at Lunch Time 12:00 to 13:00

  1. Select the template ‘Weekdays (Monday through Friday)’. ‘1w or 2w or 3w or 4w or 5w’ will be written into the Pattern field.
  2. Add ‘and 12h-13h’ to the Pattern value. The entire pattern should look like this: ‘1w or 2w or 3w or 4w or 5w and 12h-13h’

News Blast Every 10 Minutes

  1. Select the Template ‘Time Periodic (Spots and Jingles)’. ’00m00s’ will be written into the Pattern field.
  2. Adjust the value to look like this: ’10m00s’ or just ’10m’

Station ID at the beginning of every hour

  1. Select the Template ‘Time Periodic (Spots and Jingles)’. ’00m00s’ will be written into the Pattern field.

Other Examples:

  • 20h-22h30 – plays between 8pm and 10:30pm
  • 1w – plays all day Monday
  • 6w or 7w and 0h-12h – plays weekends mornings

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).

Tags , , ,
Was this article helpful to you? Yes 7 No 4