ComposerPro

Mcaster1PlaylistComposerPro.exe is the broadcast log production tool. It builds dated, ordered run-of-show logs from your media library, applies clock templates to auto-populate hour-blocks, and exports logs in industry-standard formats for use with SAM Broadcaster, Rivendell, and other automation systems.

What Is a Broadcast Log?

A broadcast log (also called a running order, run sheet, or playout list) is an ordered list of every item that will air during a show or broadcast day, with item types (music, spot, jingle, news, filler, voice), start times, durations, and notes. ComposerPro stores logs in MySQL and can export them in multiple formats for compatibility with radio automation software.

Launching ComposerPro

From TagStack (recommended)

In TagStack's Media Library Playlist tab, double-click any saved playlist (or select it and click Open in ComposerPro). ComposerPro opens with the playlist tracks already loaded as a log draft, ready to edit.

Direct launch

# Open ComposerPro with no initial content (blank log):
Mcaster1PlaylistComposerPro.exe

# Open a specific saved log by database ID:
Mcaster1PlaylistComposerPro.exe --log-id 42

# Load a TagStack playlist as a log draft:
Mcaster1PlaylistComposerPro.exe --playlist-id 7

The Log Grid

The main area of the ComposerPro window is the log grid — an ordered list of all items in the current log. Each row represents one scheduled item.

Log Item Types

TypeCodeUse
Music0Regular music track from the media library
Spot1Commercial spot or advertisement
Jingle2Short audio sting, liner, or station ID
News3News bulletin or talk segment
Filler4Background or fill audio when main content ends early
Voice5Voice-over, DJ break, or announcer segment

Log Grid Columns

ColumnDescription
#Position in the log (1-based). Used for sequencing and cart number lookup.
TypeItem type badge (Music / Spot / Jingle / News / Filler / Voice)
CartCart number (for SAM Broadcaster and Rivendell integration)
TitleTrack title or segment name
ArtistArtist name (music items)
StartScheduled start time (HH:MM:SS) — populated by clock templates or manually entered
DurationSegment duration (MM:SS)
NotesFree-text notes for the operator

Log Grid Operations

Sidebar — Library Search

The right sidebar shows your media library loaded from MySQL. You can:

Clock Templates

Clock templates define the structure of an hour — a repeating sequence of slot types with target durations. Apply a template to auto-populate an empty log (or add to an existing log) from your rotation categories.

Anatomy of a Clock Template

Each template has a name and an ordered list of clock slots. Each slot specifies:

Creating a Clock Template

  1. Click Edit Clock in the toolbar. The Clock Template Editor dialog opens.
  2. Click New to create a template and give it a name (e.g. "Hot AC Hour", "Morning Drive Hour").
  3. Add slots using the slot editor: choose the type, category, and duration for each position.
  4. Arrange slots to match your station format. A typical hot-AC hour might be: Music, Music, Music, Jingle, Music, Music, Spot, Spot, Music, Music, Jingle, Music, Music, Music, News.
  5. Click Save. The template is stored in MySQL.

Applying a Clock Template

  1. Select a template from the Template dropdown in the toolbar.
  2. Set the Log Date using the date picker.
  3. Click Apply Clock. ComposerPro creates log items for each slot in the template, pulling tracks from the corresponding rotation categories according to each playlist's broadcast automation rules (artist separation, BPM range, genre mix, energy mode).

Tip: You can apply a template multiple times (once per hour) to build a full day log. Each application appends to the current log. Use the date picker to set the correct broadcast date before saving.

Categories

Rotation categories group your tracks for automated scheduling. Categories are named buckets with a color badge (e.g. "Top 40 Hot" in accent-blue, "Gold" in yellow). You manage categories in TagStack's database settings and assign them to playlists. ComposerPro clock template slots reference categories to know which pool of tracks to pull from.

Cart Mappings

Cart numbers are used by SAM Broadcaster, RadioBoss, and similar systems to identify audio assets by a short code (e.g. "C001", "SPOT-042"). TagStack's cart_mappings table links a cart number string to a media_id in your library. ComposerPro can populate the Cart column in the log grid from these mappings, so the exported SAM Broadcaster log is ready to use immediately.

Cart mapping flow: Assign cart numbers to your media items via the Media Library Metadata Editor. ComposerPro reads the cart_mappings table when building the log and fills in the cart number column automatically for matched items.

Log Management

New Log

Click New to clear the current log. If there are unsaved changes, ComposerPro prompts to save first.

Open Log

Click Open to browse saved broadcast logs from MySQL and load one into the grid.

Save Log

Click Save to write the current log (name, date, all items) to MySQL. The log name and date are shown in the toolbar. The dirty indicator (asterisk) clears when saved.

Export Formats

Click Export to save the current log in one of five industry-standard formats:

FormatExtensionDetails
M3U Playlist.m3uStandard playlist; #EXTM3U header, #EXTINF:duration,Artist - Title per item, followed by file path
M3U Extended.m3u8Same as M3U but UTF-8 encoded — required for non-ASCII artist/title names
PLS Playlist.pls[playlist] header, File1= / Title1= / Length1= per item; NumberOfEntries=N
SAM Broadcaster Log.txtTab-separated: Date, Time, Duration, Artist, Title, Album. Directly importable into SAM Broadcaster's scheduled log feature.
Rivendell / CSV.csvHeader row + comma-separated: position, title, artist, album, duration_sec, file_path. Compatible with Rivendell import and spreadsheet tools.

SAM Broadcaster users: Export as SAM .txt, then import via SAM's Scheduler → Import Log. Cart numbers in the log grid map directly to SAM's cart system if you have populated the cart_mappings table.

Rivendell users: Export as Rivendell CSV. Use Rivendell's rdlogedit CSV import to load the log into your Rivendell database. Duration is in seconds (integer) to match the Rivendell schema.

Total Duration

The status bar at the bottom of the ComposerPro window shows the total duration of all items in the current log. This is recalculated after every add, remove, or clock template application. Use it to ensure your log fills the target broadcast block (e.g. exactly 60:00 for a one-hour show).