Airtime 2.1 for Broadcasters

Calendar

The Calendar page of the Airtime administration interface has three views: day, week and month, which can be switched using the grey buttons in the top right corner. By default, the month view is shown, with today's date highlighted by a pale green background.

In the top left corner of the page, you can go back or forward through the Calendar by clicking on the buttons which have a small grey triangle in a white circle. Click the today button to jump to today's date in the current view. (The today button will be greyed out if you are already viewing that date). In the day or week views, there is also a drop-down menu which allows you to set the resolution displayed for the calendar, ranging from one minute per row to sixty minutes per row.

Adding a show

Only Admins and Program Managers can use this feature. To add a new show to the Calendar, click the + Show button in the top left corner of the page, or click on any future row or box in the Calendar which is empty. Either of these actions opens the Add this show box, which has six sections, arranged vertically: What, When, Live Stream Input, Record & Rebroadcast, Who, and Style. Click the small black triangle to the left of the section name if you wish to minimize or maximize it.

What

In the What box, enter the Name, public website URL, Genre and Description for the show that you are creating.

When

Next, in the When section, if you clicked on a date in the Calendar this should already be entered in the Date/Time Start field. To set another date for the show, click on the date in the Date/Time Start field and select the date that you require from the small pop-up calendar which will appear. Click on the adjacent time field to set the start time for the show, with the pop-up Hour and Minute box. The Minute values in the pop-up time boxes are rounded to the nearest five minutes. You can also adjust the times manually by clicking into the fields and typing. Repeat the process to set the Date/Time End fields. The Duration of the show will be displayed automatically, based on the start and end times you have set.

Airtime will only allow you to enter valid times for shows. If you attempt to schedule show times which would be impossible, Airtime will display a warning message.

To schedule a regular show, check the Repeats? box and select either weekly, bi-weekly or monthly from the Repeat Type drop-down menu that will appear. Then check the boxes for the days of the week that you want to schedule the regular show on. Uncheck the No End? box and set the Date End for the regular show to finish, or leave the No End? box checked to schedule the show indefinitely.

Live Stream Input

The Live Stream Input section can be used to enable live input streams during the show, and also to configure authentication for them. If you check the Use Airtime Authentication box, the DJs (presenters) of the show will be able to connect a live stream to Airtime's Show Source Mount Point using their login name and password. See the chapter Stream Settings for details.

If you check the Use Custom Authentication box instead, you can set a one-time username and password pair for live stream input to the show. For example, you may wish to create an authenticated live stream input for a particular remote news reporter, without providing any further access to your Airtime server for that person.

A reminder of the Connection URL for the live input stream to use is shown at the end of the Live Stream Input section.

Record & Rebroadcast

In the Record & Rebroadcast section, checking the Record from Line In? box enables automatic recording of the soundcard line input, if your Airtime server has one, at the time of the show. Shows set for live recording should not also contain files or playlists. The audio format for live recordings is 256kbps Ogg Vorbis, and the files are saved in the recorded folder, under the Import Folder path set in the Media Folders page on the System menu.

If you wish the recording to be played out at a later time, check the Rebroadcast? box, and then select up to ten date and time slots in the Choose Days box.

Shows set for recording have a small red dot icon in the calendar, while rebroadcast shows have a white loop icon.

Who

In the Who section, type the first few letters of the name of the show's DJ (presenter) in the Search Users field to select a name from the Airtime database, or check one of the DJs boxes in the vertical list below. This association of a DJ name with a particular show enables that presenter to add playout media to the show, and also to connect a live input stream (if that has been enabled), so it is important to get the DJ's name right.

Style

Finally, select a Background Colour and Text Colour by clicking the boxes in the Style section, so that the new show can be easily identified in the Calendar. Click the coloured circle icon in the lower right corner to close this pop-up window.

 

Click the Add this show button at the top or bottom of the box. The new show will now be displayed in the Calendar, with a regular slot if you have chosen to schedule one. 

Editing a show

Show configuration and metadata can be changed at any time until broadcast of that show commences. Click the show in the Calendar, and select Edit Show from the pop-up context menu. This opens the Update Show box, which is almost exactly the same as the Add this Show box. Click the + Update show button at the top or bottom of the box when you are done.

Alternatively, individual shows can be clicked on and dragged to new days and times in the calendar. However, Airtime will not allow you to drag a future show into the past, or drag and drop instances of a repeated show. In the Day and Week views, show length can be adjusted by clicking on the lower edge of the show box, and dragging the edge of the box upwards or downwards. The new show length is calculated automatically.

Adding content to a show

To add content to a show, click the show in any view on the Calendar, and select Add/Remove Content from the pop-up menu.

This action opens a window with the name of the show. Like when using the Playlist Builder to find files, you can search for files or playlists and drag them into the show schedule on the right side of the page.

Alternatively, use the selection button (with the square icon) or the checkboxes in the first column of the search results to add items to the show, by selecting the items you require, then clicking the plus icon button.

The pink row at the end of the show items table updates automatically to display how much time remains of the allocated show duration, in a red font. Also, a red exclamation mark indicates if the show is not yet complete. This changes to a green check mark when the show duration is reached.

If you add too much media for the duration of the show, Airtime will display the extra minutes and seconds in the last row, in a green font, and playout will be faded when the show ends. Click any item you wish to remove from the show, then click Delete on the pop-up menu, or check the box in the item's row then click the Trashcan icon at the top of the table.

When your show has all the required content, click the OK button in the bottom right corner to close the window. Back in the Calendar, click the show and select Show content from the pop-up menu to view a list of content now included in the show.

The Contents of Show window is a read-only interface featuring an orange bar which indicates how much media has been added to the show. Click the OK button in the bottom right corner, or the white x icon in the top right corner, to close the window.

Removing content from a show

To remove an individual file or playlist from a show, click on the show in the Calendar, and select Add/Remove Content from the pop-up menu. In the window which opens, click any item you wish to remove from the show, then click Delete on the pop-up menu, or check the box in the item's row then click the Trashcan icon at the top of the table. To remove all files and playlists from a show, click on the show in the Calendar, and select Remove All Content from the pop-up menu. 

Deleting a forthcoming show

To delete one instance of a forthcoming show, click on the show in the Calendar, and select Delete, then Delete This Instance from the pop-up menu. If you wish to delete all future instances of this particular show, select Delete This Instance and All Following from the pop-up menu.

You cannot delete or remove content from shows that have already played out. These shows have only one option on the pop-up menu, which is Show Content.

Canceling playout

If you wish to cancel playout of a playlist-based or pre-recorded show while it is running, click on the show in the Calendar and select Cancel Current Show from the pop-up menu. Airtime will ask you if you are sure about this action in a dialog box, as it cannot be undone.