Once the download is complete, run the downloaded .exe file.
3
Accept the licence agreement
You will first be presented with the software licence agreement. Once you have read and agree to these terms, click I Agree.
4
Choose components
Choose the components to install. Here you can select whether to install Start Menu and Desktop shortcuts. Click Next to continue.
5
Choose install location
Choose the location to install the software. By default, this is in Program Files, but can be changed to your preference. Click Install to begin installation.
6
Launch PlayIt Manager
Tick Start PlayIt Manager and click Finish to launch PlayIt Manager. If PlayIt Manager does not launch, type PlayIt Manager from the Start Menu.
7
Allow elevated privileges
On first run, PlayIt Manager requires elevated privileges (Administrator mode) in order to manage the HTTP configuration for the application. For advanced users, the scripts it will run are:
The User Account Control window will look like this:
User Account Control prompt showing the request for elevated privileges
Click Yes to continue.
Accessing PlayIt Manager
PlayIt Manager will start up and launch a browser window so you can start using PlayIt Manager. While PlayIt Manager is running, it can be found in the Notification Area (System Tray). Double click the icon to show the Configure PlayIt Manager Server window, where you can configure advanced settings and enable external access.
New versions of PlayIt Manager are regularly available from playitsoftware.com. It is important to back up your data before you install any new versions. Data and logs for PlayIt Manager are stored in the Windows ProgramData folder.
C:\ProgramData\PlayIt Manager
To back up your data, simply copy this folder to an alternative location, such as an external hard drive.
When a new version is installed, or an old version is uninstalled, the data in the location above will not be removed.
NOTE: If you receive an error saying "Error opening file for writing" when installing, ensure you have stopped PlayIt Manager.
Uninstallation
When installed, PlayIt Manager will include an Uninstall shortcut in the Start Menu.
If you chose not to add Start Menu shortcuts, the Uninstaller can be found at (by default):
Please ensure you have stopped PlayIt Manager before attempting to uninstall.
Double click the icon to start the uninstall process.
Tick the checkbox to Delete application database and settings if you no longer wish to use PlayIt Manager in future. Click Next.
Click Uninstall to remove PlayIt Manager.
Activation
The first time you run PlayIt Manager you will be prompted to activate the software.
The simplest way to activate the software is to activate online by logging in to your PlayIt Software account. Alternatively you can activate offline if your PlayIt Manager server machine is not connected to the internet.
Click this button to start the online activation flow.
You will be prompted to enter your PlayIt Software account username and password. If you do not have an account, click Create an account and a new window will open for you to create an account. Return to the log in window once you have created an account.
Click the Log In button to get your PlayIt Manager licence. The window will close and the licence information will be populated after a short period of time.
Note the Computer Name and Machine Code displayed here. You will need these to generate a licence on the PlayIt Software website.
Once you have generated a licence from the PlayIt Software website, paste the licence text in the box and click Apply. Alternatively, if you have downloaded the licence file from the website, click the box to select the licence file and then click the Apply Licence File button.
The page will be updated with the licence information populated.
The Licence Information section is populated with the account name, email, and machine code tied to your subscription.
You are now ready to use PlayIt Manager. Click Get started! to start.
If your server is connected to the internet, see Activating Online for the simpler activation flow.
Renewing Licence
When a licence has expired, synchronising with PlayIt Live instances will cease to function until a new valid licence has been applied. While you remain logged in to your PlayIt Software account, PlayIt Manager renews your licence automatically for as long as your subscription is active, so you should rarely need to renew manually. With an active subscription you can also apply a licence with the previous activation steps.
Double-click the PlayIt Manager icon in the notification area (system tray) to show the Configure PlayIt Manager Server window. Here you can stop and start the server if necessary or access the Advanced or External Access sections.
The Open remote management in browser link opens the PlayIt Manager web interface in your default browser.
With HTTPS, data between you and the connecting user will be encrypted. Without it, a "Not Secure" message will be shown in the web browser. Due to browser restrictions, HTTPS is required to use Remote Voice Tracking and Remote Studio in the web browser.
Technical detail: When HTTPS is enabled, an SSL certificate for the registered hostname will be generated for you by PlayIt Software and installed on your machine. A self-signed certificate will also be generated for localhost to be used on the local computer.
The hostname used to allow other users to access your remote access server with a static (and potentially memorable) address. Leave the hostname and access code boxes blank before starting the server to use a random address. You can register your own custom address using the link. Once you have registered the hostname, enter the hostname and access code provided to you into the corresponding boxes.
Custom hostnames are only available to customers who have an active premium module subscription or lifetime purchase.
Shows the detected external IP address. This address is used to automatically map your hostname to your IP. If your IP changes, your hostname remains the same. If you wish to override the detected IP address, click Override, enter the IP address, and click Save.
Shows the status of the SSL certificate registration and IP address publishing. Typically SSL certificate registration and IP address (DNS) registration takes around 10 minutes after starting the server.
PlayIt Manager normally keeps your hostname's IP address and SSL certificate registration up to date automatically. Click Disable Updates to turn this off and manage the registration yourself; the button then reads Enable Updates so you can switch automatic updates back on. While updates are disabled, your hostname may stop resolving if your external IP address changes.
The Help me set up external access section provides some assistance to allow others outside your network to access your computer.
Typically, this requires creating a firewall rule to allow connections to the remote access server port. Click the Create rule... button to automatically add this to the Windows Defender firewall. If you are using another firewall, e.g. McAfee, refer to its documentation to allow connections through the server port.
For home or small office networks, you will need to set up port forwarding rules on your network router to route incoming traffic on the remote access server port to your PlayIt Manager computer. The TCP port you need to forward, along with the name of your computer and its internal IP address, are shown in this window. As each router is different it is not possible to give specific instructions. We recommend referring to PortForward.com for instructions for many brands of router.
For corporate or school networks, please speak with your IT administrator.
Once you have set up your system correctly for external access, the Try again? check will pass and the window will indicate that PlayIt Manager is reachable at your public hostname.
See also Advanced Settings for hostname registration and HTTPS configuration.
Overview
PlayIt Manager is a browser-based server application enabling the remote management and data synchronisation of PlayIt Live data. You can manage Track and Track Group data as well as schedule data such as Clocks and Playout Log for synchronisation with PlayIt Live.
The software is designed to run as a separate application storing a single source of data. PlayIt Live instances on different computers can connect to PlayIt Manager via a URL (Uniform Resource Locator) and receive updates from the server. The URL to use is the base URL found in the address bar when using PlayIt Manager from a browser, such as http://server:25432/. PlayIt Live 1.11 or later is required to synchronise all data with PlayIt Manager. For more information, see Connect PlayIt Live.
System Requirements
PlayIt Manager requires the .NET Framework 4.7.1 which is automatically downloaded and installed via the installer. To install this framework requires at least Windows 10 or Windows 11; or Windows Server 2016 or later, with all Windows updates applied.
Supported Browsers
PlayIt Manager is supported on the latest desktop versions of:
A trail of links to the previous pages navigated to reach the current page. Click any breadcrumb to return to that page.
Track Management
Tracks are references to audio files that can be uploaded to PlayIt Manager. When synchronised to PlayIt Live they appear on the Track List on the right hand side of the interface and are used for playing audio content.
A Delete button that prompts for confirmation before removing the track.
By default the track list shows the Artist - Title and Duration columns. You can add, remove and reorder columns to suit the way you work. For example, add the Track Groups column to see at a glance which categories a track belongs to, or show the Year and Genre columns when programming music.
Click the Select Track List Columns button above the list (next to Export to CSV) to open the column picker.
Tick or untick a column to show or hide it in the track list. Select a column by clicking its row to move it (see the reorder buttons). Columns are shown left to right in the order they are listed here.
The columns you can choose from include Artist - Title, Artist, Title, Duration, Album, Intro, Early Out, Year, Path, Type, Out Cue, Genre, Tags, Comments, Sweeper, ISRC, Record Label, Gain (dB), Last Played, Hook Start, Hook End, Track Groups and Track ID.
The Move Up and Move Down buttons change the position of the selected column. Select a column in the list, then use these buttons to change where it appears.
Click Save to apply your changes, or Cancel to discard them.
Your column choices, their order and any widths you set by dragging a column border are remembered in your browser, so the list looks the same the next time you open it on the same computer. Because the settings are stored per browser, a different computer or browser starts from the default columns.
Adding New Tracks
Tracks can be added to PlayIt Manager from this page. Uploaded files are stored in the Audio Store folder inside the PlayIt Manager ProgramData folder. By default this is C:\ProgramData\PlayIt Manager\AudioStore\.
The page has three source tabs at the top which let you choose where the tracks come from:
Upload to Server: drag and drop files from your computer, or click to browse for them.
Files on Server: select existing audio files that already live on the PlayIt Manager server.
Folder on Server: point PlayIt Manager at a folder on the server and add every audio file inside.
Queueing tracks for upload
The first screenshot shows the Upload to Server tab with 24 audio files queued and ready to upload.
Drag audio files into this box to queue them, or click anywhere inside the box to open a file picker. Dropping or selecting files appends them to the existing queue (it does not replace what is already there).
Once tracks are queued the summary line appears showing the current state (Ready to upload), the number of files in the queue, and the total size on disk. The Clear list? link removes every queued file so you can start over before uploading.
The first ten queued files are listed by name. If more than ten files are queued an additional line shows the count of files that are not visible (for example + 14 more files). An empty progress bar appears beside each file and starts to fill once the upload begins.
Optionally add every uploaded track to a listed track group. Pick an existing group from the dropdown, or choose <new> and give the new group a name to create it as part of the upload.
Starts uploading the queued files. While files are uploading the button is replaced by a red Stop button that cancels any uploads that have not yet completed.
Uploading in progress
After clicking Upload, PlayIt Manager uploads up to five files at a time. The next screenshot shows the page partway through an upload, with most files completed, one file in error and the remainder in flight.
While uploads are running the state text changes to Uploading..., the file count and total size still reflect the original queue, and the Clear list? link is hidden so the queue cannot be cleared mid-upload.
Shows up to ten files that are currently in flight, each with its own per-file progress bar. If more files are still queued an additional line shows the count (for example + 1 more files). Any file that failed to upload is listed separately below with its filename and a red error icon; failed files are not retried automatically.
Replaces the Upload button while uploads are running. Clicking Stop cancels any uploads that have not yet started; uploads already in flight continue to completion.
Viewing the tracks you just added
When every upload has finished, a green confirmation banner appears reading Your track files have finished being added. It carries two links: Track List and Track Groups.
The Track List link opens the list filtered to show only the tracks that were added during this upload session. This lets you confirm at a glance that everything imported, and quickly open any track whose metadata needs tidying up.
For example, after uploading 20 tracks you can click Track List to see exactly those 20 tracks, check the artist and title are correct, and click Edit on any that need their details completing, without having to search the whole library to find them.
The Clear filter button inside the banner that removes the filter and returns to the full track list.
Editing Tracks
The Edit Track page lets you view and edit every property of a track stored in PlayIt Manager. Open it from the track list by clicking Edit next to a track. Changes you make here are saved back to PlayIt Manager and synchronised to any connected PlayIt Live installations.
The < and > buttons step backwards and forwards through the current track list without leaving the page, so you can edit several tracks in a row. The buttons respect the search and track group filter that was active when you opened the editor.
Click Customise View to choose which fields are shown on this page. Tick the fields you want visible and untick the ones you don't use. The choice is remembered for your user.
The path that connected PlayIt Live installations will use to read the audio file. This is calculated automatically by applying the track path substitutions configured in Settings to the server path, so that each client reaches the file by the correct UNC or local path.
The track type: Song, Station ID, Promo, Commercial, News, Bed or Station ID + Bed. PlayIt Live uses the type to apply different scheduling and playback behaviour. Leave this set to -- Inferred -- to let PlayIt Live determine the type automatically from the track's tags, artist, title and duration.
The Out Cue can be the style of the track's ending, such as Fade Out or Sustain, or the last spoken words in the track, so presenters know when to talk over the end of the track.
Free-form tags used for categorising the track. Tags can be used by filtered track groups and by the Inferred Type rules. Type a tag and press Enter to add it; click the × beside a tag to remove it.
Sweeper?: allows the playout system to play this track over the intro of the next song (before the Intro point), or over the end of the previous song (after the Early Out point). It is typically used for sweepers, which are short clips that identify the station or show, and are usually dry (no background music) so they do not clash with the track they are playing over.
No Fade?: prevents the track from being faded out when the next track begins. Use it for tracks with a natural ending that should not be cut short.
Tick the box and choose a date to make the track available for scheduling only from that date onwards. Before the date the track is ignored by the scheduler.
Tick the box and choose a date after which the track should no longer be scheduled. After the expiry date the track is ignored by the scheduler.
When both Valid From and Expires are set, an Ignore year on dates option appears. Tick it to ignore the year part of both dates so the track recurs every year between the same day and month, for example a Christmas track that returns to the schedule each festive season without the dates needing to be updated.
Changes the playback speed of the track as a percentage. Use small positive or negative values to nudge a track a little faster or slower to fit a time slot. Leave blank for normal speed.
Shows the Listed Track Groups the track currently belongs to. Filtered and grouped track groups that automatically include this track aren't shown here: only the groups you've manually added it to.
Click Add Track Group to add the track to another listed group, or use the row actions to remove it from a group.
Save saves all changes and returns to the track list.
Cancel discards any unsaved changes and returns to the track list.
Delete prompts for confirmation, then removes the track from PlayIt Manager.
Bulk Editing Tracks
Bulk editing lets you change a property on many tracks in a single operation, instead of opening and saving each track one at a time. It is useful whenever a group of tracks needs the same change, such as correcting a misspelled artist name across a whole album, setting the Genre on a batch of newly uploaded songs, or marking a set of dated promos as Disabled.
You select the tracks you want on the track list, open the bulk edit page, tick only the fields you want to change, enter the new values, and save. Changes are written back to PlayIt Manager and synchronised to any connected PlayIt Live installations, just like a normal edit.
Selecting tracks
Each row in the track list has a checkbox on the left. Tick the rows you want to edit, or use the checkbox in the column header to select every track currently shown. Use the search box and track group filter first to narrow the list down to the tracks you care about before selecting.
When one or more tracks are selected, a button bar appears with an Edit button (showing how many tracks are selected) and a Delete button. Click Edit to continue. If you have only a single track selected, this opens the normal Edit Track page; with two or more selected it opens the bulk edit page described below.
With tracks selected, a selection bar appears over the grid header containing a blue Edit 4 tracks button and a red Delete 4 tracks button.
The bulk edit page
The bulk edit page looks like the Edit Track page but with a checkbox beside every field and a heading reading Bulk Edit 4 Tracks. Each field is pre-filled with the value shared by all the selected tracks; where the selected tracks have different values the field is left blank.
Tick the checkbox next to a field to include it in the update, then set the value you want. Only ticked fields are applied. Every field left unticked is untouched on all the selected tracks, so the change is precise and you never overwrite values you didn't mean to. Click Save to apply the changes to all the selected tracks, or Cancel to discard them and return to the track list.
The following fields can be set in bulk: Artist, Title, Type, Track ID, Out Cue, Album, Genre, Year, Tags, Comments, the Sweeper?, No Fade? and Disabled flags, Valid From, Expires, Ignore year on dates, ISRC, Record label, Adjust Tempo (%) and Gain (dB). Track groups cannot be changed here, and cue points are handled by the Analyse All action rather than by entering values (see below).
This example shows the Genre field with its checkbox ticked. The field is set to "Pop", so the genre is changed across every selected track. Every other field works the same way: tick its checkbox to include it in the update, or leave it unticked to keep it untouched.
This example shows the Album field with its checkbox unticked, so it will be unchanged on all the selected tracks. Fields whose selected tracks shared a common value are pre-filled with that value; fields whose values differ are left blank.
The Save and Cancel buttons appear at the bottom. Click Save to apply the ticked fields, or Cancel to discard the changes.
Example: setting a genre on a batch of uploads
Suppose you have just uploaded fifty new songs and want them all filed under the Pop genre. On the track list, tick all fifty (filter or search first to isolate them, then use the header checkbox), and click Edit. On the bulk edit page, tick the Genre checkbox, type Pop, and click Save. All fifty tracks are updated in one step and every other property is left exactly as it was.
Editing tags in bulk
The Tags field works a little differently because tracks usually have several tags and you rarely want to discard the ones already set. When you tick Tags, an operation dropdown appears with three choices that control how the tags you enter are combined with each track's existing tags:
Overwrite: replaces all existing tags on the selected tracks with the tags you enter. Any tags the tracks already had are removed.
Add: adds the tags you enter to each track without removing any existing tags. Use this to supplement the current tags.
Remove: removes only the tags you enter from each track, leaving all other tags intact. Use this to clean up tags that are no longer relevant.
Type the tags to apply into the tag box, where each tag appears as a removable label. The tags you enter are then combined with each track's existing tags according to the operation you chose. In the example below, two tags are entered ready to be added to every selected track.
The Tags field with its checkbox ticked, the operation dropdown set to Add, and two tags entered as removable labels ready to be added to every selected track.
Bulk analysing cue points
Cue points can't be typed in across many tracks, but you can detect them automatically for the whole selection. Click Analyse All in the Cue Points section to run cue point detection on every selected track in turn, finding the Cue In and Cue Out from the silence at each end. The detected cue points are applied when you Save. This saves opening and analysing each track individually on the Edit Track page.
The Cue Points section shows an Analyse All button. Click it to detect the Cue In and Cue Out for every selected track in one pass; the detected cue points are written to the tracks when you click Save.
Track groups
Track group membership cannot be changed from the bulk edit page; the Track Groups section shows a note explaining this. To change the track groups of several tracks, edit them individually on the Edit Track page.
Track Group Management
As the name suggests, track groups group tracks based on certain criteria. There are three different types of track group: Listed, Filtered and Grouped.
Listed: Manually group tracks by selecting them from a list. See Listed Track Groups.
Filtered: Group tracks based on properties on tracks, such as artist, title, genre or year. See Filtered Track Groups.
Grouped: Combine multiple track groups into another track group. See Grouped Track Groups.
Lists track groups added to PlayIt Manager. It shows the name of each track group, the type of the track group and the number of tracks in the track group. The following action buttons are available:
A drop down with all available options for the track group.
An Edit button that opens the relevant edit page (Listed, Filtered or Grouped).
A Delete button that prompts for confirmation before removing the track group.
Listed Track Groups
Listed track groups are used to group manually chosen tracks together. This is useful when you have simple categories of tracks you want to group, such as Power, Recurrents and Gold.
Tick the Colour checkbox to show a colour for any tracks in this track group when they appear on the playout log on the PlayIt Live main interface. Click the colour dropdown to change the colour.
Tick the Icon checkbox to show an icon for any tracks in this track group when they appear on the playout log on the PlayIt Live main interface. Click the icon dropdown to change the icon.
Priority is used to decide which track group is shown on the playout log when a track belongs to more than one group. The track group with the highest priority wins for displaying the colour or icon.
Use the Save button to save the track group to the database.
Use the Cancel button to discard all changes and return to the track group list.
Use the Delete button to remove the track group from the database. A confirmation prompt is shown first.
Filtered Track Groups
Filtered track groups gather tracks that match a set of rules on track properties such as artist, title, genre or year. Tracks join or leave the group automatically as their properties change, so a filtered group always reflects the current library.
Use the Save button to save the track group to the database.
Use the Cancel button to discard all changes and return to the track group list.
Use the Delete button to remove the track group from the database. A confirmation prompt is shown first.
Grouped Track Groups
Grouped track groups combine multiple existing track groups into one. They are useful when you want to treat several groups as a single set, for example a Daytime Rotation that includes both your Power and Recurrents groups.
Check this box to exclude the selected track groups instead of including them. When inverted, tracks belonging to any of the selected groups are removed from the result.
Use the Save button to save the track group to the database.
Use the Cancel button to discard all changes and return to the track group list.
Use the Delete button to remove the track group from the database. A confirmation prompt is shown first.
Move Tracks Between Listed Track Groups
This page is used to quickly move tracks from one listed track group to another. This is useful if you regularly move tracks between playlists. Move Tracks works with listed track groups only.
Use the dropdown to choose the second listed track group. The list of tracks in that group appears underneath the dropdown. The two dropdowns cannot point at the same group, and a notice is shown if you pick the same group on both sides.
Click and hold the drag handle on the left of a track row, then drag the row onto the other track group's list to move the track between the two groups. Drag tracks one at a time to move several.
Click Apply Changes to save both track groups with the new sets of tracks.
Click Cancel to discard any changes and return to the track group list.
Multiple Artist Split Management
Multiple Artist Splits are used to define text that is used to separate multiple artists that might appear in the Artist field of a track.
For example, an artist of a track might be Take That feat. Lulu. By using a Split with the text feat. this will separate Take That and Lulu as separate artists.
When scheduling against Playout Policies, PlayIt Manager can prevent tracks from Take That or Lulu being played too close to Take That feat. Lulu.
Lists multiple artist splits added to PlayIt Manager. The Split Text and Disabled status are shown along with three per-row action buttons covered below.
A drop down with all available options for the multiple artist split.
Opens the edit page for the multiple artist split.
Prompts for confirmation, then removes the multiple artist split.
The text used to separate a Track Artist into multiple artists. Include spaces either side of the text if you want to split by a word. For example, with on its own could match George Michael with Elton John but also Bill Withers.
This table shows all artists in your library whose Artist field is split by the entered Split Text. Use it to confirm the split text is having the desired effect.
Tick this checkbox to disable this Multiple Artist Split so it is not considered by the scheduler.
Related Artist Management
Related Artists are used to associate artists with each other so they are considered as the same artist when scheduling with playout policies. For example, you may not want a solo singer in a band to be played close to a song by that band, e.g. Robbie Williams and Take That.
Lists related artist pairs added to PlayIt Manager. The two artists and Disabled status are shown along with three per-row action buttons covered below.
A drop down with all available options for the related artist.
Tick this checkbox to disable this Related Artist so it is not considered by the scheduler.
Monitored Folders
Monitored Folders can watch the state of a Windows folder (and optionally its sub-folders) for new, updated or deleted track files.
When a file is added to the folder, it will be added to the PlayIt Manager database if it is a valid track file. The track file can also be automatically analysed for cue points and added to a track group.
When a file is updated in the folder, it will be updated in the PlayIt Manager database, updating the duration, cue points and any file metadata contained within the file if desired.
When a file is deleted from the folder, it will be deleted from the PlayIt Manager database.
Monitored folders work by periodically scanning for changes in the folder. Folders with a large number of files or sub-folders will take longer to scan. For this reason, do not use C:\ as the folder to scan for changes to every file on your computer. This will likely never complete. Choose a folder where you know audio files are.
Use Monitored Folders if you have dynamic content, e.g. news or weather, from a folder such as Dropbox. Create a Monitored Folder with a Path to the shared Dropbox folder to pick up changes from the Dropbox folder.
Prompts for confirmation, then removes the monitored folder.
Monitored Folders Status
The Monitored Folders Status page shows what PlayIt Manager's Monitored Folders feature is doing right now. The upper list summarises every monitored folder and its current scanning state, while the lower Recent events log records the individual actions taken as files are added, changed or removed.
Use this page to confirm that files you have added to a monitored folder were actually imported, and to diagnose why a particular file did not appear in the track library. Where the folder list tells you that a folder exists, this page tells you when it was last scanned, what that scan found and exactly which files were affected.
To open this page, click Monitored Folders Status on the Listing Monitored Folders page. You need the Can add, edit and delete monitored folders permission to see it.
At the top of the page is a button bar containing a single Rescan All button, used to scan every monitored folder immediately, without waiting for the automatic countdown. This is the quickest way to confirm that a file you have just added or fixed is now being picked up. New activity appears in the Recent events log for the selected folder as the scan runs.
The monitored folder list is a grid with one row per monitored folder. Select a row to show that folder's activity in the Recent events log below. The columns are:
Column
What it shows
Path
The folder being monitored.
Status
The folder's current state: Idle (waiting for the next scan), Scanning (a scan is in progress) or Disabled (the folder has been disabled and is not monitored).
File Count
The number of files found in the folder during the last scan.
Last Scan Duration
How long the last scan took, for example 5.123s, or with a minutes part such as 1m 2.500s for a longer scan.
Last Scan Summary
What the last scan found, for example 2 new track(s); 1 changed track(s), or No changes if nothing changed.
Next Scan In
A countdown to the next automatic scan, in seconds.
Below the folder list is a log of the individual actions taken for the selected folder as files are added, changed or removed. Where the folder list tells you the summary of the last scan, the events log tells you exactly which files were affected and what happened to each one.
Select a folder in the upper list to see its events; a folder is selected automatically when the page opens. The log shows the most recent events for that folder, newest first, and updates automatically as new activity occurs. If the selected folder has no recorded activity yet, the log reads No recent events for this folder. The columns are:
Column
What it shows
Time
The date and time the event occurred, shown in your server's time zone.
Type
The severity of the event: Info, Warning or Error.
Message
A description of what happened, usually naming the file involved.
The Type of each entry tells you how it went:
Info: a normal monitoring action completed successfully. Examples: Adding track from file: <name>, Updating track from file: <name> and Deleting track: <name>.
Warning: something was skipped or needs your attention, but monitoring continues. Examples: New file is not a track: <name> and Changed file is not a track: <name>, meaning the file could not be loaded as an audio track.
Error: a scan failed. The message includes the underlying error, for example Scan failed.
The page refreshes automatically while it is open: the status data is reloaded every few seconds, and the Next Scan In countdown ticks down each second.
A folder scan can repeatedly report new files. This happens when a folder contains files that are not valid audio tracks: because they are never added to the track library, each scan treats them as new again. The Recent events log makes these files easy to spot. Look for Warning entries such as New file is not a track.
The events log lists only recent activity for live troubleshooting; it is not a permanent audit trail. Only the most recent events for each folder are kept.
Example: finding out why a file did not import
Suppose a presenter copies a new jingle into a monitored folder but it never appears in the track library. Open the Monitored Folders Status page and select that folder in the upper list. In the Recent events log you might see a Warning entry reading New file is not a track: jingle-final.wav.
That tells you the file was detected, but PlayIt Manager could not load it as a track, usually because the audio is corrupt, the format is unsupported, or the file is still being copied. You can then re-export or re-copy the file and click Rescan All to try again, watching the log for an Info entry such as Adding track from file: jingle-final.wav to confirm it imported.
The path to the folder you want to monitor. If the Include sub-folders checkbox is checked, sub-folders of the folder will also be scanned. Avoid folders with a large number of sub-folders as this will take a long time to scan.
If checked, when a track file is updated the cue points of the track will be re-analysed. Do not use this option if you manually set cue points as these will be overwritten.
If checked, when a track file is updated the fields of the track will be updated from the file. Do not use this option if you manually change the track fields as these will be overwritten.
If checked, a track will be deleted if the track file is deleted. A track file is determined to be deleted if it is not found after scanning the folder.
If a network folder or external drive is used in a monitored folder and this folder is disconnected or the drive is unplugged, PlayIt Manager will pause monitoring of the folder and warn that it is no longer accessible. Tracks will not be deleted in this case.
If this folder is regularly updated where a file is deleted and subsequently replaced with a file of the same name, you should switch this option off. Clocks and the playout log will maintain the original reference and use the new track file.
If checked, new tracks will be added to the selected track group. Tracks will not be re-added to this track group if they are subsequently removed from the group.
If checked, the monitored folder will be disabled and will not be monitored.
Playout Policy Management
Playout policies define a set of rules to ensure the correct tracks are played. Playout policies restrict artists and tracks from being repeated too often. They can be filtered by track group.
There are three types of playout policy: Track / Artist / Title Separation Playout Policy, Daypart Separation Playout Policy and Track Set Separation Playout Policy.
With Track / Artist / Title Separation Playout Policy, it is possible to ensure that tracks in a track group of Songs are not repeated for at least 2 hours while ensuring tracks in a track group of Jingles are not repeated for only at least 10 minutes.
With Daypart Separation Playout Policy, it is possible to ensure that a track in the track group Songs is not repeated again in the same Daypart (e.g. Breakfast) for a period of days. This means regular listeners to the Breakfast show will not hear the same song repeated during the times when they regularly listen. Daypart Separation Playout Policies require the Advanced Scheduling Module.
With Track Set Separation Playout Policy, it is possible to ensure that any track in the same set is not played again for a specified period of time. Track sets can be defined by track group, tag, or filter. This policy is useful for ensuring variety within specific categories of content. For example, you can ensure "Local Artists" tagged tracks are separated by at least 1 hour to spread local content throughout the day, or for rock formats, ensure "Classic Rock" filtered tracks are separated by at least 30 minutes from other classic rock content. Track Set Separation Playout Policies require the Advanced Scheduling Module.
The minimum amount of time to wait before playing a track with the same title again.
What is the difference between track separation and title separation?
Track separation ensures that the same recording isn't played too frequently by recognising each track instance as unique.
Title separation deals with different songs that share the same title, such as Christmas songs. For example, multiple artists might have their own versions of "Silent Night". Bear in mind this will also separate completely different songs that happen to have the same title, such as 'Hello' by Adele and 'Hello' by Lionel Richie, or 'The Power of Love' by Jennifer Rush, 'The Power of Love' by Frankie Goes to Hollywood and 'The Power of Love' by Huey Lewis and the News.
The daypart for this policy. If no dayparts are shown, click the Manage Dayparts link to open a new tab to add a new daypart. Click the refresh icon after adding a daypart to refresh the list.
Check the checkbox to ensure this playout policy is only applied to tracks in the selected track groups. Leave the checkbox unchecked to apply the policy to all tracks regardless of track group. This allows you to fine-tune which tracks are subject to the separation rule.
Use the Save button to save the playout policy to the database.
Use the Cancel button to discard all changes.
Playout Pattern Management
The playout pattern is the repeating sequence of track groups that the playout log scheduler uses as a basis for the playout log. For example, a playout pattern can be configured with the following track groups:
Songs
Jingles
Promos
This results in Songs, Jingles and Promos being scheduled back to back, repeating over each hour. The scheduler fills each hour by cycling through the pattern, selecting a track from each group in turn.
You can override the playout pattern for individual hours using Clocks.
Click the chevron button on a row in this list to send the selected track group to the end of the playout pattern. The same track group can be added multiple times.
The playout pattern itself, in playback order. Click the remove button on a row to take that entry out of the pattern. Rows can also be dragged within this list to reorder them.
Use the Save button to save the playout pattern to the database.
Use the Revert button to revert the playout pattern to the last saved state.
Clock Management
Clocks are hour-long templates used to define how an hour of playout content should sound. When a clock is scheduled, the playout log will generate items to schedule based on the clock item. The clock can have a number of clock item types:
Track: The playout log scheduler will always insert the selected track in this position in the playout log.
Track Group: The playout log scheduler will randomly choose a track from the selected track group to insert in this position in the playout log. When scheduling the playout log, any playout policies will be taken into account.
Fixed Time Marker: The playout log scheduler will insert a fixed time marker in this position in the playout log.
Break Note: The playout log scheduler will insert a break note to include in this position in the playout log.
Voice Track: A voice recording played between tracks to give the impression that the show is live. Voice tracks can be recorded via PlayIt Live.
Remote URL: Plays a remote file or live stream in PlayIt Live.
Advert Block: Schedules a block of adverts in PlayIt Live, drawn from the advert log.
Hook Sequence: Plays only the hooks of several tracks back to back as a short montage, for example to promote songs coming up in the next hour or songs from a specific track group.
Once you have built your clocks, schedule them to hours of the week so the playout log scheduler uses them. PlayIt Manager offers two scheduling modes, chosen on the Scheduling Settings page: the modern Clock Grids view (where a single grid is the simple case and layering multiple grids is the Advanced Scheduling workflow) and the older Legacy (Calendar) view. See Scheduling Clocks for the recommended Clock Grids workflow.
Standard: A normal hour-long clock that fills the whole hour. Standard clocks can override the station's playout pattern on the Playout Pattern tab.
Partial: A shorter sequence of clock items that does not fill a whole hour, intended to be inserted into the schedule rather than used on its own. Partial clocks do not have a Playout Pattern tab. Using partial clocks requires the Advanced Scheduling module; without it a warning is shown above the form.
The clock item list shows each of the event items that belong to the clock in order. There are four columns:
Play Time:
The approximate play time of a clock item is determine from the sum of the all the previous item durations. The duration of each item varies on the choice of settings - the duration of a track group item is determined from the average duration of all the tracks in the group. A fixed time marker will cause the play time to reset to the fixed time.
Type:
The clock item type. To change the clock item type, click the text and you will be presented with a dropdown. Choose from Track, Track Group, Fixed Time Marker, Voice Track or Break Note.
Settings:
The settings of the clock item. This is dependent on the type you have selected. Click the settings text to change the settings.
Track
Track: Choose a fixed track to play in this slot. Clicking the settings text opens the same track picker used by the playout-log Replace Track flow. Its heading reads Replace Track when the item already references a track (so you are swapping it) or Select Track when the row is still empty:
Pick the track you wish to play:
Original track: when you are replacing an existing track, this shows the track currently in the slot with its artist, title and duration.
The track-group dropdown at the top limits the candidates to a single track group, or All Tracks to consider every track. When the item was already scheduled from a track group, the dropdown is preselected to that group.
The Search box filters the candidates by artist or title.
The list shows each candidate's Artist & Title and Duration. When you are replacing an existing track a Diff column is also shown: how much longer (+) or shorter (-) each candidate is than the original, so you can pick a replacement of a similar length.
Select a candidate and click Select (or double-click it) to use that track. Click Discard to close the picker without changing the item.
Playout-policy violation checking (the Advanced section with its Check playout policy violations option, the Highlight / Hide choices and the amber Violates playout policy highlighting) is only offered when editing the playout log, where each item has a scheduled time to evaluate policies against. It is not shown when building or editing a clock: a clock item has no fixed target time, so the picker here is a plain library pick with no violation evaluation, row highlighting or Advanced control.
Track Group
Track Group: Choose the track group you wish to play. The PlayIt Manager scheduler will choose a track using the selected scheduling strategy and that adheres to the playout policies you have configured:
Pick the track group, then choose the Strategy the scheduler should use to pick a track from the group.
Default from settings: Use the scheduling strategy as defined in Settings.
Smart Selection: Selects a track using a weighted random algorithm. A track played longer ago is given a larger weight, increasing its chance of being selected.
Random: Select a track entirely at random from the track group.
Most Rested: Selects the track from the track group that was played longest ago.
Fixed Time Marker
Fixed Time Marker: A fixed time marker ensures time keeping within the hour. If you want a particular event to happen at a certain time within the hour, please a fixed timer marker before that event. There are 3 types of fixed time markers:
Hard: The item immediately following this fixed time marker will start at the selected time. The preceded item will fade out and stop at this time.
Soft: The item immediately following this fixed time marker will start only once the preceding item has finished after the selected time.
Not Before: This type of fixed time marker ensures that items following the fixed time marker will not play until at least the selected time has passed.
Set the target Time in minutes and seconds past the top of the hour, then choose the Type of fixed time marker.
Break Note
Break Note: A 'silent' track used to signify a block of time when something happens. This could be used to play commercial spots from the cartwall on PlayIt Live.
Set the Duration of the break and add a free-text note describing what the break is for.
Voice Track
Voice Track: A voice recording track used to play between tracks in order to give the impression that the radio show is live. Voice tracks can be recorded via PlayIt Live.
Set the Placeholder Duration used when the voice track has not yet been recorded, and add a short Description so the presenter knows what the link is for.
Remote URL
Remote URL: A remote URL item is used to play a remote file or live stream in PlayIt Live.
Enter a Title for the item, the URL to fetch, the Type (File or Live Stream), and the Duration of the item.
A File URL typically refers to a static file located on a server which is downloaded by PlayIt Live when it is loaded into a player. Remote files are intended to be a fixed length duration and this must be provided in order to ensure the item is scheduled with the correct length (as this is not known until load time).
A Live Stream URL typically refers to an audio stream provided by a streaming media server such as Icecast or Shoutcast and could be an internet radio station or a remote DJ stream. PlayIt Live assumes the live stream will run forever so will attempt to restart the stream if the connection is dropped. PlayIt Live will play the live stream until the specified duration has elapsed. Live streams can also be stopped manually, or by using a hard fixed time marker.
Advert Block
Advert Block: An advert block is used to schedule a block of adverts in PlayIt Live. The Start Time indicates the corresponding block in the advert log to schedule the adverts. Duration indicates the maximum length of all the adverts in the advert block. Slots indicates the maximum number of adverts that will play in the advert block.
Set the Start Time within the hour, the maximum Duration of the block, and the maximum number of Slots (adverts). Optionally pick an Opener Track and Closer Track that bookend the advert block.
Hook Sequence
Hook Sequence: A hook sequence will play only the hooks of tracks back to back within a short clip. This allows you to promote songs that will be playing within the next hour or just songs from a specific track group.
Give the sequence a Name, choose the Number of songs to include and the Target duration of the whole sequence in seconds.
Pick the Type:
Track Group Random picks the hooks at random from the chosen track group.
Coming Up, Coming Up (Reversed) and Coming Up (Random) pick the hooks from the songs that will be playing in the next N minutes or songs, in order, reverse order, or at random.
In Track, Transition Track and Out Track are optional bookend items inserted before, between and after the hooks. Pick a specific track or a track group from which the scheduler will choose.
Other columns
Segue?
Signals if the scheduled item will segue into the next item.
Segue Style
The segue style to use for the log item. See PlayIt Live documentation for how segue style is used.
Protected?
When this checkbox is checked the scheduled playout log item will have the same protected status. In PlayIt Live, protected items will not be dropped by Fixed Time Markers or the Auto Adjust feature. Use this for items that must be played during an hour, for example, advert blocks.
Per-row actions
Clone button
Clones the selected item to the next row. This is useful if you want to easily duplicate an item.
Delete button
Deletes the item row from the clock.
Reorder handle
Use the icon to reorder the clock items.
Each clock item is shown in colour: a solid stripe runs down the leftmost edge of the row and the whole row is given a faint tint of the same colour, making it easy to see at a glance what kind of item it is. Track Group items take the track group's configured colour, while other item types are tinted with a default colour for their type.
Overriding a clock's playout pattern requires the Advanced Scheduling module. You can try the module out by going to Settings > Licence and choosing to enable the Advanced Scheduling module.
The clock editor has two tabs: Clock Items (described above) and Playout Pattern. The Playout Pattern tab lets a single clock override the station's global playout pattern with its own. Most clocks should leave this alone so they follow the global pattern, but it is useful when one part of the schedule needs a different rotation from the rest of the station: for example, a dance show clock that overrides the station pattern so the hour is built from dance track groups rather than the station's usual rotation.
Open the Playout Pattern tab to control which playout pattern this clock uses.
Override playout pattern: When this checkbox is left unticked, the clock follows the station's global playout pattern and the picker below is disabled. Tick it to give this clock its own pattern; the picker becomes editable and pre-populated with the current global pattern as a starting point, which you can then adjust.
The pattern picker works exactly like the global playout pattern editor: send track groups from the Track Groups source list into the clock's Playout Pattern list, remove entries, and reorder them.
Overriding the playout pattern requires the Advanced Scheduling module. Without it the override is ignored and the global playout pattern is used instead; a warning is shown above the checkbox in that case.
The Playout Pattern tab is not available for partial clocks.
Use the Save button to save the clock to the database.
Use the Cancel button to discard all changes.
Use the Delete button to remove the clock from the database. A confirmation box will be shown.
Scheduling Clocks
Clocks must be scheduled in the schedule grid to be considered by the playout log scheduler.
This page describes the Clock Grids scheduling mode, the recommended way to schedule clocks in PlayIt Manager. Stations that still use the older calendar-based mode can refer to Legacy (Calendar) for documentation of that mode, or follow Migrating to Clock Grids to switch to the modern workflow. The active mode is chosen on the Scheduling Settings page and only one mode is shown at a time.
The Scheduling Clocks page has two views: a Clock Grids view for building reusable weekly templates, and a Schedule View that shows the resolved schedule on a calendar and lets you apply one-off overrides. Switch between the two views with the toggle at the top of the page.
Clock Grids view
The Clock Grids view is where you build and edit the weekly templates that drive the schedule. Each grid assigns a clock to each hour of the week and may be limited to specific date ranges or week recurrence rules. Multiple grids can be stacked using the Layer value, with higher-layer grids overlaying lower-layer grids; the lowest layer acts as the base template.
Single grid vs. Advanced Scheduling
A single clock grid is the simple case: one weekly template covers every hour of the week, and a single grid can always be used regardless of licence.
Stacking multiple grids in layers is the Advanced Scheduling workflow. You build a base weekly grid and then add additional grids on top for special periods. For example, a base Weekday grid at the lowest layer covers the normal week, while a Christmas Day grid on a higher layer fills only the hours of 25 December and is limited to that date range; every other hour falls through to the base grid. Layering grids this way requires a licence with the Advanced Scheduling module.
Note: Without the Advanced Scheduling module only a single clock grid takes effect. If more than one grid exists, only one stays active to keep the week fully covered, the others are shown as inactive, and a banner explains how to enable the rest.
Switch between the Clock Grids view and the Schedule View. The Clock Grids view is for editing weekly templates; the Schedule View shows the resolved schedule on a calendar and is where one-off overrides are made.
Lists every clock grid in PlayIt Manager. Select a grid to edit it in the panel on the right. The number on the right of each row is the grid's Layer: lower-numbered layers form the base of the schedule, and higher-numbered layers stack on top of the layers beneath them, overlaying any hours they cover. Each row also shows the grid's active date range, or Always Active when it has none. Use the button in the panel header to sort the list by layer.
When Advanced Scheduling is not licensed and more than one grid exists, the inactive grids are dimmed with a struck-through date range and a "no entry" icon whose tooltip explains that Advanced Scheduling is required to use more than one grid.
Use the Add button to create a new grid, Clone to duplicate the selected grid, and Delete to remove it.
Assign a clock to the grid by dragging it from the clock picker on the right and dropping it onto a cell. To fill several hours at once, select a block of cells first (drag across them, or hold Ctrl and click), then drop a clock onto the selection, or right-click and choose Assign to apply the clock currently selected in the picker. Use Week starts on to choose which day of the week the grid begins. Use Repeat every N weeks with Date Ranges to limit the grid to specific weeks (for example, every other week, or only within a date range).
When you add or edit a date range you can tick Ignore year on dates to make it repeat every year. Only the day and month are matched, so a Christmas grid set to 23 December to 2 January switches on automatically each festive season, including across the new year, without the dates needing to be updated. Recurring ranges are shown by day and month only.
Cells you leave empty in a higher-layer grid let the lower layer beneath show through, so an overlay grid only has to specify the hours it changes.
You can always check the effect of your combined grids in the Schedule View, which shows the resolved schedule for the week.
The colour and label of an assigned cell come from the clock set on the editing clocks page.
When Advanced Scheduling is not licensed
If your licence does not include the Advanced Scheduling module and you have more than one clock grid, the Clock Grids view shows a banner above the list, and the grids that are not taking effect are marked inactive in the list.
Schedule View
The Schedule View shows the resolved schedule as it will be evaluated by the playout log scheduler, with the active clock for every hour of the visible week. Hours can also be overridden one at a time without changing the underlying grids; overrides take precedence over every grid layer and are shown with a pin indicator.
Select the week you wish to view. Click Today to return to the current week. Use the arrows to step back and forward one week at a time. Click the week-of date label to open a calendar for picking a specific date.
Shows the resolved clock for every hour of the visible week, taking every active clock grid and any one-off overrides into account.
Double click an empty cell to create a new override and pick a clock for that hour. Double click an existing entry to change it, and use the context menu to clear an override and let the underlying clock grid take over again. You can also drag a clock across a block of cells to override several hours at once. Cell colours come from the clock set on the editing clocks page.
An hour cell shows the clock that will be used for that hour. The highlighted cell is driven by a one-off override, shown with a small pin so you can tell it apart from cells driven by a clock grid. Double click the cell to change its override, or use the right-click context menu to clear it and let the underlying clock grid take over again.
Legacy (Calendar)
Clock Grids is the recommended way to schedule clocks in PlayIt Manager. The Legacy (Calendar) mode documented on this page is the older view, kept for stations that have not yet moved to Clock Grids. New installations default to Clock Grids and most stations should use the modern editor described on the Scheduling Clocks page.
To switch your station to the modern view, see Migrating to Clock Grids below. The migration wizard converts your existing legacy schedule into a set of clock grids and keeps the original schedule stored so you can switch back if you need to. In Clock Grids mode a single weekly grid can always be used; layering multiple grids for special periods is the Advanced Scheduling workflow described on the Scheduling Clocks page.
Clocks must be scheduled in the schedule grid to be considered by the playout log scheduler.
The Legacy (Calendar) view is shown when Scheduling Settings > Clock Scheduling Mode is set to Legacy (Calendar). The schedule is presented as a weekly calendar with one row per hour and one column per day of the week. Schedule entries are placed by double-clicking an empty cell or edited by double-clicking an existing entry.
Select the date range you wish to schedule clocks for. Click Today to go to the week or day for today. Use the arrows to advance weeks or days depending on the view. Click the calendar icon to select a specific date range.
Double click an empty space in the schedule grid to create a new schedule entry. The Edit Schedule Item dialog opens with the start time pre-filled from the cell you clicked, ready for you to pick a clock and, if needed, set up a recurrence.
Double click an existing schedule entry in the schedule grid to edit it in the Edit Schedule Item dialog. Click the X on the entry to delete the schedule entry. The colour of the schedule item is determined by the colour set on the clock when editing clocks.
Editing a schedule item
Double-click an existing entry in the schedule, or double-click an empty cell to create a new entry, to open the Edit Schedule Item dialog. For a recurring entry you will first be asked whether you want to edit only this occurrence, this and all future occurrences, or every occurrence; this dialog appears once you have made that choice.
The dialog lets you change which clock is scheduled, when the entry starts, and, when Repeat... is ticked, the full recurrence rule (period, frequency, allowed days and hours, and end date).
Pick when the recurrence should end. Forever keeps the schedule entry repeating indefinitely. This Time: stops the recurrence at the chosen date and time (inclusive).
Delete removes the schedule entry from the database after a confirmation prompt. For a recurring entry the confirmation lets you choose whether to delete only this occurrence, this and all future occurrences, or every occurrence.
Save Changes saves the schedule entry. Cancel discards the changes and closes the dialog.
Migrating to Clock Grids
Clock Grids is the modern, recommended way to schedule clocks in PlayIt Manager. It replaces the weekly calendar of the Legacy (Calendar) view described above with reusable weekly templates that can be stacked in layers, limited to date ranges, and combined with one-off overrides from the Schedule View.
If your station is still on Legacy (Calendar), the in-app migration wizard converts your existing schedule into a set of clock grids, switches the station to Clock Grids mode, and keeps the original legacy schedule stored in case you want to switch back. Nothing is deleted.
Why migrate
Clock Grids gives you several capabilities that the Legacy (Calendar) view does not:
Layered grids. Build a base weekly template, then stack overlays on top for special weeks (festive periods, sports seasons, outside-broadcast days). Higher layers override lower ones only for the cells they fill. Layering multiple grids this way is the Advanced Scheduling workflow and needs a licence with the Advanced Scheduling module; a single grid can always be used. See Single grid vs. Advanced Scheduling.
Reusable templates. Each grid is a named weekly template that can be limited to specific date ranges or to every Nth week. The same template can apply for months at a time without re-entering it.
Schedule View with overrides. A separate Schedule View shows the resolved week and lets you pin a one-off clock to a single hour without changing the underlying templates.
A modern editor. The Clock Grids editor edits a whole grid at a glance rather than one schedule entry at a time.
When you open Scheduling Clocks while the station is still in Legacy (Calendar) mode, a banner appears above the weekly calendar offering to migrate.
The banner explains that Clock Grids is available and that nothing will be deleted. Your existing Legacy (Calendar) schedule is kept stored after migration so you can switch back at any time from Settings > Scheduling.
Click Migrate and Switch to open the migration wizard. The banner also offers Switch Without Migrating (move to an empty Clock Grids workspace without bringing your legacy schedule across) and Dismiss (hide the banner on this browser without changing anything).
The banner only appears in Legacy (Calendar) mode. If your station is already in Clock Grids mode, the banner is not shown.
The migration wizard
Clicking Migrate and Switch opens the migration wizard. The first step analyses your legacy schedule to work out which weekly clock grids will best represent it.
The wizard runs in three steps: Analyse Schedule, Review Grids, and Migration Complete.
Choose how many weeks of your existing schedule to look at when building the clock grids. A larger horizon catches more variation (for example, an every-other-week pattern that only shows up after several weeks) but takes longer. The default of five weeks is a good starting point.
Click Analyse to build the proposed set of clock grids. The wizard then advances to the Review Grids step where each proposed grid is shown with its name, layer, recurrence, active dates, and the number of hours it covers, so you can confirm the conversion before applying it. Cancel closes the wizard without making any changes.
What migration does
When you confirm the Review Grids step, the wizard:
Creates one or more clock grids that together reproduce the resolved schedule the playout log scheduler would have used from Legacy (Calendar). Grids that only apply on certain weeks or within certain date ranges are created with the matching recurrence and date range limits.
Marks every created grid as migrated from legacy so the editor labels them in the grid list. You can edit migrated grids like any other grid; the label is informational.
Switches the station to Clock Grids mode and reloads the Scheduling Clocks page so the new editor appears.
Grids the wizard creates stay active even if your licence does not include the Advanced Scheduling module, so your migrated schedule keeps working whether or not Advanced Scheduling is licensed. Only additional non-migrated grids you build by hand require Advanced Scheduling. See Single grid vs. Advanced Scheduling.
The original Legacy (Calendar) schedule is kept stored even after migration. It stops taking effect, but you can switch back to Legacy mode from Settings > Scheduling > Clock Scheduling Mode at any time and your previous schedule will be there as you left it.
If you have already migrated once and run the wizard again, the Review Grids step warns you how many existing migrated grids will be replaced. Any grids you have created by hand are left alone.
If a small number of hours in the legacy schedule do not fit any weekly pattern within the chosen horizon, the Review Grids step shows a warning telling you how many hours will be dropped. Increase the horizon to give the wizard more weeks to find a pattern, or accept the warning and add those hours back in the Clock Grids editor or add them as overrides in the Schedule View afterwards.
After migration
After the wizard finishes, the Scheduling Clocks page reloads in Clock Grids mode. See Scheduling Clocks for the new editor and for the Schedule View where one-off overrides are applied.
Playout Log Management
The playout log lists past and future events scheduled to take place from hour to hour. Based on the clocks that have been scheduled, the playout log scheduler will generate playout log items matching each clock item. If a clock has not been scheduled for an hour, the playout pattern will be used to generate the playout log items.
The Playout Log page opens scoped to the current hour by default. Adjust the Start and End date and time to view the scheduled log for any other range, then click Start Editing Log to arm the page for changes.
The end of the time range to view. The range may span as many hours as you need but a wide range will take longer to schedule and may be slow to render.
Click this button to arm the page for editing. Until you click it, the Schedule, Unschedule, Import..., Export... and Save actions on the editing playout log page are disabled and the date range fields stay editable. While editing, the date range is locked and the action buttons become enabled.
Editing Playout Log
After picking a date range and clicking Start Editing Log, the page enters editing mode. The action buttons at the top become enabled, the date range is locked, the item list becomes editable, and a Save / Revert row appears at the bottom.
This banner is shown for the duration of an editing session. When the current hour falls within the selected date range, the banner switches to a red warning, reminding you that any change here can be disruptive to the operator running PlayIt Live live on air.
Schedule runs the playout log scheduler over the selected date range, generating items from the clocks that have been scheduled to those hours (or from the playout pattern when no clock is scheduled).
Unschedule clears every item in the selected date range. Use this when you want to reschedule the range from scratch. Changes are not applied until you click Save.
Import opens the import dialog, which replaces the items in the selected date range with the contents of an external file (PlayIt, M3U or SS32 format).
Export downloads the items currently in the date range as a .pipl file in PlayIt Playout Log Format, which can later be imported into a different time range.
The grid shows every item scheduled for the selected date range, grouped by hour and sorted by their position within the hour. Drag the handle in the leftmost column to reorder items.
The columns (Play Time, Hour Pos., Type, Settings, Segue?, Segue Style, Protected?), the per-row Clone and Delete buttons, and the per-type settings editors (Track, Track Group, Fixed Time Marker, Break Note, Voice Track, Remote URL, Advert Block, Hook Sequence) are the same as on the clock item list. See Editing Clock for the full reference.
Two columns specific to the playout log appear before Type:
Played? A tick is shown for items that have already been played by PlayIt Live.
Hour Pos. The position of the item within its hour. This is recalculated automatically when items are added, removed or reordered.
Each log item is shown in colour. A solid stripe runs down the leftmost edge of the row, and the whole row is given a faint tint of the same colour, so you can scan the hour and tell items apart at a glance.
The highlighted row above is a Track taken from a red track group: it carries that group's configured colour. A fixed Track uses the colour of the track group it was added from, while items that are not associated with a track group are tinted with a default colour for their type. This matches the colouring shown on the clock item list.
Save writes every change in the selected date range to the database and exits editing mode. PlayIt Live will pick up the new items the next time it polls the manager.
Revert discards every change and exits editing mode without writing to the database.
Importing Playout Log
The Import button on the editing playout log page opens the Import Playout Log popup, which replaces the entire selected date range with the contents of an external file. The button is disabled until you click Start Editing Log.
The importer supports three formats:
PlayIt Playout Log Format (.pipl): see the PlayIt Playout Log Format reference. This is the only format that round-trips every PlayIt item type, including voice tracks, fixed time markers, remote URLs and advert blocks.
M3U Playlist (.m3u, .m3u8): see the M3U Playlist Format reference. This is a simple playlist format supported by most basic media players.
Scott Studios (SS32): supported for backward compatibility only. This format is deprecated and will be removed in a future update; please contact support if you rely on it.
When a file is imported, the existing items in the selected date range are cleared and replaced. The import is staged in the editing session and is only written to the database when you click Save on the editing playout log page.
The format of the file being imported. Pick PlayIt Playout Log Format for .pipl files exported from PlayIt Manager, M3U Playlist for .m3u / .m3u8 files, or Scott Studios (SS32) for legacy SS32 exports.
Optional base folder used to resolve relative track paths in M3U and SS32 files. The folder is prepended to each relative path so PlayIt Live can locate the audio files. The PlayIt format always uses absolute paths so this field is ignored when importing .pipl files.
The destination date range. Defaults to the date range that was selected on the playout log page when the popup was opened. The duration of the import file content must match the duration of this range; if it does not, a validation message is shown when you click Import, along with a button to set the range to the expected end time.
Validates the file against the selected format and date range and stages the items into the editing session. If validation fails the popup stays open and a list of error messages appears below the date range fields.
Closes the popup without importing. The editing session is unaffected.
PlayIt Playout Log Format
PlayIt Manager can export the contents of any date range from the editing playout log screen as a .pipl file, and can import the same file back into a date range from the importing playout log screen.
The full specification, together with an online validator that checks an exported log file against the specification, is hosted on a dedicated site:
Use the .pipl format when you want a round-trippable export of a PlayIt Manager log that preserves every item type, including fixed time markers, voice tracks, remote URLs and advert blocks. For interchange with third-party scheduling tools that only emit a playlist of tracks, use the M3U Playlist Format instead.
M3U Playlist Format
The M3U playlist format is a simple list of audio file paths, one per line. PlayIt Manager extends the format with special # comment directives so the imported log can include fixed time markers, break notes, voice tracks, remote URLs and aux inputs alongside regular tracks.
Hours
Tracks are grouped into hours using a # Hour: directive. The directive must appear on its own line and is followed by the start time of the hour in HH:mm format. Every track that follows the directive (until the next # Hour: directive) is placed in that hour:
# Hour: 00:00G:\PlayIt User\Music\Jingles\Publicise Your Event ID.mp3G:\PlayIt User\Music\Songs\Sam and the Womp - Bom Bom.mp3G:\PlayIt User\Music\Songs\Fenech-Soler - All I Know.mp3...# Hour: 01:00G:\PlayIt User\Music\Jingles\City Locations ID A.mp3G:\PlayIt User\Music\Songs\Lianne La Havas - Is Your Love Big Enough.mp3G:\PlayIt User\Music\Songs\Of Monsters and Men - Mountain Sound.mp3G:\PlayIt User\Music\Jingles\Contact Studio On Text & Email ID.mp3
Track paths
Track paths may be absolute or relative. When the paths are relative, the Base Audio Folder field on the importing playout log screen is prepended to each path to produce an absolute path that PlayIt Live can resolve.
Fixed time markers
Fixed time markers ensure time keeping within an hour. Use a # Fixed Time Marker: directive with Type= and TargetTime= parameters. The Type may be Hard, Soft or NotBefore, and the TargetTime is the position within the hour expressed as <minutes>m<seconds>s:
# Fixed Time Marker: Type=Hard; TargetTime=3m02s# Fixed Time Marker: Type=Soft; TargetTime=3m# Fixed Time Marker: Type=NotBefore; TargetTime=5s
See the editing clock page for an explanation of how each fixed time marker type behaves at playout.
Break notes
A break note inserts a silent placeholder of a known duration. Use a # Break Note: directive with Duration= and Notes= parameters. The Notes text appears in the log so the operator knows what the break is for:
# Break Note: Duration=1m1s; Notes="News on the hour"
Voice tracks
A voice track placeholder reserves a slot for a recording that will be added later. Use a # Voice Track Placeholder: directive with a Duration parameter:
# Voice Track Placeholder: Duration 1m
Remote URLs
A remote URL plays a remote audio file or live stream in PlayIt Live. Use a # URL: directive with Duration=, Title=, URL= and Type= parameters. The Type is either File for a static file with a known duration, or Live for a continuous live stream:
An aux input plays audio from a sound device attached to the PlayIt Live machine. Use a # Aux Input: directive with Duration=, Title= and DeviceName= parameters. The DeviceName must match the name of an input device configured in PlayIt Live:
# Aux Input: Duration=2m; Title="Sky News"; DeviceName="Microphone (USB Audio Codec)"
Logged Tracks
The Logged Tracks list shows every track that has been played, each stored with the date and time it went to air. It is a permanent record of your output, often called a "proof of play" or "as-run" log, used mainly for royalty reporting and reconciliation.
Across the top of the page are four buttons that set the period the list covers. Click one to choose how far back the list reaches:
Past 24 hours shows tracks played in the last 24 hours.
Past 7 days shows tracks played in the last 7 days.
Past 30 days shows tracks played in the last 30 days.
Custom lets you choose your own start and end date and time.
The page opens on Past 24 hours, and the list refreshes automatically when you switch between the presets. When you choose Custom, a start and an end date and time input appear, separated by a to label, with a Go button; set the start and end points and click Go to reload the list for that range.
The Export to CSV... button takes the record out of PlayIt Manager for a royalty submission, for reconciliation, or for your own analysis. It downloads the current date range as a spreadsheet file. See Exporting Logged Tracks for the full process, including choosing which fields to include.
The list shows one row per play, sorted with the most recent first. The Played column gives the date and time the track went to air and the Track column shows its artist and title.
A track is recorded here when it actually plays on air, so the list reflects what was genuinely broadcast rather than what was merely scheduled.
Exporting Logged Tracks
The Export to CSV... button downloads the tracks for the date range you are viewing as a CSV (comma separated values) file, which opens in Microsoft Excel, Google Sheets or any spreadsheet application.
Exporting to CSV
A typical job is preparing a monthly royalty return. To export a full calendar month:
On the Logged Tracks page, set the date range to cover the month. Click Custom, set the start date and time to the first day of the month at 00:00 and the end date and time to the first day of the following month at 00:00, then click Go. (For shorter periods you can use the Past 7 days or Past 30 days buttons instead.)
Click Export to CSV.... A dialog appears so you can choose which fields to include in the file.
Tick the fields you need, then click Export. The CSV file downloads to your browser, named after the date range, for example logged-tracks-2026-05-01-000000-to-2026-06-01-000000.csv.
The export always covers the date range currently selected on the page, so set the range before you export.
The available fields, each with a checkbox: Played Time, Artist, Title, Album, ISRC, Record Label, Duration, Comments, Genre, File Path, Tags and Type. Played Time, Artist and Title are ticked by default; the rest are unticked.
Export downloads the file once at least one field is ticked; Cancel closes the dialog without exporting.
Choosing which fields to export
The dialog lists every field that can be written to the CSV. By default Played Time, Artist and Title are ticked, which is enough for a basic proof-of-play return. PlayIt Manager remembers your selection in your browser, so the next time you export it offers the same set of fields.
Use Select All to tick every field or Select None to clear them, then tick the individual fields you want. The available fields are:
Played Time - the date and time the track went to air.
Artist and Title - the performer and track name.
Album - the album the track is from.
ISRC - the International Standard Recording Code, often required by royalty bodies to identify a specific recording.
Record Label - the label that released the recording.
Duration - the length of the track.
Comments - any notes stored against the track.
Genre - the track's genre.
File Path - the location of the audio file.
Tags - any tags applied to the track.
Type - the kind of item, for example a song or a jingle.
For a royalty submission you would typically add fields such as ISRC, Record Label, Album and Duration alongside the defaults, because these are the details collection societies ask for.
The Export button is enabled as long as at least one field is ticked. Click it to download the file; the dialog closes and the CSV is saved by your browser. Each row in the file is one play, in the order it went to air, with one column per field you selected.
Purchasing the Advanced Scheduling module unlocks advert scheduling: building advert campaigns, scheduling the advert log and playing advert blocks in PlayIt Live.
Without a valid Advanced Scheduling module applied it is not possible to schedule the advert log or play advert blocks. You can try the module out by going to Settings > Licence and choosing to enable the Advanced Scheduling module.
Advert scheduling allows the scheduling of adverts (also called spots, commercials or traffic). This is accomplished by setting up advert campaigns containing adverts, then adding an advert block to the playout log and scheduling the advert log for that hour.
Key concepts
Advert Campaign
An advert campaign represents an advert sales order: a request from a customer to play a set of adverts a specified number of times, during certain times of the day, for a period of time. Advert campaigns in the same category will never be scheduled in the same block. See Advert Campaigns and Editing Advert Campaigns.
Advert
An advert represents a cut of audio to play as part of an advert campaign. An advert also stores at what times of the day the audio will play, up to a maximum number of plays. Adverts feature a duration field which is used to schedule the advert. This is best kept to a multiple of 5, for example 10, 15 or 30 seconds, to ensure that adverts can be fitted into advert blocks of 1 minute, 2 minutes, and so on. See Editing Adverts.
Advert Block
An advert block is a sequence of adverts that are played together as part of the advert log.
Advert Log
The historical log and future log of the adverts that have played and will play. See Advert Log.
Advert Block Item
An advert block item can be added to a clock or the playout log in order to actually play out the adverts.
Adding an advert block item to the playout log instructs the playout engine to look up the adverts from the advert log for the specified hour and start time and load them into a player. Despite being multiple tracks, advert block items only take up one player: the same player is reused for each advert track.
Adding an advert block item to a clock will add the equivalent item to the playout log for any hour the clock is scheduled into.
Editing Advert Campaigns: set the name, dates, categories, adverts and scheduling rules for a campaign.
Editing Adverts: configure an individual advert's track, priority, dates, maximum plays and day/hour distribution.
Advert Log: view the scheduled advert plays for a date range, grouped by hour.
Advert Campaigns
The advert campaigns page lists the advert campaigns currently in PlayIt Manager. Each campaign groups together the adverts for a customer or sales order. See Advert Scheduling for how campaigns, adverts and the advert log fit together.