Home

airtime 2 for broadcasters - Index of

image

Contents

1. Cancel If you have chosen to save the package to your computer instead in the desktop file manager right click on the airtime easy setup package and select Open with GDebi Package Installer 93 Downloads File Browser File Edit View Go Bookmarks Help 4 e ES A 100 Iconvi Places v X daniel Downloads daniel 3 Desktop File System airtime easy setup Network deb Rubbish Bin Open with GDebi Package installer Music amp Open with Archive Manager Open with Other Application 64studio Cut Copy Or for an Ubuntu lucid or Debian squeeze server without a desktop you can use gdebi on the command line sudo apt get update sudo gdebi airtime easy setup deb If gdebi is not installed you can run this command first sudo apt get install gdebi Later versions of Ubuntu have replaced GDebi with the program software center Ona desktop installation right click on the package and select Open with Ubuntu Software Center T his desktop program can also be run from the command line for example software center airtime easy setup deb Any of the methods above should resolve package dependencies automatically INSTALL AIRTIME Once the installation of airtime easy setup has completed you can install che latest Airtime package on a desktop system using your usual package manager such as Ubuntu Software Center or Synaptic on Debian u Software Centre
2. conne Icecast Vorbis Metadata Enabled Stream Label Stream Type Artist Title Show Artist Title Station name Show name Bit Rate INPUT STREAM SETTINGS On the lower left side of the Stream Settings page you can configure remote live input streams from DJ programs such as Mixxx or IDJC or smartphone applications used by broadcast journalists Airtime supports two types of live input stream the Show Source which enables a specific person to stream in during their own show and the Master Source which can override the Show Source if necessary If neither type of live input is available Airtime will fall back to Scheduled Play playlists and files scheduled in Airtime in advance of a show The Auto Source Transition checkbox enables playout to be switched automatically to the highest priority source whenever an authenticated input source connects to or disconnects from Airtime T he field Switch Transition Fade sets the length of the audio fade as scheduled playout is switched to a remote input stream and back T he default transition fade setting is half a second 28 Each type of input stream requires a username and password before the remote broadcaster can connect to Airtime The Master Username and Master Password can be set in the Input Stream Settings box while the authentication for individual Show Sources is set up in Airtime s schedule calendar See the Calendar chapter for details Input streams m
3. 610B Fetched 3 610B in Os 12 3kB s Selecting previously deselected package sourcefabric keyring Reading database 348822 files and directories currently installed Unpacking sourcefabric keyring from sourcefabric keyring O 1 all deb Setting up sourcefabric keyring 0 1 daniel office Update your computer s software sources again to confirm that you are now using a trusted software repository sudo apt get update You should no longer see the error message about the missing public key INSTALL THE DATABASE MANAGEMENT SYSTEM Airtime uses a PostgreSQL database to keep track of media assets and associated metadata in its storage server Depending on the scale of your Airtime installation and the hardware available you may wish to install PostgreSQL ona separate server If you only have one server you can install the postgresql package on the same machine as Airtime with the command sudo apt get install postgresql 98 INSTALL A STREAMING SERVER Optionally you may wish to stream directly from Airtime to an Icecast media distribution server without requiring a soundcard or mixer in the broadcast chain T his option is particularly suitable for fully automated stations in which all shows are played out using Airtime You can install the icecast2 package on your server with the command sudo apt get install icecast2 In some scenarios you may wish to stream from Airtime to a remote lcecast server for exam
4. If you are installing Airtime on a desktop computer make sure you disable or remove any programs that could send unintended audio to a sound card you are using for broadcast output This includes alert sounds which play when the computer is ready for use or when a user logs in On Ubuntu these sounds are configured using System gt Preferences gt Sound on the main desktop menu T his configuration dialogue only works when the PulseAudio sound server is installed You may prefer to remove all system sound files from the computer in case they could be played unintentionally via the sound card For example on Ubuntu you may wish to remove the ubuntu sounds package with the following command sudo apt get purge ubuntu sounds PULSEAUDIO T he PulseAudio sound server is not recommended for Airtime sound card output but is installed by default on Ubuntu T o remove PulseAudio from an Ubuntu machine type the following command sudo apt get purge pulseaudio Removing the pulseaudio package on a desktop Ubuntu machine may force the removal of the ubuntu desktop metapackage However this metapackage is only installed on the system for managing upgrades removing it does not remove the GNOME desktop After removing PulseAudio if your Airtime machine has a desktop you can install a mixer applet which can control the ALSA soundcard driver directly such as gnome alsamixer sudo apt get install gnome alsamixer On a server with a soun
5. Press Ctrl O to save the file then Ctrl X to exit nano Then restart Monit with sudo invoke rc d monit restart 132 More information about using Monit is available at http mmonit com monit documentation 133 ADVANCED CONFIGURATION 33 AUTOMATED FILE IMPORT 34 ICECAST HANDOVER 35 PROMOTING YOUR STATION 36 STREAM PLAYER FOR YOUR WEBSITE 37 EXPORTING THE SCHEDULE 38 INTERFACE CUSTOMIZATION 33 e AUTOMATED FILE IMPORT T he airtimeimport script can be combined with the standard SFTP secure FT P program and cron daemon on a GNU Linux server to enable automated file import from multiple remote computers T his could save time for your station staff when using distributed production methods or content syndication T raditional FT P servers use plain text passwords without encryption and are therefore not recommended for upload accounts on Airtime servers accessible from the public Internet SFT P is a cross platform protocol which works with many desktop programs including gFTP for GNU Linux http www gftp org T his program can be installed on Debian or Ubuntu desktop computers with the command sudo apt get install gftp Other popular SFT P clients include FileZilla for Windows http filezilla project org and Cyberduck for Mac and Windows http cyberduck ch To enable SFTP uploads first invoke the adduser command to create the uploads account on the server For security reasons this user account
6. 1 by Ubuntu The open radio software for mote station management ftware TETUM More Info Install Get Software gt Search Results airtime d Metapackage for the Airtime broadcast server airtime easy install me audio samples for the Airtime broadcast server airtime audio samples On a server you can use the commands 94 sudo apt get update sudo apt get install airtime CONFIGURE FOR PRODUCTION T o convert a test installation into a production installation you can run the command sudo dpkg reconfigure airtime T he dkpg reconfigure command will run through the configuration steps shown in the Automated installation chapter so that you can set the correct hostnames and passwords for your production Airtime server 95 2 3 e AUTOMATED INSTALLATION This installation method is intended for computers running Ubuntu or Debian GNU Linux and is the recommended method for production Airtime systems If you have previously performed a manual installation of Airtime on the server you should run the airtime uninstall script to remove it before setting up the server for automated installation SET UP REPOSITORIES FOR UBUNTU When installing on an Ubuntu server a few of the packages that Airtime relies on are in the Ubuntu universe or multiverse repositories If either of these repositories is disabled you can enable them in the etc apt sources ist file by opening the nano editor in your server s
7. 12 13 00 12 17 58 4 57 1 Plutonius Recloose Re dub d 12 17 58 12 22 13 4 15 3 Space Traveller Nick Speed remix 4 12 22 13 12 25 32 3 18 8 Miss Millie feat Kings go Forth Dabrye s Synthesiz 4 12 25 32 12 32 29 6 57 6 Only Good For Ectomorph 12 32 29 12 36 25 3 55 4 7th Galaxy feat Jamall Bufford 14KT remix 12 36 25 12 40 08 3 43 6 All Your Goodies Are Gone feat Mayer Hawthorne Bet You Version DeepSeeSoundSystem mix m m m m m mm In the library table which opens use the drop down menu at the top to choose from Files Playlists or All items By default 10 items are listed but you can click the Show drop down menu to change the list length to between 5 and 100 items The search field on the top left with a magnifying glass icon can be used to refine your selection Like an Internet search engine you do not have to type in the correct upper or lower case press the Enter key or even type the whole of the search term before matches from the Airtime library are displayed This search field enables the selection of items based on any tag metadata stored in the Airtime database whether that metadata is displayed in the table or not Click the Show hide columns button in this table to determine which metadata is displayed S eee DT T Show hide columns For example if all of your jingles are tagged with the Genre of Jingle you can
8. 135 34 35 36 37 38 APPENDIX 39 40 4l Icecast handover Promoting your station Stream player for your website Exporting the schedule Interface customization Expert install HD Audio Models About this manual 137 139 140 142 149 152 153 159 INTRODUCTION I WHAT IS AIRTIME 2 RIGHTS AND ROYALTIES e WHAT IS AIRTIME Updated for Airtime 2 1 3 Airtime is the open broadcast software for scheduling and remote station management Web browser access to the station s media library multi file upload and automatic metadata verification features are coupled with a collaborative on line scheduling calendar and playlist management T he scheduling calendar is managed through an easy to use interface and triggers playout with sub second precision Airtime Mozilla Firefox Ble Edit View History Bookmarks 10015 Help Airtime i example com or amp Tony Alh SIAVO e Jimi Tenor amp Tony Allen Three continent Tenor amp Allen Show X ON AIR 15 05 00 USTEN BST 22250 E E Filtar By Show niin ess 2012 05 30 1500 1600 15 13 51 Jimi Tenor amp Tony Allen inspiration Information 15 20 04 349 5 Selfish Gene Jimi Tencr amp Tony Allen inspiration Information 15 23 54 5495 Path To Wisdom Jimi Tenor amp Tony Alien inspiration Information 15 29 43 5 11 3 Mama Engand Jimi Tenor amp Tony Allen Inspiration Information 7583 Got My
9. Entering the command without any options returns a list of options that you can specify sudo airtime log Usage airtime log options view v string Display log file media monitor recorder playout liquidsoap web dump d string Collect all log files and compress into a tarball media monitor recorder playout liquidsoap web ALL by default tail t string View any new entries appended to log files in real time media monitor recorder playout liquidsoap web ALL by default For example to view the media monitor log you could use the command sudo airtime log v media monitor The server console will display something like the following output 2011 11 29 09 32 45 750 INFO MainThread MediaMonitor py lt module gt LINE 32 xxx Media Monitor bootup 2011 11 29 09 32 45 864 INFO MainThread MediaMonitor py lt module gt LINE 39 Setting up monitor 2011 11 29 09 32 46 058 INFO MainThread api client py setup media monitor LINE 405 C onnected to Airtime Server Json Media Storage Dir u watched dirs u stor u srv airtime stor 2011 11 29 09 32 51 061 INFO MainThread MediaMonitor py lt module gt LINE 47 Storage Di rectory is srv airtime stor 2011 11 29 09 32 51 066 INFO MainThread MediaMonitor py lt module gt LINE 54 Initializin g event processor 2011 11 29 09 32 51 364 INFO MainThread airtimemediamonitorbootstrap py scan
10. LINE 29 watched directories found u 1 u srv airtime stor j3 Use the PageUp and PageDown keys on your keyboard to navigate through the log file or press the q key to quit the viewer T o dump all log files and compress them into a tarball placed in the working directory you could add the d switch to the command sudo airtime log d Creating Airtime logs tgz file at root logs airtime 10g all 2011 11 29 12 43 20 tgz To view just the Liquidsoap log output in real time you could enter the command sudo airtime log t liquidsoap Tail liquidsoap 10g2011 11 29 11 44 41 fallback 4892 3 Switch to src 4890 with forgetful transit ion 2011 11 29 11 44 41 lang 3 usr lib airtime pypo bin liquidsoap scripts notify sh data 2 m edia id 2011 11 29 12 10 06 server 3 New client localhost 2011 11 29 12 10 06 server 3 Client localhost disconnected 2011 11 29 12 10 06 server 3 New client localhost 122 2011 11 29 12 10 06 2011 11 29 12 10 29 2011 11 29 12 10 29 2011 11 29 12 10 29 2011 11 29 12 10 29 server server server server server 3 3 3 3 3 Client localhost disconnected New client localhost Client localhost disconnected New client localhost Client localhost disconnected Press the Ctrl C keys to interrupt the real time log output and return to the server console 123 29 BACKING UP THE SERVER T he following shell commands can be used for database backup
11. You may convey a covered work in object code form under the terms of sections 4 and 5 provided that you also convey the machine readable Corresponding Source under the terms of this License in one of these ways 163 e b Convey the object code in or embodied in a physical product including a physical distribution medium accompanied by a written offer valid for at least three years and valid for as long as you offer spare parts or customer support for that product model to give anyone who possesses the object code either I a copy of the Corresponding Source for all the software in the product that is covered by this License on a durable physical medium customarily used for software interchange for a price no more than your reasonable cost of physically performing this conveying of source or 2 access to copy the Corresponding Source from a network server at no charge e C Convey individual copies of the object code with a copy of the written offer to provide the Corresponding Source T his alternative is allowed only occasionally and noncommercially and only if you received the object code with such an offer in accord with subsection 6b e d Convey the object code by offering access from a designated place gratis or for a charge and offer equivalent access to the Corresponding Source in the same way through the same place at no further charge You need not require recipients to copy the Corresponding Source along with the obj
12. for Broadcasters The open radio software for scheduling and remote station management USER GUIDE ee bd v E A IS l Oro gt OC x 24 b s a v a ha S 5 Airtime SOURCEFABRIC AIRTIME 2 FOR BROADCASTERS Updated for Airtime 2 1 3 4 SOURCEFABRIC www sourcefabric AIRTIME 2 FOR BROADCASTERS THE OPEN RADIO SOFTWARE FOR SCHEDULING AND REMOTE STATION MANAGEMENT PUBLISHED July 2012 Updated for Airtime 2 1 3 This documentation is free documentation You can redistribute it and or modify it under the terms of the GNU General Public License as published by the Free Software Foundation version 3 This documentation is distributed in the hope that it will be useful but without any warranty without even the implied warranty of merchantability or fitness for a particular purpose See the GNU General Public License for more details You should have received a copy of the GNU General Public License along with this documentation if not write to Free Software Foundation 51 Franklin Street Suite 500 Boston MA 02110 1335 USA Trademarked names may appear in this book Rather than use a trademark symbol with every occurrence of a trademarked name we use the names only in an editorial fashion and to the benefit of the trademark owner with no intention of infringement of the trademark This manual has been edited and reworked by Daniel James based o
13. v 4m 445 42 If you have a long schedule displayed and you wish to skip to the currently playing item click the button with the Down arrow icon to the right of the Trashcan T o cancel the current show click the Eject button which is to the right again A pop up window will ask you to confirm the cancellation Files which are no longer available have an exclamation mark icon in the second column T his may happen for files which were part of previous shows and were removed from Airtime s main storage or watched folders subsequently Files which are included in forthcoming shows cannot be removed from the library through the Airtime administration interface CHANGING THE SCHEDULE The Now Playing page enables you to make last minute changes to running shows In the top left corner of the page is an arrow icon which enables you to open Airtime s library of files and playlists 43 NOW PLAYING ADD MEDIA PLAYLIST BUILDER azn raso Saws Bae Filter By Show pee nn _ _ 11 50 00 11 53 18 3 18 8 Miss Millie feat Kings go Forth Dabrye s Synthesiz 7th Galaxy feat Jamall Bufford 14KT remix O 12 04 11 12 07 55 3 43 6 All Your Goodies Are Gone feat Mayer Hawthorne 12 07 55 12 13 00 5 05 4 1 Bet You Version DeepSeeSoundSystem mix
14. The solution is to specify that the metadata for the MP3 mount point you are using should be interpreted using UT F 8 encoding You can do this by adding the following stanza to the etc icecast2 icecast xml file where airtime mp3 is the name of your mount point mount lt mount name gt airtime mp3 lt mount name gt lt charset gt UTF 8 lt charset gt lt mount gt After saving the etc icecast2 icecast xml file you should restart the Icecast server sudo invoke rc d icecast2 restart Restarting icecast2 Starting icecast2 Detaching from the console icecast2 86 INSTALLATION 21 PREPARING THE SERVER 22 EASY SETUP 23 AUTOMATED INSTALLATION 24 MANUAL INSTALLATION 25 CONFIGURATION 26 SETTING THE SERVER TIME 87 2 e PREPARING THE SERVER The following instructions assume that you have root access sudo on Ubuntu to a GNU Linux server and are familiar with basic command line tasks Experienced system administrators may prefer to skip to the Expert install chapter in the appendix of this book after preparing the server as shown in the steps below The recommended Airtime server platform is Ubuntu 10 04 Lucid Lynx LTS Ubuntu 12 04 Precise Pangolin and Debian 6 0 squeeze are also supported options Users of other GNU Linux distributions may be able to adapt these instructions to suit their needs The server should have at least a GHz processor and 512MB of RAM preferably IGB RAM or more If you a
15. connection retries 3 time between retries 60 Save and close the file with Ctrl O and Ctrl X If you have changed the database settings you should now run the command sudo airtime update db settings to make sure all of Airtime s database configuration files are updated T his command should output the following text to the server console Airtime root folder found at usr share airtime Updating usr share airtime application configs application ini Updating usr share airtime build build properties Updating usr share airtime build runtime conf xml Success 112 26 SETTING THE SERVER TIME Accurate time keeping on your server is vital for optimal Airtime performance You can confirm that the date and time of your server are set correctly with the date command date T he server should respond with the date time time zone and year in a format similar to the following example Tue Jul 3 15 08 57 BST 2012 CONFIGURING NTP Although it is possible to set the date and time of the server manually this is not recommended because the server clock can drift over time compromising the accuracy of your broadcast schedule If your Airtime server is permanently connected to the Internet you can synchronize your server to a time server with the ntp program If ntp is not yet installed you can enter the following command on Debian or Ubuntu sudo apt get install ntp Optionally open the ntp configuration file in the na
16. default ALC 269 basic Basic preset quanta Quanta FL1 laptop amic Laptops with analog mic input laptop dmic Laptops with digital mic input fujitsu FSC Amilo lifebook Fujitsu Lifebook S6420 auto auto config reading BIOS default ALC662 663 272 3stack dig 3 stack 2 channel with SPDIF 3stack 6ch 3 stack 6 channel 3stack 6ch dig 3 stack 6 channel with SPDIF 5stack dig 5 stack with SPDIF lenovo 101e Lenovo laptop eeepc p701 ASUS Eeepc P701 eeepc ep20 ASUS Eeepc EP20 ecs ECS Foxconn mobo m51va ASUS M51VA g lv ASUS G71V h13 ASUS H13 g50v ASUS G50V asus model ASU asus mode2 ASU asus mode3 AS asus mode4 AS asus mode5 ASU asus mode6 ASU asus mode7 ASU asus mode8 ASUS dell Dell with ALC272 dell zm1 Dell ZM1 with ALC272 samsung ncl0 Samsung NC10 mini notebook auto auto config reading BIOS default C C Co ALC680 base Base model ASUS NX90 auto auto config reading BIOS default ALC882 883 885 888 889 3stack dig 3 jack with SPDIF I O 6stack dig 6 jack digital with SPDIF I O arima Arima W820Dil targa Targa T8 MSI 1049 T8 asus a7j ASUS A7J asus a7m ASUS A7M macpro MacPro support mb5 Macbook 5 1 macmini3 Macmini 3 1 mba21 Macbook Air 2 1 mbp3 Macbook Pro rev3 imac24 iMac 24 with jack detection 154 imac91 iMac 9 1 w2jc ASUS W2JC 3stack 2ch dig 3 jack with SPDIF I O ALC883 alc883 6stack dig 6 jack digital with SPDIF I O ALC883 3stack 6ch 3 jack 6 cha
17. feruiwirtimesstor2b Lb 1 amp amp 06696 835065288 mp3 1568 Do fereiairimesstorit ci 4c 703859600 486237999 79804 351 mp3 forefaitti mentors 12401 29 06 9967 25087066 mo Peaches amp Cream ferufairtimeistocitin itt51958993 3383 454c4054154082322 mp3 Northern Skies fervfoimimesstoeeb 3ebdseQb442571b23035582 331388079 mp3 Mams England 7536 2d That Se d dO 3c mp3 Lately fervfarimerstortGOM6GtedS Yd5e81942300974259387fc8 mp3 Emety oem Serv ioimimer tor bif b038bate 00 5292 redi 5 068 mp3 Got My Egu ferufirtirmeistor2 71 2 765900bcbsib390873458876485174 0 mp3 Cherchez Pas fere foirtimesstocien5e 76d 300d 367186 d819de0b 76510 mp3 The Spanish Mustie Denny Krivit tdi feruiwirtimemtord 76 570 73449 755637 amp 2090 55900431465 mp3 Electecone ferefaitimetstor 8 178 16352277bO 206051 Loe 7667 ebtd Ina The Moon is Brd Eye fere faimmesstor0182183568000347 5394466093955 748 mp3 Pores Aeeviniti mentees 1 5 715 Mea Rdind PAD aetas mp Three continents fervinitimerstoetadMadk28b261 4022 758c 10387 s9 920606 mp3 Half Light feru aimimesstorkitaifta 2925 f9bctbb4702e39 cT34d dde mpd Love Darking fore nit mem tort ana 345 f601c000275153514408 Fab mp My Ossis fsrufaitimesstorfib2 8b2776511803dfssfcaOs 31d068bbc6 mp3 Aingerprines Perv fairtimesstorfhdd 4db3427632540530b646091 903940 Emakheys ferveinittimerstor 9049000649026 3c 0dc0eb7706571305be4 mp3 justo
18. searching for recorder T he file will be labelled with a Title containing a date and time stamp as well as the name of the show Show hide columns v Live Recorded Show Click a file and select Edit Metadata from the pop up menu to enter additional details of the recording which will help you find it in searches later such as Album or Language T hen click the Save button 78 Recorded Show 2012 07 02 16 06 0 Live Rock Shows Rock n Roll Radio Eos i CANCELLING A RECORDING If you wish to cancel the recording of a live show click on the show in the Calendar and select Cancel Current Show from the pop up menu 79 Airtime will ask you if you are sure about this action as it cannot be undone T he recorded show file in the Airtime storage server will be truncated if you click the OK button 80 9 LIVE SHOWS WITH MIXXX Mixxx is a cross platform Open Source application for DJs available from http www mixxx org Installed on a desktop or laptop computer Mixxx complements your Airtime server to provide a complete system for both live and scheduled broadcasting Although Mixxx has many features designed for dance music DJs that require beat matching and pitch independent time stretching the program can be used for any kind of manually triggered broadcast playout including live speech shows such as news or current affairs Mixxx supports a wide variety of popular hardwa
19. stream register flow radio Rock n Roll Radio website http radio example com description Canada s most rockin radio genre Rock user passwordz streams ogg 128k http streaming example com airtime 128 1 stream For now a stream can be registered on the Liquidsoap Fows site with any username and password 139 36 STREAM PLAYER FOR YOUR WEBSITE If you are using Airtime for web streaming you can embed a player applet into your website jPlayer is a player applet available under the GNU GPL from http jplayer org which uses the audio tag feature of HT ML5 to play your streams If the listener s browser does not support HT ML5 the applet falls back to using Adobe Flash instead Proprietary browsers such as Internet Explorer on Windows or Safari on Apple OS X may not support Ogg Vorbis streams Listeners who do not wish to install a browser with Ogg Vorbis support such as Mozilla Firefox Google Chrome or Opera can listen to these streams using a separate media player such as VideoLAN Client also known as VLC http www videolan org vlc EXAMPLE CODE You can download the example code for this chapter from http en flossmanuals net airtime en 2 0 index _booki airtime en 2 0 static jPlayer_demo2 zip Unzip this file on your computer and then open the file jplayer demo html in your editor nano jplayer demo html We ll focus on the two areas that you need to concern yoursel
20. sudo apt get install postgresql 4 Install the streaming media server optional sudo apt get install icecast2 5 Remove PulseAudio if installed sudo apt get purge pulseaudio 6 Install Airtime sudo apt get install airtime Refer to the Configuration chapter for configuration options Now you should be able to log in to the Airtime administration interface as shown in the Getting started chapter 152 40 HD AUDIO MODELS T his listing is provided to help ensure that the correct model parameter is passed to the ALSA kernel module for an Intel HDA soundcard if one is fitted to your Airtime server See the chapter Preparing the server in this book for more details Model name Description 3stack 3 jack in back and a headphone out 3stack digout 3 jack in back a HP out and a SPDIF out 5stack 5 jack in back 2 jack in front 5stack digout 5 jack in back 2 jack in front a SPDIF out 6stack 6 jack in back 2 jack in front 6stack digout 6 jack with a SPDIF out w810 3 jack z71v 3 jack HP shared SPDIF asus 3 jack ASUS Mobo asus wlv ASUS WIV asus dig ASUS with SPDIF out asus dig2 ASUS with SPDIF out using GPIO2 uniwill 3 jack fujitsu Fujitsu Laptops Pi1536 F1734 2 jack lg LG laptop m1 express dual lg lw LG LW20 LW25 laptop tcl TCL S700 clevo Clevo laptops m520G m665n medion Medion Rim 2150 test for testing debugging purpose almost all controls can be adjusted Appearing only when compiled wit
21. works The licenses for most software and other practical works are designed to take away your freedom to share and change the works By contrast the GNU General Public License is intended to guarantee your freedom to share and change all versions of a program to make sure it remains free software for all its users We the Free Software Foundation use the GNU General Public License for most of our software it applies also to any other work released this way by its authors You can apply it to your programs too When we speak of free software we are referring to freedom not price Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software and charge for them if you wish that you receive source code or can get it if you want it that you can change the software or use pieces of it in new free programs and that you know you can do these things T o protect your rights we need to prevent others from denying you these rights or asking you to surrender the rights T herefore you have certain responsibilities if you distribute copies of the software or if you modify it responsibilities to respect the freedom of others For example if you distribute copies of such a program whether gratis or for a fee you must pass on to the recipients the same freedoms that you received You must make sure that they too receive or can get the source code And you must show them these terms so t
22. 2 3 streaming example com 8000 vg Icecast2 Status Administration Server Status Version Mount Point airtime_128 Stream Title airtime 128 Stream Description Airtime Radio Stream 1 Content Type application ogg Mount started Thu 31 May 2012 15 04 51 0100 Quality 0 4 Current Listeners 0 Peak Listeners 1 Stream Genre genre Stream URL http airtime sourcefabric org Current Song Tenor amp Allen Show Jimi Tenor amp Tony Allen THE SYSTEM MENU 5 USERS 6 PREFERENCES 7 MEDIA FOLDERS 8 STREAM SETTINGS 9 SUPPORT FEEDBACK 10 STATUS I1 PLAYOUT HISTORY 5 e USERS If your Airtime server is accessible from the public Internet it will not be secure until you set your own strong password for the all powerful admin user Should the password for the admin user still be set to admin you should set a new password immediately via the Users page on the System menu Only users with the User Type of Admin can see the System menu when they log in SETTING PASSWORDS AND CONTACT DETAILS On the left side of the Users page click on admin in the table T he details for this user will appear in the box on the right side T o begin with on a freshly installed Airtime server the admin user only has a Username Password and User Type set Enter a secure password as long and as varied as is practical into the Password field Keeping this password secret is essential for the s
23. 2 newly installed 0 to remove and 0 not upgraded Need to get 8 631kB 10 1MB of archives After this operation 41 5MB of additional disk space will be used Do you want to continue Y n Y Get 1 http apt sourcefabric org lucid main airtime 2 1 3 1 8 631kB Fetched 8 631kB in 8s 989kB s Preconfiguring packages Selecting previously deselected package liquidsoap Reading database 598365 files and directories currently installed Unpacking liquidsoap from liquidsoap_1 0 0 lucid sfo 7_amd64 deb Selecting previously deselected package airtime Unpacking airtime from airtime 2 1 3 1 all deb Once all the packages have been downloaded and installed you will be asked a few questions about the configuration of the Airtime system You can accept the default settings by pressing the Enter key or use the Tab key to change your selection Firstly you will asked if you wish to create an Apache virtual host web server configuration automatically 100 Configuring airtime This setup script can perform apache web server configuration so that you can connect to airtime directly after this installation Production systems should choose dedicated v host This option will ask for a Server host name FQDN and will create a minimal apache vhost configuration that you can adapt no thanks no problem You re welcome to set it up however you like Note that the files in etc airtime may come in handy doing so Create apache
24. Betancourt Pa Bravo Yo fsrefoirimemtor 54 54986044303064 73543910 7298476 The Suburbs Continued 2 frufoirtimeistor t 00 1004125b4014b0b3c879bdd5c7c05en mp3 Dat Soca Bost fere faitimeistocfeBfenf 710610855 3084700547131 8489 Peace On Earth feruiimimesston T d 57d9c9bOc4 7b09e02 32040829 770366 mp3 Sex Lows S 362b 41 5427c029371b199003474l To the Brink fere foirtimesstorl c1 1c 1847BfeG 3decis 4500200314888 700 mp3 Beauty vivy Serv foiimesstocjdf i615 DOi 1bc6cc 4090643224 9c e2f Froot bba39e7c 1c 48047 4e stan 34946504 mp After downloading one of the skins extract the zip file and copy it to the skins directory on the computer where Mixxx is installed For example on Debian or Ubuntu unzip Airtime1280x1024 skin for Mixxx zip sudo cp r Airtime1280x1024 usr share mixxx skins Then start Mixxx and select the Airtime skin by clicking Options Preferences then Interface in the Mixxx main menu 83 Preferences Airtime1280x1024 This skin does not support schemes Buttons Temporary Pitch Rate Buttons ox E 400 om E Right click 200 84 20 ICECAST AND SHOUTCAST Airtime supports direct connection to two popular streaming media servers the open source Icecast http www icecast org and the proprietary SHOUTcast http www shoutcast com Apart from the software license the main difference between these two
25. DeepSeeSoundSystem mix vame Coffey Re Worked Right clicking a file or playlist row in the search results will display all the available metadata for that item in a pop up window ADD MEDIA PLAYLIST BUILDER CALENDAR Miss Millie feat Kings go Forth Dabrye s Synthesized mix I Bet You Version DeepSeeSoundSystem mix Space Traveller Nick Speed remix Broken Train Mixed Bizness 52 CREATING A NEW PLAYLIST Once you have found the media that you require using the search box you can create a new playlist on the right hand side of the Playlist Builder page Click the New button to begin Show hide columns At first the new playlist will be shown as Untitled Playlist Click on the pencil icon to the right to give the playlist a name New Enter the name you have chosen then press the Return key on your keyboard to save the new name You can edit the name of the playlist later by clicking on the pencil icon again 53 Click the link View edit description to expand a box where you can enter a Description for the playlist then click the Save button Setting good quality metadata here will help you find the playlist using the search box later so you should be as descriptive as possible 54 Delete EDITING A PLAYLIST With a playlist open click on a file in the search results and then click Add to Playlist on the pop up menu Or drag and d
26. Getting Started chapter you can click Support Feedback on the System menu to display Airtime s automated feedback options Check the Send support feedback box in order to post technical details about your Airtime installation to Sourcefabric over the Internet T hese details help Sourcefabric diagnose any problem that you might be having with your Airtime system You may also wish to send details of your station to Sourcefabric so that your station has the opportunity to be promoted with other Airtime users on the http www sourcefabric org website T his feature also helps Sourcefabric target its support services to the countries where they are needed most Check the box Promote my station on Sourcefabric org and fill in the details of your station You can upload a station logo file of up to 600 x 600 pixels from your desktop computer by clicking the Browse button 34 Click on the Show me what I am sending link to expand a box which displays the technical data being returned to Sourcefabric T he data is collected according to the Sourcefabric privacy policy http www sourcefabric org en about policy which you are required to agree to before you can submit the information 35 36 0 STATUS On the System menu the Status page provides an overview of the health and resource usage of the various services that make up an Airtime system If all is well you will only see green check mark icons in the Status column T his pa
27. a green circle icon to open a file selection window on your computer 47 Ed lt B daniel Music mp3 strutsampler Places Name v Size Modified df Search 1 14 Justo Betancourt Pa Bravo Yo 5 2MB 05 04 11 Recently Used daniel 02 Dat Soca Boat mp3 6 7MB 05 04 11 3 Desktop 02 Pardon mp3 5 6MB 05 04 11 E File System 03 My Oasis mp3 6 9MB 05 04 11 Music d 04 Love And Death mp3 9 5 MB 05 04 11 gt 05 Do The Spanish Hustle Danny 12 7 MB 05 04 11 B3 castudio 06 Electricone mp3 5 1MB 05 04 11 07 Cherchez Pas mp3 8 2MB 05 04 11 08 Emakhaya mp3 10 1MB 05 04 11 Jl 09 Wozani Mahipi mp3 3 3MB 05 04 11 10 Green Africa mp3 7 2MB 05 04 11 Peace On Earth mp3 10 6 MB 14 04 11 Remove All Files RM After you have added all the files that you require to the upload queue click the Start upload button which has a green arrow icon Select files Add files to the upload queue and click the start button Filename 1 14 Justo Betancourt Pa Bravo Yo mp3 01 Love Dancing mp3 Add files 4 Start upload The row of the file currently being uploaded is highlighted in pale green At the bottom of the upload queue a progress bar and percentage indicates how much of the upload has taken place so far The upload speed will depend on the network connection between your computer and the Airtime server 48 Select files Add f
28. and restore on a running PostgreSQL server in an Airtime system You can dump the entire database to a zipped file with the combination of the pg dumpall command and gzip The pg dumpall command is executed as the user postgres by using the sudo command and the u switch It is separated from the gzip command with the pipe symbol sudo u postgres pg dumpall gzip c gt airtime backup gz T his command can be automated to run on a regular basis using the standard cron tool on your server When restoring a production database on a cleanly installed Airtime system it may be necessary to drop the empty database that was created during the new installation by using the dropdb command Again this command is executed with sudo as the user postgres sudo u postgres dropdb airtime T his dropdb command above is necessary to avoid already exists errors on table creation when overwriting an empty Airtime database in the next step These errors might prevent some data from being restored such as user account data To restore first unzip the backup file with gunzip then use the psql command as the postgres user gunzip airtime backup gz sudo u postgres psql f airtime backup postgres You should now be able to log in to the Airtime web interface in the usual way For safety reasons your regular database backups should be kept in a directory which is backed up by your storage backup tool of choice for example the srv airtime d
29. by some reasonable means prior to 60 days after the cessation Moreover your license from a particular copyright holder is reinstated permanently if the copyright holder notifies you of the violation by some reasonable means this is the first time you have received notice of violation of this License for any work from that copyright holder and you cure the violation prior to 30 days after your receipt of the notice Termination of your rights under this section does not terminate the licenses of parties who have received copies or rights from you under this License If your rights have been terminated and not permanently reinstated you do not qualify to receive new licenses for the same material under section 10 9 Acceptance Not Required for Having Copies You not required to accept this License in order to receive or run a copy of the Program Ancillary propagation of a covered work occurring solely as a consequence of using peer to peer transmission to receive a copy likewise does not require acceptance However nothing other than this License grants you permission to propagate or modify any covered work T hese actions infringe copyright if you do not accept this License T herefore by modifying or propagating a covered work you indicate your acceptance of this License to do so 10 Automatic Licensing of Downstream Recipients Each time you convey a covered work the recipient automatically receives a license from the orig
30. console T he nano editor should be installed by default but if not you can install it with the command sudo apt get install nano Then open the sources list file with the command sudo nano etc apt sources list For an Ubuntu 10 04 Lucid server find the lines which begin deb and end with lucid universe or lucid updates universe adding multiverse to the end of these lines if it is not there already Other versions of Ubuntu will have similar lines T he multiverse repository is required for the libmpslameo library which is an MP3 encoder GNU nano 2 2 2 deb cdrom Ubuntu 10 04 LTS Lucid Lynx Release amd64 20100429 l See http help ubuntu com community UpgradeNotes for how to upgrade to newer versions of the distribution deb http gb archive ubuntu com ubuntu lucid main Major bug fix updates produced after the final release of the distribution deb http gb archive ubuntu com ubuntu lucid updates main N B software from this repository is ENTIRELY UNSUPPORTED by the Ubun team Also please note that software in universe WILL NOT receive any review or updates from the Ubuntu security team deb http gb archive ubuntu com ubuntu lucid universe multiverseff deb http gb archive ubuntu com ubuntu lucid updates universe multiverse Get Help Me WriteOut ga Read File Prev Text ge Cur Pos Exi ae Justify Where Is gi Next UnCut To Spell The exa
31. for the show a brown row indicates that the file will be faded out when the show ends A red row indicates that the file will not be played at all The length of the overbooking is shown in minutes and seconds in the last row of the show To remove the extra files from the end of an overbooked show click the Scissors button at the top left of the table Alternatively check the boxes for files which have not yet played out and click the Trashcan button to the right of the Scissors to remove them from the schedule NOW PLAYING ADD MEDIA PLAYLIST BUILDER CALENDAR SYSTEM 029 epus clams s n Filter By Show D Be Stat Duration Tite Coffey Time Show 11 50 00 11 53 18 3 18 8 Miss Millie feat Kings go Forth Dabrye s Synthesizt 11 53 18 12 00 16 6 57 6 Only Good For Ectomorph 12 00 16 12 04 11 3 55 4 7th Galaxy feat Jamall Bufford 14KT remix 12 04 11 12 07 55 3 43 6 All Your Goodies Are Gone feat Mayer Hawthorne 12 07 55 12 13 00 5 05 4 1 Bet You Version DeepSeeSoundSystem mix 12 13 00 12 17 58 4 57 1 Plutonius Recloose Re dub 12 17 58 12 22 13 4 15 3 Space Traveller Nick Speed remix 4 12 22 13 12 25 32 3 18 8 Miss Millie feat Kings go Forth Dabrye s Synthesizi q 12 25 32 12 32 29 6 57 6 Only Good For Ectomorph 12 32 29 12 36 25 3 55 4 7th Galaxy feat Jamall Bufford 14KT remix m 4 12 40 08 12 45 14 5 05 4 Bet You Version DeepSeeSoundSystem mix
32. have permission to link or combine any covered work with a work licensed under version 3 of the GNU Affero General Public License into a single combined work and to convey the resulting work T he terms of this License will continue to apply to the part which is the covered work but the special requirements of the GNU Affero General Public License section 13 concerning interaction through a network will apply to the combination as such 14 Revised Versions of this License The Free Software Foundation may publish revised and or new versions of the GNU General Public License from time to time Such new versions will be similar in spirit to the present version but may differ in detail to address new problems or concerns Each version is given a distinguishing version number If the Program specifies that a certain numbered version of the GNU General Public License or any later version applies to it you have the option of following the terms and conditions either of that numbered version or of any later version published by the Free Software Foundation If the Program does not specify a version number of the GNU General Public License you may choose any version ever published by the Free Software Foundation If the Program specifies that a proxy can decide which future versions of the GNU General Public License can be used that proxy s public statement of acceptance of a version permanently authorizes you to choose that version for the Pro
33. in a red font to the left of the show name Recorded Show 05 36 00 Live Show 47 00 00 Live Show 16 13 17 00 Super Distortion Autocue 06 35 00 Before the first broadcast show scheduled for recording begins you should check that the level of recording is sufficient to ensure a good signal to noise ratio but not so high a level that clipping distortion occurs in the recorded file You can perform this check using the command alsamixer on the Airtime server T his command opens a soundcard mixer application in the server console Press the F4 key on your keyboard to set capture levels Some experimentation may be required to find the correct control on the mixer using the Left and Right arrow keys on your keyboard Levels are set with the Up and Down arrows and Capture is toggled with the Space bar Capture dB gain should be set to 0 00 0 00 initially If you hear nothing at all in the recording you may need to set the value of Input Source to Line using the Up or Down arrows Depending on the particular sound card and sockets you are using you may have to enable other inputs such as Digital or S PDIF If a test recording is too quiet try raising the line output level of your broadcast mixer towards odB before increasing gain above odB on the sound card in order to achieve the optimal gain structure 77 USING RECORDINGS After the recording has finished you can find the recorded file in the Playlist Builder by
34. in the code examples above should match the URL that you wish to serve schedule information to the public from If you have used the Caching schedule information method detailed above this would be the URL of your schedule server not the Airtime server directly 148 38 INTERFACE CUSTOMIZATION The Airtime administration interface as a web application is fully customizable using the same methods that you might use to modify a website For instance you may wish to increase certain font sizes or change the colours in the Airtime interface to better suit staff users with impaired vision T o do this open one of the CSS files in the public css directory under the Airtime DocumentRoot directory in an editor such as nano sudo nano usr share airtime public css styles css To change the background colour of the administration interface from dark gray to white the background property of the body tag could be changed to Zffffif as follows body font size 62 5 font family Arial Helvetica sans serif background ffffff margin 0 padding 0 Save the file with Ctrl 0 then refresh your browser to see the change to the interface background colour Arthur s Landing Love Dancing 06 01 00 Ebo Taylor Love And Death 06 55 00 Funk Show 11 02 12 00 Ebo Taylor P On Earth 07 44 00 NOW PLAYING ADD MEDIA PLAYLIST BUILDER CALENDAR esd Show hide col Album All Your Goodies Are Gone Oute
35. installed by default when you install Airtime To view the Monit web interface open port 2812 of your server in a web browser For example on the localhost you can use http localhost 2812 You will have to log in to see the Monit web interface T he username to use is guest and the default password is airtime monit service manager Mozilla Firefox Jee File Edit View History Bookmarks Tools Help J monit service manager op v 1 airtime 64studio com 2812 v v a 0 4 Home gt monit 5 0 3 Monit Service Manager Monit is running on office with uptime 32m and monitoring System Status Load CPU Memory 24 3 office running 1 96 1 60 1 47 29 696us 5 096sy 0 096wa 1494000 kB Process Status Uptime CPU Memory rabbitma SENE running 32m 0 0 0 3 18888 kB airtime playout running 28m 0 0 0 2 14092 kB airtime media SEEN running 32m 0 096 0 296 14516 kB Errem _ running 28m 224 0 496 24620 kB Copyright 2000 2009 Tildeslash All rights reserved Monit web site Monit Wiki M Monit Clicking on the name of a service in the Process column such as airtime playout opens another page with details of that service 129 monit service manager Mozilla Firefox File Edit View History Bookmarks Tools Help Ci monit service manager i airtime 64studio com 2812 airtir gt ve Process status Value Pid file airtime playou
36. make or receive copies Mere interaction with a user through a computer network with no transfer of a copy is not conveying An interactive user interface displays Appropriate Legal Notices to the extent that it includes a convenient and prominently visible feature that 1 displays an appropriate copyright notice and 2 tells the user that there is no warranty for the work except to the extent that warranties are provided that licensees may convey the work under this License and how to view a copy of this License If the interface presents a list of user commands or options such as a menu a prominent item in the list meets this criterion Source Code The source code for a work means the preferred form of the work for making modifications to it Object code means any non source form of a work A Standard Interface means an interface that either is an official standard defined by a recognized standards body or in the case of interfaces specified for a particular programming language one that is widely used among developers working in that language 161 The System Libraries of an executable work include anything other than the work as a whole that a is included in the normal form of packaging a Major Component but which is not part of that Major Component and b serves only to enable use of the work with that Major Component or to implement a Standard Interface for which an implementation is av
37. may save you a great deal of trouble later Independent music radio on the Internet is not what it might have been due to royalty demands from SoundExchange in the USA and similar organisations in other territories T hese organisations are usually membership societies or government sanctioned national authorities which are intended to collect money from broadcasters to compensate copyright holders T he royalty collection societies require payment before you can stream just about any music released commercially to the general public whether you make any money out of streaming or not It s not so much the percentage of revenue demanded but that there are usually annual minimum fees to pay which hurts small stations disproportionately For example in the UK the MCPS PRS Limited Online Music Licence covers non commercial music streaming by groups and individuals as long as their gross revenue is less then 12 500 per year T he cost is ona sliding scale up to 1 120 plus 20 tax per year for delivering up to 450 000 individual streams or serving 25 000 files after that you have to apply for a full MCPS PRS Online Music Licence T hat doesn t sound too bad at first but 25 000 files per year works out at less than four downloads per hour for a round the clock website T his particular licence only covers publishing songwriter rights not recording record label and musician s performance rights so you have to negotiate an additional lic
38. played out which defaults to showing the 24 hours ahead If you ve only just installed Airtime there might not be any files shown yet Click the calendar and clock icons above the table to change the date and time range then click the magnifying glass icon to the right NOW PLAYING 2012 06 15 On the left side of the page the Start and End times Duration and Title of each file are shown On the right Creator Album and Cue or Fade times can also be shown Click the Show hide columns button on the right to configure the metadata displayed by checking the boxes in the pop up window A Duration Title fd Creator T Album LN Cue In ill Cue Out Bl Fade In Fade Out 4l The row for the currently playing file is displayed with a bright green background Any underbooked shows shows with insufficient content to fill the time allowed are displayed with a row indicating the length of the underbooking in minutes and seconds These rows contain a red exclamation mark and have a pink background 12 22 13 12 25 32 3 18 8 Miss Millie feat Kings go Forth Dabrye s Synthesize 12 25 32 12 32 29 6 57 6 Only Good For Ectomorph 12 36 25 12 40 08 3 43 6 All Your Goodies Are Gone feat Mayer Hawthorne S 12 40 08 12 45 14 5 05 4 1 Bet You Version DeepSeeSoundSystem mix 4m 46s If a show is overbooked which means the total playout length is longer than the time allowed
39. progress bar is not useful when we are streaming continuously from Icecast so we can remove these tags from the demo code along with the tags specifying the playback time and file duration T he simplified HT ML creates a play pause button and a mute button and looks as follows div id jquery jplayer 1 class jp jplayer div div class jp audio div class jp type single div id jp interface 1 class jp interface gt div class label Airtime Radio 99 9 FM lt div gt ul class jp controls gt lt li gt lt a href class jp play tabindex 1 play a li lt li gt lt a href class jp pause tabindex 1 gt pause lt a gt lt 1li gt lt li gt lt a href class jp mute tabindex 1 gt mute lt a gt lt 1li gt lt li gt lt a href class jp unmute tabindex 1 gt unmute lt a gt lt 1li gt lt ul gt lt div gt div id jp playlist 1 class jp playlist gt lt div gt div div When you open the HT ML file jplayer demo html in a web browser your player should appear as follows Demo jPlayer as an audio player Mozilla Firefox 3 E 23 File Edit View History Bookmarks Tools Help file jPlayer demo jplayer demo html v O 9 Demo jPlayer as an audio pla 3 S Airtime Radio 99 9 FM The original version of this demo code and skin are available from http jplayer org download for further experi
40. sound cards have ALSA drivers built into the Linux kernel which do not need to be installed separately If in doubt about driver support for your sound card check the ALSA support matrix at http www alsa project org main index php Matrix Main USB AUDIO DEVICE INDEX Some server motherboards do not have a default ALSA device index number zero and a USB sound card is often prevented from getting index zero by the GNU Linux distribution s configuration T his setting may be in a file such as etc modprobe d alsa base conf in Ubuntu which can be edited with nano sudo nano etc modprobe d alsa base conf Comment out the lines beginning options snd usb to fix the problem Prevent abnormal drivers from grabbing index 88 options snd usb audio index 2 options snd usb us1221 index 2 options snd usb usx2y index 2 options snd usb caiaq index 2 Save the file with Ctrl O and close nano with Ctrl X T hen remove and re insert the cable connecting the USB sound card to the server making sure any mixer or amplifier connected is faded down to avoid a thump on the output The command aplay I should now confirm that the USB Audio device has index 0 aplay l List of PLAYBACK Hardware Devices x card 0 MobilePre MobilePre device 0 USB Audio USB Audio Subdevices 1 1 Subdevice 0 subdevice 0 When using a USB sound card with ALSA some how to documents advocate setting the nrpacks 1 option but this is
41. sourceforge net projects airtime files with wget For example to download version 2 1 3 you could use the command wget http downloads sourceforge net project airtime 2 1 3 airtime 2 1 3 tar gz 2 Unzip the downloaded file in your home directory This action will create a subdirectory called airtime2 1 3 sudo tar xvzf airtime 2 1 3 tar gz C 3 Run the airtime full install script sudo airtime 2 1 3 install full ubuntu airtime full install The installation script will indicate which files are being installed on your system and the directories they are being unpacked into Finally it will run the airtime check system script to confirm that your server environment is set up correctly Verifying your system environment running airtime check system 106 AIRTIME STATUS URL AIRTIME SERVER RESPONDING KERNEL VERSION MACHINE ARCHITECTURE TOTAL MEMORY MBYTES TOTAL SWAP MBYTES AIRTIME VERSION 05 CPU WEB SERVER PLAYOUT ENGINE PROCESS ID http localhost 80 api status format json api_key api_key OK 2 6 32 41 generic x86_64 6128212 2 1 3 Ubuntu 10 04 4 LTS x86_64 Dual Core AMD Opteron tm Processor 170 Apache 2 2 14 Ubuntu 13552 PLAYOUT_ENGINE_RUNNING_SECONDS 11 PLAYOUT_ENGINE_MEM_PERC 0 2 PLAYOUT_ENGINE_CPU_PERC 0 4 LIQUIDSOAP_PROCESS_ID 13557 LIQUIDSOAP_RUNNING_SECONDS 11 LIQUIDSOAP_MEM_PERC 0 2 LIQUIDSOAP_CPU_PERC 9 9 MEDIA_MONITO
42. streams There is also a clock indicating the Station time and time zone Beneath the clock the name of the user currently logged in is displayed and there is the link to Logout Station time 15 06 50 Scheduled Play BST Logout Airtime On the right of the Logout link clicking the green check mark opens a pop up window with some information about the version of Airtime installed If your Airtime installation is not the latest version available the green check mark changes to a green upgrade arrow Should your Airtime installation get too far out of date this arrow will change to a red exclamation mark Station time T9 20 99 BST Logout Airtime 7 2 1 0 You are running the latest version CHECKING AN ICECAST SERVER If you have enabled the lcecast streaming option when you installed Airtime you can check that the lcecast server is running by opening port 8000 of the server in your web browser For example on the server itself you can use http localhost 8000 or from another machine using the domain name of the lcecast server http streaming example com 8000 You should see the Icecast status page with details of the connection that Airtime has made to Icecast If you have only just installed Airtime there won t be any media playing out yet Icecast Streaming Media Server Mozilla Firefox File Edit View History Bookmarks Tools Help Airtime X C3 Icecast Streaming Media Ser
43. the srv airtime uploads incoming folder ensures that the uploads SFT P account does not have direct write access to the Airtime storage archive That could be a security risk if the password was compromised bin sh Run the import script on fresh uploads airtime import copy srv airtime uploads incoming Clean the incoming directory to save disk space rm r srv airtime uploads incoming mp3 rm r srv airtime uploads incoming ogg Finally the script should be made executable so that the cron daemon can run it sudo chmod x etc cron hourly airtime upload By default Debian and Ubuntu GNU Linux run cron hourly tasks at 17 minutes past each hour This value can be adjusted in the file etc crontab on the server if required Remote users should connect to the Airtime server using their client software of choice making sure that they specify an SFTP rather than FT P connection The remote directory for the clients to use would be srv airtime uploads incoming as configured above a gFTP 2 0 19 ETP Local Remote Bookmarks Transfer Log Tools Help at Host airtime example com v Port User uploads v Pass M M home daniel Music Pointy Bird v srv airtime uploads incoming Local All Files localhost SSH2 All Files 4 Filename Size it Filename t 4 096 E Jd Super Distortion 14 259 606 ry For additional security you could configure your Airt
44. the files from the original location after copying them to the storage archive which is accomplished with the move sub command airtime import move directory If the new files are exact duplicates of files that have already been imported the airtime import script will detect this Any users logged into the administration interface will be warned if a File import is in progress Users assigned the admin privilege should not attempt to change Airtime s default storage directory while an import is taking place NOW PLAYING ADD MEDIA PLAYLIST BUILDER CALENDAR Y File import in progress Auto Bug 4 Aut S Distortion di pis single 4 Cherchez Pas The Heshoo Beshoo Group Strut Sampler 2011 Dat Soca Boat Mighty Shadow Strut Sampler 2011 Watching a new folder is specified by using the watch add sub command airtime import watch add directory 120 T he script will report the name of the folder now being watched for example airtime import watch add home daniel Music mp3 Beck home daniel Music mp3 Beck added to watched folder list successfully T he watched folder will also be listed on the Manage Media Folders page in the Airtime administration interface T o obtain a list of currently watched folders in the server console you can use the watch list sub command airtime import watch list home daniel Music mp3 Beck Any new files copied to a watched folder f
45. to stream at 1 60kbps or 192kbps to offer a quality advantage over stations streaming at 28kbps or less Since both Ogg Vorbis and MP3 formats use lossy compression listeners will only hear the benefit of higher streaming bitrates if the media files in the Airtime storage server are encoded at an equivalent bitrate or higher UTF 8 METADATA IN ICECAST MP3 STREAMS When sending metadata about your stream to an lcecast server in non Latin alphabets you may find that Icecast does not display the characters correctly for an MP3 stream even though they are displayed correctly for an Ogg Vorbis stream In the following screenshot Russian characters are being displayed incorrectly in the Current Song field for the MP3 stream 85 Mount Point airtime mp3 Stream Title airtime mp3 Stream Description Airtime Radio Content Type audio mpeg Mount started Sun 18 Sep 2011 18 59 23 0400 Bitrate 128 Current Listeners 0 Peak Listeners 0 Stream Genre genre Stream URL http airtime sourcefabric org Current Song D DUD D NDVND 1 ND D D3D34D2D34N Anthrax I m Mount Point airtime ogg Stream Title airtime ogg Stream Description Airtime Radio Content Type application ogg Mount started Sun 18 Sep 2011 18 59 23 0400 Quality 0 3 Current Listeners 0 Peak Listeners 0 Stream Genre genre Stream URL http airtime sourcefabric org Current Song Anthrax I m The Man
46. very easily find your jingles regardless of their Title Creator or Album by searching for jingle T he same technique can be used to find advertising and promo files See the chapter Using the airtime import script for tips on batch tagging files with metadata 44 Multiple words in a search term are matched using and rather than or logic to narrow your search Perhaps you have tagged some jazz flavoured station idents intended for use ina particular show called 22 Maverick with the Album tag of Jazz Maverick and a Genre of Ident You could then find exactly the idents you are searching for by typing maverick ident into the search field Clicking on a file or playlist in the library table opens a pop up menu which enables you to audition the item or remove it from the Airtime library You can also download a file to your local computer using this menu or edit its metadata After you have found the items that you want you can then drag and drop them from the library table on the left side of the interface into the running show schedule on the right side You can also select multiple items using the Select button just beneath the search field which has a square icon Alternatively use the checkboxes on the left side of the library table then click the Add button which has a plus icon If you wish you can also use the Delete button to permanently remove items from Airtime s storage server or watched folders Only admin u
47. 2 config no thanks Ok If so you will need to enter the domain name that your station staff will use to access Airtime For a test server that will only be accessed directly from the same machine you can use the default setting of localhost here Configuring airtime Enter the main hostname of the web server The DNS of this name must resolve to the apache server running on this machine e g example com or www example com without the quotes You can customize etc apache2 sites enabled airtime vhost afterward and add ServerAliases and further custom configuration more info soon FQDN apache vhost ServerName Next set the contact email address of the server administrator which is good practice in case of any server problems For a test server using an address at the localhost is acceptable 101 Configuring airtime required for dedicated vhost setup more info soon Email of the vhost admin ServerAdmin Debian and Ubuntu servers are set up with a default Apache configuration which might block station staff from accessing Airtime If you wish this default configuration can be removed automatically for you Configuring airtime By default the apache webserver comes with configuration to send all v hosts to var www This option will invoke sudo a2dissite default and is recommended when using airtime as vhost remove 000 default apache config no change Ok If you are set
48. 7H 1 130 allow guest airtime read only Logging in as the admin user you will now see buttons for controlling a service at the end of each service page Pid If changed 1 times within 1 cycle s then alert Ppid If changed 1 times within 1 cycle s then alert Start service Stop service Restart service Disable monitoring X Copyright 2000 2009 Tildeslash All rights reserved Monit web site Monit Wiki M Monit Monit does not have a logout button so if you have already logged in as guest you may have to clear the active login from your web browser before logging in as admin In Firefox on Ubuntu this is accomplished using Clear Recent History on the Tools menu LOCKING DOWN REMOTE ACCESS To make remote access more secure you can edit the file etc monit conf d monitairtime generic cfg with nano sudo nano etc monit conf d monit airtime generic cfg If you wish to enable access from the localhost only append an and use address statement to the end of the line which sets the server port set httpd port 2812 and use address localhost To enable access from other servers comment out the part of the line use address localhost and then append an allow line with the IP address and netmask of the machine to connect to Monit from such as a local network address of 10 0 1 2 and netmask of 255 255 255 0 allow 10 0 1 2 255 255 255 0 If you enable remote admin access be sure to change the randomly generated passwor
49. Eg al Jimi Tenor amp Tony Allen Inspiration Inf 15 42 54 6567 Darker Side Of z Jimi Teror amp Tony Allen Inspiration Information 1 15 49 51 5174 Walk Jimi Tenor amp Tony Allen inspiration Information 5 15 55 06 4 40 0 Against The Wall Jimi Tenor amp Tony Alle inspiration Information Airtime has been intended to provide a solution for a wide range of broadcast projects from community to public and commercial stations The scalability of Airtime allows implementation in a number of scenarios ranging from an unmanned broadcast unit accessed remotely through the Internet to a local network of machines accessing a central Airtime storage system Airtime supports the playout of files in both the commonly used MP3 format and the open royalty free equivalent Ogg Vorbis Airtime manages the Liquidsoap stream generator which is at the heart of the system Liquidsoap generates streams from files in the Airtime media archive which is indexed ina PostgreSQL database Live shows are automatically recorded with Ecasound using the soundcard line input Editors and station controllers can use Airtime to build playlists and manage files upload add metadata manage advertisements inside the station or via the Internet using a standard web browser such as Mozilla Firefox or Google Chrome The scheduler in Airtime has a calendar view organized by months weeks and days Here the program editors can schedule playlists and
50. HP automute Samsung P50 AD 1988 AD 1988B AD 1989A AD 1989B 6stack 6 jack 6stack dig ditto with SPDIF 3stack 3 jack 3stack dig ditto with SPDIF laptop 3 jack with hp jack automute laptop dig ditto with SPDIF auto auto config reading BIOS default Conexant 5045 laptop hpsense Laptop with HP sense old model laptop laptop micsense Laptop with Mic sense old model fujitsu laptop hpmicsense Laptop with HP and Mic senses benq Benq R55E laptop hp530 HP 530 laptop test for testing debugging purpose almost all controls can be adjusted Appearing only when compiled with CONFIG_SND_DEBUG y Conexant 5047 laptop Basic Laptop config laptop hp Laptop config for some HP models subdevice 3045 laptop eapd Laptop config with EAPD support test for testing debugging purpose almost all controls can be adjusted Appearing only when compiled with CONFIG_SND_DEBUG y Conexant 5051 laptop Basic Laptop config default 156 hp HP Spartan laptop hp dv6736 HP dv6736 hp f700 HP Compaq Presario F700 ideapad Lenovo IdeaPad laptop lenovo x200 Lenovo X200 laptop toshiba Toshiba Satellite M300 Conexant 5066 laptop Basic Laptop config default hp laptop HP laptops e g G60 asus Asus K52JU Lenovo G560 dell laptop Dell laptops dell vostro Dell Vostro olpc xo 1 5 OLPC XO 1 5 ideapad Lenovo IdeaPad U150 thinkpad Lenovo Thinkpad STAC9200 ref Reference board oqo 000 Model 2 dell d21 Dell unknown dell d22 Dell un
51. ION 2 1 3 05 Ubuntu 10 04 4 LTS x86 64 Dual Core AMD Opteron tm Processor 170 WEB SERVER Apache 2 2 14 Ubuntu PLAYOUT ENGINE PROCESS ID 13552 PLAYOUT ENGINE RUNNING SECONDS 11 PLAYOUT ENGINE MEM PERC 0 2 PLAYOUT ENGINE CPU PERC 0 4 LIQUIDSOAP PROCESS ID 13557 LIQUIDSOAP RUNNING SECONDS 11 LIQUIDSOAP MEM PERC 0 2 LIQUIDSOAP_CPU_PERC 9 9 MEDIA_MONITOR_PROCESS_ID 13502 MEDIA_MONITOR_RUNNING_SECONDS 12 MEDIA_MONITOR_MEM_PERC 0 4 MEDIA_MONITOR_CPU_PERC 4 4 RABBITMQ_PROCESS_ID 1774 RABBITMQ_RUNNING_SECONDS 10 RABBITMQ_MEM_PERC 0 3 RABBITMQ_CPU_PERC 0 4 Your installation of Airtime looks OK KAKKKKKKKKKK Install Complete You should now be able to log in to the Airtime administration interface as shown in the Getting started chapter See the Configuration chapter for advanced settings ENHANCED LIQUIDSOAP PACKAGE FOR UBUNTU PRECISE The Ubuntu 12 04 Precise Pangolin distribution includes an official Liquidsoap 1 0 0 package that will work with Airtime but Sourcefabric s own package of Liquidsoap includes a patch which enables smoother stream transitions After setting up the apt sourcefabric org repository as shown above you can search for other versions of the Liquidsoap package available to your server with the following command apt cache show liquidsoap T his command will list the versions available with short de
52. Monit with sudo invoke rc d monit start More information about monit is available in the chapter Using Monit 10 On Debian squeeze make sure the rabbitmq server daemon has started sudo invoke rc d rabbitmq server start I Finally run the airtime install script sudo airtime 2 1 3 install minimal airtime install Once the airtime check system script confirms that the install has been successful you should now be able to log in to the Airtime administration interface as shown in the Getting started chapter with the username admin and the password admin See the Configuration chapter for advanced settings INSTALL SCRIPT OPTIONS By default the airtime install script preserves any existing configuration or installation that it finds on the server However it is also possible to dictate the behaviour of the script with a command line option as follows help h Displays usage information overwrite Overwrite any existing config files preserve p Keep any existing config files no db n Turn off database install reinstall r Force a fresh install of this Airtime version 109 MANUAL UNINSTALL To manually uninstall Airtime from the server run the airtime uninstall script from the original installation directory for example sudo airtime 2 1 3 install minimal airtime uninstall Optionally you can also delete the Airtime storage and configuration folders if you have backups and are not going
53. O laptop without SPDIF auto BIOS setup default Cirrus Logic CS4206 4207 mbp55 MacBook Pro 5 5 imac27 IMac 27 Inch auto BIOS setup default VIA VT17xx VT18xx VT20xx auto BIOS setup default 158 4 e ABOUT THIS MANUAL Copyright C 2012 Sourcefabric o p s T his manual was written for Sourcefabric by Daniel James using the tools at FLOSS Manuals Please add your comments and contributions at http en flossmanuals net airtime en 2 T his documentation is free documentation you can redistribute it and or modify it under the terms of the GNU General Public License as published by the Free Software Foundation version 3 T his documentation is distributed in the hope that it will be useful buc WIT HOUT ANY WARRANT Y without even the implied warranty of MERCHANT ABILIT Y or FITNESS FOR A PART ICULAR PURPOSE See the GNU General Public License for more details You should have received a copy of the GNU General Public License along with this documentation if not write to the Free Software Foundation Inc 51 Franklin Street Fifth Hoor Boston MA 02110 1301 USA 159 GNU GENERAL PUBLIC LICENSE Version 3 29 June 2007 Copyright 2007 Free Software Foundation Inc lt http fsf org gt Everyone is permitted to copy and distribute verbatim copies of this license document but changing it is not allowed Preamble The GNU General Public License is a free copyleft license for software and other kinds of
54. R_PROCESS_ID 13502 MEDIA_MONITOR_RUNNING_SECONDS 12 MEDIA_MONITOR_MEM_PERC 0 4 MEDIA_MONITOR_CPU_PERC 4 4 RABBITMQ_PROCESS_ID 1774 RABBITMQ_RUNNING_SECONDS 10 RABBITMQ_MEM_PERC 0 3 RABBITMQ_CPU_PERC 0 4 Your installation of Airtime looks OK KAKKKKKKKKKK Install Complete You are now ready to proceed to the Configuration chapter MINIMAL INSTALL The alternative airtime install script does not attempt to configure your server an option which you may find more suitable if you have special requirements In the server terminal or console install the list of dependencies For example on Ubuntu 10 04 Lucid Lynx LTS you could enter the command sudo apt get install apache2 curl ecasound gzip icecast2 lame libao ocaml libapache2 mod php5 libcamomile ocaml data 1 libmad ocaml libmp3lame dev libportaudio2 libpulseO libsamplerateO libsoundtouch ocaml libtaglib ocaml libvorbis ocaml lsb release monit mpg123 multitail odbc postgresql patch php pear php5 curl php5 gd php5 pgsql postgresql python2 6 python virtualenv rabbitmq server sudo tar vorbis tools 2 Check that the Apache web server modules that Airtime requires are enabled sudo a2enmod php5 rewrite T he server should respond Module php5 already enabled Module rewrite already enabled 3 Create a directory to contain the Airtime web interface sudo mkdir p usr share airtime public 4 Next crea
55. a work that has been modified or installed by the recipient or for the User Product in which it has been modified or installed Access to a network may be denied when the modification itself materially and adversely affects the operation of the network or violates the rules and protocols for communication across the network Corresponding Source conveyed and Installation Information provided in accord with this section must be in a format that is publicly documented and with an implementation available to the public in source code form and must require no special password or key for unpacking reading or copying 7 Additional T erms Additional permissions are terms that supplement the terms of this License by making exceptions from one or more of its conditions Additional permissions that are applicable to the entire Program shall be treated as though they were included in this License to the extent that they are valid under applicable law If additional permissions apply only to part of the Program that part may be used separately under those permissions but the entire Program remains governed by this License without regard to the additional permissions When you convey a copy of a covered work you may at your option remove any additional permissions from that copy or from any part of it Additional permissions may be written to require their own removal in certain cases when you modify the work You may place additional permissio
56. ailable to the public in source code form A Major Component in this context means a major essential component kernel window system and so on of the specific operating system if any on which the executable work runs or a compiler used to produce the work or an object code interpreter used to run it The Corresponding Source for a work in object code form means all the source code needed to generate install and for an executable work run the object code and to modify the work including scripts to control those activities However it does not include the work s System Libraries or general purpose tools or generally available free programs which are used unmodified in performing those activities but which are not part of the work For example Corresponding Source includes interface definition files associated with source files for the work and the source code for shared libraries and dynamically linked subprograms that the work is specifically designed to require such as by intimate data communication or control flow between those subprograms and other parts of the work The Corresponding Source need not include anything that users can regenerate automatically from other parts of the Corresponding Source The Corresponding Source for a work in source code form is that same work 2 Basic Permissions All rights granted under this License are granted for the term of copyright on the Program and are irrevocable provided the s
57. al time is now Universal Time is now Tue Jul Tue Jul 3 15 18 01 BST 2012 3 14 18 01 UTC 2012 115 ADMINISTRATION 27 USING THE IMPORT SCRIPT 28 THE AIRTIME LOG COMMAND 29 BACKING UP THE SERVER 30 UPGRADING 31 TROUBLESHOOTING 32 USING MONIT 27 USING THE IMPORT SCRIPT If you have a large number of files in your media library importing these files one at a time into a broadcast automation system would be time consuming and tedious T hat s why Airtime includes a script that can import an entire directory of files in one go Before performing the import there are a number of factors which should be considered METADATA QUALITY The airtime import script automatically imports any metadata that is in the files ID3 tags If these tags are incorrect or are missing information you will have to either edit the metadata manually or suffer the consequences For example if the tags have creator or genre metadata missing it will be impossible to search for playlist or schedule the media according to these criteria There are a number of programs available which can be used to correct mistakes or incomplete information in ID3 tags On GNU Linux the program Ex Falso http code google com p quodlibet can be useful for batch setting and editing ID3 tags before importing files into your Airtime server On an Ubuntu desktop machine you can install this program with the command sudo apt get install exfalso After install
58. appendix 92 22 e EASY SETUP The airtime easy setup package sets up a typical Airtime configuration without prompting you for any settings You can then install the latest Airtime package from the Sourcefabric repository with a few clicks After that the Airtime administration interface can be accessed at the default domain name of the computer such as http airtime example com If you have not yet set a fully qualified domain name for the computer you can use a URL such as http ubuntu on the localhost for testing purposes Whichever domain name you use the Icecast administration interface will be at port 8000 of the same URL such as http airtime example com 8000 You can download the airtime easy setup package from http apt sourcefabric org misc airtime easy setup deb which is a link to the latest version of the package You should stay connected to the Internet throughout the installation as a number of dependency packages have to be installed from online repositories On Ubuntu 10 04 lucid or Debian 6 0 squeeze you can run the airtime easy setup package from your browser using the program GDebi Opening airtime easy setup deb You have chosen to open _ airtime easy setup deb which is a Debian package from http apt sourcefabric org What should Firefox do with this file Open with GDebi Package Installer default 2 Save File C Do this automatically for files like this from now
59. aptops NX560XL m1 2 Some Gateway MX series laptops MX6453 157 m2 Some Gateway MX series laptops M255 m2 2 Some Gateway MX series laptops m3 Some Gateway MX series laptops m5 Some Gateway MX series laptops MP6954 m6 Some Gateway NX series laptops auto BIOS setup default STAC9227 9228 9229 927x ref Reference board ref no jd Reference board without HP Mic jack detection 3stack D965 3stack 5stack D965 5stack SPDIF 5stack no fp D965 5stack without front panel dell 3stack Dell Dimension E520 dell bios Fixes with Dell BIOS setup volknob Fixes with volume knob widget 0x24 auto BIOS setup default STAC92HD71B ref Reference board dell m4 1 Dell desktops dell m4 2 Dell desktops dell m4 3 Dell desktops hp m4 HP mini 1000 hp dv5 HP dv series hp hdx HP HDX series hp dv4 1222nr HP dv4 1222nr with LED support auto BIOS setup default STAC92HD73 ref Reference board no jd BIOS setup but without jack detection intel Intel DG45 mobos dell m6 amic Dell desktops laptops with analog mics dell m6 dmic Dell desktops laptops with digital mics dell m6 Dell desktops laptops with both type of mics dell eq Dell desktops laptops alienware Alienware M17x auto BIOS setup default STAC 92HD 83 ref Reference board mic ref Reference board with power management for ports dell s14 Dell laptop hp HP laptops with inverted mute LED hp dv7 4000 HP dv 7 4000 auto BIOS setup default STAC9872 vaio VAI
60. atabase backups directory T his should ensure that a storage restore can be made along with a matching and complete version of the Airtime database from the day that the storage backup was made STORAGE BACKUP Backing up the Airtime database with pg dumpall will not back up the Airtime media storage server which is likely to need a great deal more backup space Creating a compressed file from hundreds of gigabytes of storage server contents is likely to take a very long time and may have little benefit for the amount of CPU power used if the media files are already stored in a highly compressed format It is also impractical to copy very large backup files across the network on a daily basis Instead it is preferable to use an incremental backup technique to synchronize the production Airtime server storage with a backup server each day or night If the backup server also contains an Airtime installation it should be possible to switch playout to this second machine relatively quickly in case of a hardware failure or other emergency on the production server 124 A standard incremental backup tool on GNU Linux servers is rsync http rsync samba org which can be installed using the package manager of your GNU Linux distribution However incremental backup alone cannot help in the scenario where a file which later proves to be important has been deleted by an administrator For backups that can be rolled back to restore from an earlier
61. ation you can run the program with the command exfalso The Tags From Path feature of this program is a particularly useful time saver if you have a large archive of untagged files Sometimes there is useful creator or title information in the file name or directory path structure which can be converted into an ID3 tag automatically 117 Folders Edit Tags Tags From Path Rename Files Track Numbers v B mp3 r gt P3 Arcade Fi lt artist gt lt album gt lt tracknumber gt tit v Preview gt E Beck File artist all gt E I Am Klog 01 Against The Wall mp3 Tenor amp Tony Allen In v B Jimi Tenot 02 Sinuhe mp3 Jimi Tenor amp Tony Allen In 03 Selfish Gene mp3 Jimi Tenor amp Tony Allen In E Outer Gal 04 Path To Wisdom mp3 Jimi Tenor amp Tony Allen In Pointy Bi 05 Darker Side Of Night mp3 Jimi Tenor amp Tony Allen In E Strut 06 Mama England mp3 Jimi Tenor amp Tony Allen E strutsamp 07 Got My Egusi mp3 Jimi Tenor amp Tony Allen 08 Cella s Walk mp3 Jimi Tenor amp Tony Allen 09 Three continents mp3 Jimi Tenor amp Tony Allen Bi 01 Against The Wal 02 Sinuhe mp3 B 03 Selfish Gene mp li 04 Path To Wisdom 05 Darker Side Of N 06 Mama England r 07 Got My Egusi m Replace underscores with spaces Title case tags Split into multiple values Tags repla
62. ce existing ones 71 Plugins 9 songs METADATA IN LEGACY CHARACTER SETS Airtime expects file tag metadata to be stored in the international UTF 8 character set Programs such as Ex Falso described above encode metadata in UT F 8 by default If you have an archive of files encoded with metadata in a legacy character set such as the Cyrillic encoding Windows 1251 you should convert these files before import The program mid3iconv part of the python mutagen package in Debian and Ubuntu can be used to batch convert the metadata character set of files on the command line You can install python mutagen with the command sudo apt get install python mutagen For example to preview the conversion of tags from Windows 1251 CP1251 character set to UT F 8 for a whole archive of MP3 files you could use the command find name mp3 print xargs 0 mid3iconv e CP1251 d p in the base directory of the archive The d option specifies that the new tag should be printed to the server console debug mode and the p option specifies a preview run T his preview will enable you to confirm that the metadata is being read and converted correctly before writing the new tags 118 To actually convert all of the tags and strip any legacy ID3v tag present from each file at the same time you could use the command find name x mp3 print xargs 0 mid3iconv e CP1251 remove v1 The name of the or
63. ct repository mirror URLs in your sources list file will differ from the above screenshot depending on your location The Sourcefabric repository contains packages for Airtime and any other packages which Airtime requires To add the Sourcefabric repository to an Ubuntu Lucid server scroll to the end of the sources list file and add the following line deb http apt sourcefabric org lucid main 96 For Ubuntu 10 10 Maverick 11 04 Natty 11 10 Oneiric or 12 04 Precise substitute maverick natty oneiric or precise in place of lucid in the line above GNU nano Also please note that software in backports WILL NOT receive any revi or updates from the Ubuntu security team deb http gb archive ubuntu com ubuntu lucid backports main restricte deb src http gb archive ubuntu com ubuntu lucid backports main restr Uncomment the following two lines to add software from Canonical s partner repository This software is not part of Ubuntu but is offered by Canonical and t respective vendors as a service to Ubuntu users deb http archive canonical com ubuntu lucid partner deb src http archive canonical com ubuntu lucid partner deb http security ubuntu com ubuntu lucid security main deb http security ubuntu com ubuntu lucid security universe deb http apt sourcefabric org lucid maini me Get Help 8 WriteOut ga Read FilegM Prev Cut Text Me Cur Pos ai Exit Justify gl wher
64. d assemble them into a continuous stream T his stream can be sent to a soundcard e g for a broadcast mixer on the way to an FM or DAB transmitter or to a streaming server for IP network distribution such as LAN local WiFi or the Internet You can stream to a soundcard and to IP networks with the same server if you wish 4 Icecast http www icecast org is the default streaming server and there is also support for SHOUT cast http www shoutcast com but in theory you could stream from Liquidsoap to any online service If a suitable software interface is not available for your streaming service of choice you can send audio from Liquidsoap to a separate encoding or streaming machine via a soundcard 5 Airtime manages all of these components and provides an easy multi user web interface to the system It enables your station staff to a upload media files to the storage server b automatically import the file metadata into the PostgreSQL database C search for and download media files and edit the metadata of individual files if required d create and edit playlists of media files and audition them playlists are also saved in the database e schedule broadcast shows which can contain playlists pre recorded complete shows or be live for specific dates and times on a calendar f automatically record live shows at specific times and dates in 256 kbps Ogg Vorbis format from the soundcard input with Ecasound upload them
65. d card but without a desktop you can control sound input and output levels using the command line program alsamixer 00 Haster Surround Surround Center LFE This program should already be installed on an Ubuntu or Debian machine with a sound card If not you can install it with the command sudo apt get install alsa utils 90 REMOVE WEBMIN IF INSTALLED The webmin control panel http www webmin com has been known to remove Apache and PHP packages on Debian and Ubuntu systems which can cause the Airtime package to be removed in turn T his problem is easily reversed by re installation of the affected packages but it has the potential to disrupt your broadcast playout from Airtime Webmin is not likely to be installed on your server unless your system administrator has installed it manually T his is because webmin was removed from official Debian and Ubuntu package repositories some years ago RABBITMQ HOSTNAME RabbitMQ requires a fixed and resolvable hostname see http www rabbitmq com ec2 htmlztissues hostname which is normal for a server For a desktop or laptop machine where the hostname changes frequently or is not resolvable this issue may prevent RabbitMQ from starting When using a desktop or laptop computer with a dynamic IP address such as an address obtained from a wireless network the rabbitmq server daemon must not start up before the NetworkManager service RABBITMQ ON DEBIAN In Debian 6 0 Sq
66. d in the line beginning allow admin on a regular basis like you would for any important password T he password for the read only guest access should remain as airtime because Airtime uses this password to collect information for the Status page of the administration interface set httpd port 2812 and use address localhost allow localhost allow 10 0 1 2 255 255 255 0 allow admin LGW12WB9J7 allow guest airtime read only Press Ctrl OO to save the file then Ctrl X to exit nano Then restart Monit with sudo invoke rc d monit restart 131 SENDING EMAIL ALERTS To configure Monit to send email alerts edit the file etc monit monitrc to uncomment the set mailserver parameter Change this line to show the name of the SMTP server on your Airtime server s network as provided by your system administrator sudo nano etc monit monitrc etc monit monitrc set statefile var monit state Set the List of mail servers for alert delivery Multiple servers may b specified using comma separator By default monit uses port 25 this is possible to override with the PORT option B set mailserver mail bar baz primary mailserver backup bar baz port 10025 backup mailserver on port 1 localhost fallback relay By default monit will drop alert events if no mail servers are availabl If you want to keep the alerts for a later delivery retry you can use EVENTQUEUE statement The base directory
67. d maximum click on the corresponding place in the orange bar with maximum level on the right side Click on the left side speaker icon to mute the output Live stream Mozilla Firefox 23 i amp J airtime 64studio com Dashboard stream player Live stream 72 When you have finished monitoring the streams you can close the pop up window in the normal way depending on the browser you are using In Firefox you can close the window by clicking the X button in the top right corner This action will not shut down the output from the Airtime server only the stream monitoring on your desktop computer 73 7 HELP T he first entry on Airtime s Help menu offers a Getting Started guide for new users Further down there is also a link to the online version of this User Manual and an About page which displays version and licensing information NOW PLAYING ADD MEDIA PLAYLIST BUILDER CALENDAR Airtime 7 SOURCEFABRIC user manual You can visit the Airtime online support forum and sign up for the mailing list at http forum sourcefabric org categories airtime support T his forum is mirrored by the mailing list so posts on the forum appear on the mailing list and vice versa You can therefore also post a message there by emailing airtime support lists sourcefabric org To subscribe to forum updates via mail please register or login to the forum by clicking the appropriate link T hen click the Subscribe but
68. date than the current backup the tool rdiffbackup http www nongnu org rdiff backup can be deployed 125 3 0 e UPGRADING Airtime 2 1 x versions support upgrading from version 1 8 0 and above If you are running a production server with a version of Airtime prior to 1 8 0 you should upgrade it to version 1 8 0 before continuing Before upgrading a production Airtime server you should back up both the PostgreSQL database and the storage server used by Airtime T his is especially important if you have not already set up a regular back up routine T his extra back up is a safety measure in case of accidental data loss during the upgrade for example due to the wrong command being entered when moving files See the chapter Backing up the server in this book for details of how to perform these back ups If you have deployed Airtime using the method shown in the Automated installation chapter you can upgrade in the same way A new Airtime package available in the Sourcefabric repository can be installed with sudo apt get update sudo apt get upgrade If you have used the method shown in the Manual installation chapter you should repeat the installation steps of downloading and unpacking the tarball to an installation directory and running the airtime install script T he installation script will detect an existing Airtime deployment and back up any configuration files that it finds After the upgrade has completed you may need to c
69. displays information about the current show show time elapsed and show time remaining as well as some information about the next show start time and end time In this example the label text for onAirNow is translated into French for local language support script document ready function headerLiveHolder airtimeLiveInfo sourceDomain http schedule example com text onAirNow Sur Les Antennes offline Offline current Current next Next updatePeriod 20 seconds D D lt script gt On the public website this widget can be made to look like the following screenshot SUR LES ANTENNES gt gt Current Newslink 04 51 r 25 08 The CSS properties color and text transform uppercase have been used to style the onAirNow label T here is a full example CSS file widgets css airtime widgets css in the Airtime installation tarball or usr share doc airtime examples directory The next widget airtimeShowSchedule is medium siz ed and displays the upcoming show schedule for that day script 146 document ready function onAirToday airtimeShowSchedule sourceDomain http schedule example com text onAirToday On air today j updatePeriod 5 seconds D D lt script gt The widget code above can be styled to look like this screen shot On air today 16 00 16 30 Newslink 16 30 Pages of History 17 00 EN 17 00 17 30 L Info Chez Vou
70. dule export would contain a great deal more text sunday monday show starts 2011 05 09 14 25 00 show ends 2011 05 09 14 35 00 show name Elvis Show url http V NVelvis example comVM 5 show starts 2011 05 09 14 50 00 show ends 2011 05 09 14 55 00 show name News url http V N news example com show starts 2011 05 09 16 00 00 show ends 2011 05 09 17 00 00 show name Funk Show url http NV N funk example comMV j show starts 2011 05 09 17 00 00 show ends 2011 05 09 18 00 00 show name Dance show url http V N dance example com 1 tuesday wednesday thursday friday saturday If you see the message You are not allowed to access this resource when attempting to display schedule information in your web browser log in to the Airtime administration interface click System in the main menu then Preferences Set Allow Remote Websites To Access Schedule Info to Enabled click the Submit button then refresh the browser window opened on the schedule export URL 143 CACHING SCHEDULE INFORMATION If the Airtime server is behind a firewall or you want to protect the Airtime server from large numbers of schedule requests you may wish to cache the schedule information on a public facing or intermediate server You can then create a firewall rule that only allows the schedule server to connect to t
71. e Is gi Next UnCut Texg To Spell Press Ctrl O the Ctrl key and the letter O together to save the file then Ctrl X to exit the nano editor SET UP REPOSITORIES FOR DEBIAN On a Debian squeeze server you can edit the etc apt sources ist file as root with the command nano etc apt sources list Packages for MP3 encoding are not included in the Debian squeeze repositories You can obtain the necessary libmp3lameo package by adding the following repository to the end of the file deb http backports debian org debian backports squeeze backports main To add the Sourcefabric repository to a Debian squeeze server add the following line to the end of the file deb http apt sourcefabric org squeeze main Press Ctrl O the Ctrl key and the letter O together to save the file then Ctrl X to exit the nano editor INSTALL THE SOURCEFABRIC SIGNING KEY Reload the system s package list with sudo apt get update You will see an error message about a missing public key 97 Hit http gb archive ubuntu com lucid Release Hit http gb archive ubuntu com lucid updates Release Hit http gb archive ubuntu com lucid main Packages Hit http gb archive ubuntu com lucid universe Packages Hit http gb archive ubuntu com lucid multiverse Packages Hit http gb archive ubuntu com lucid updates main Packages Hit http gb archive ubuntu com lucid updates universe Packages Hit http gb archive ubuntu com lucid upda
72. e switch to the On Air indicator like a patch cable connecting a mixer to a transmitter 29 ON AIR To TT LISTEN 1 JOD If you have checked the Auto Source Transition box in the Stream Settings page the Master Source switch will move automatically to the active position on the left when an authenticated master source connects to Airtime Otherwise you can activate the switches manually by clicking the left side of each switch or deactivate them by clicking the right side T he switches do not have to be dragged with the mouse in the way that a switch on a hardware mixer would be pushed sideways Show Source live input streams and Scheduled Play can be manually activated or deactivated in the same way Station time ON AIR 16 07 4 SCT LISTEN To force disconnection of a live remote source for example when the remote input source has crashed and is no longer sending audio data click the X icon to the left of the source name OUTPUT STREAM SETTINGS On the right side of the page you can configure up to three independent output streams with different bit rates and send these streams to different Icecast or SHOUT cast servers By default only Stream is enabled with this stream being sent to lcecast on the same server at the localhost IP address of 127 0 0 1 To configure another stream click the bar with the stream number to expand its box and make sure Enabled is checked Enter at least the streaming Serv
73. eading BIOS default ALC861VD 660VD 3stack 3 jack 3stack dig 3 jack with SPDIF OUT 6stack dig 6 jack with SPDIF OUT 3stack 660 3 jack for ALC660VD 3stack 660 digout 3 jack with SPDIF OUT for ALC660VD lenovo Lenovo 3000 C200 dallas Dallas laptops hp HP TX1000 asus vis ASUS V1Sn auto auto config reading BIOS default CMI9880 minimal 3 jack in back min fp 3 jack in back 2 jack in front full 6 jack in back 2 jack in front full dig 6 jack in back 2 jack in front SPDIF I O allout 5 jack in back 2 jack in front SPDIF out auto auto config reading BIOS default AD1882 AD1882A 3stack 3 stack mode default 155 6stack 6 stack mode AD1884A AD1883 AD1984A AD1984B desktop 3 stack desktop default laptop laptop with HP jack sensing mobile mobile devices with HP jack sensing thinkpad Lenovo Thinkpad X300 touchsmart HP Touchsmart AD1884 basic 3 jack default hp HP nx6320 thinkpad Lenovo Thinkpad T60 X60 260 toshiba Toshiba U205 AD1983 basic default configuration thinkpad Lenovo Thinkpad T61 X61 dell desktop Dell T3400 AD1986A 6stack 6 jack separate surrounds default 3stack 3 stack shared surrounds laptop 2 channel only FSC V2060 Samsung M50 laptop eapd 2 channel with EAPD ASUS A6J laptop automute 2 channel with EAPD and HP automute Lenovo N100 ultra 2 channel with EAPD Samsung Ultra tablet PC samsung 2 channel with EAPD Samsung R65 samsung p50 2 channel with
74. ect code If the place to copy the object code is a network server the Corresponding Source may be on a different server operated by you or a third party that supports equivalent copying facilities provided you maintain clear directions next to the object code saying where to find the Corresponding Source Regardless of what server hosts the Corresponding Source you remain obligated to ensure that it is available for as long as needed to satisfy these requirements e e Convey the object code using peer to peer transmission provided you inform other peers where the object code and Corresponding Source of the work are being offered to the general public at no charge under subsection 6d A separable portion of the object code whose source code is excluded from the Corresponding Source as a System Library need not be included in conveying the object code work A User Product is either 1 a consumer product which means any tangible personal property which is normally used for personal family or household purposes or 2 anything designed or sold for incorporation into a dwelling Ih determining whether a product is a consumer product doubtful cases shall be resolved in favor of coverage For a particular product received by a particular user normally used refers to a typical or common use of that class of product regardless of the status of the particular user or of the way in which the particular user actually uses or expects or
75. ence from Phonographic Performance Limited PPL to play music online including digital recordings converted from commercially released CDs vinyl or tape T ypically you have to provide full statistical details to the royalty society of all music streamed or downloaded from your site which can be onerous Even if your radio station is mostly speech there are many limitations in the small print of these music licences For instance you can t use music for promotional purposes and you can t stream a whole opera without negotiating separate licences Weirdly you are not allowed to play a piece of music derogatory context to the writer or performers no drummer jokes allowed then However the biggest pitfall is that these MCPS PRS licences for publishing rights only cover listeners in the UK For recording rights PPL is a member of the IFPI reciprocal scheme for webcasters which means its licenses cover listeners in some European countries Australia New Zealand and a few other countries but not listeners in the USA or Canada So if your Internet station picked up a significant number of listeners in countries not covered by the MCPS PRS licences or the IFPI reciprocal scheme you would have to pay for similar music licences in those countries as well It s no wonder that many not for profit radio stations have disappeared from the virtual airwaves over the last few years since not having the right licences could leave the operator l
76. er IP address or domain name and Port details The default port for Icecast and SHOUT cast servers is 8000 30 Click Additional Options to expand a box in which you can enter the Username Password and metadata to send to the streaming server The default Username for lcecast servers is source and if this the name in use on your streaming server you can leave this field empty You can also set the specific Mount Point that listeners will connect to here T hen click one of the Save buttons in the upper or lower right corner to update the Airtime server s settings 3l Connected to the streaming server When selecting a SHOUT cast server from the Service Type drop down menu you are restricted to using MP3 format only so the choice of Ogg Vorbis format is greyed out in the Stream Type drop down menu The SHOUT cast username for stream sources is fixed so you do not need to enter this value under Additional Options but you will usually have to enter a password 32 Any connection problems between Liquidsoap and Icecast or SHOUT cast are shown on the Stream Settings page For example if you enter the wrong password you will see an Authentication Required error message T o fix this enter the correct password in the Additional Options box and click the Save button 401 Authentication Required HTTP 1 0 Sal 33 9 e SUPPORT FEEDBACK If you did not already register Airtime when you installed it as shown in the
77. es 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 E Add this show 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 66 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 T his 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 new show length is calculated automatically ADDING CONTENT TO A SHOW T o add conte
78. ew configuration You may also need to disable the default site configuration which may otherwise interfere with your Airtime installation sudo a2dissite default As suggested by the output of the command above reload the web server configuration sudo etc init d apache2 reload The server should respond Reloading web server config apache2 7 Download Airtime from https sourceforge net projects airtime files with wget For example to download version 2 1 3 you could use the command wget http downloads sourceforge net project airtime 2 1 3 airtime 2 1 3 tar gz 108 8 Unzip the downloaded file in your home directory This action will create a subdirectory called airtime2 r 3 sudo tar xvzf airtime 2 1 3 tar gz C 9 Monit is a utility which Airtime uses to make sure that the system runs smoothly Enable it by opening the etc default monit file in the nano editor sudo nano etc default monit Find the line that begins with startup and change the value to startup 1 Save the file with Ctrl O and close nano with Ctrl X Now copy the Monit configuration from the Airtime install directory to the etc monit conf d directory sudo cp airtime 2 1 3 python apps monit airtime monit cfg etc monit conf d Open the etc monit monitrc file in nano sudo nano etc monit monitrc At the end of the file add the line include etc monit conf d x Save the file with Ctrl O and close nano with Ctrl X T hen start
79. f with Firstly in the lt head gt tag of the document you ll see some code like this document ready function jquery_jplayer_1 jPlayer ready function this jPlayer setMedia oga http localhost 8000 airtime 128 jPlayer play F5 ended function event this jPlayer play swfPath js supplied oga This code loads jPlayer and specifies the source of the Airtime stream T he stream setting of http localhost 80oo airtime 128 will work if you are testing jPlayer directly on the Icecast server that Airtime is connecting to When testing on a remote server you should change this setting to the IP address or domain name port number and mount point of the Icecast server you are using As soon as jPlayer has finished loading it will automatically begin to play the stream T he parameters ready ended swfPath and supplied are arguments passed to jPlayer A full list of constructor arguments is available in the jPlayer Developer Guide at http www jplayer org latest developer guide 140 JPLAYER CONTROLS Secondly the lt body gt tag of the file jplayerdemo html defines the controls displayed by jPlayer These controls can be as simple as just one Play Pause button or a fully fledged playback interface with a playlist progress bar and volume control T his example code uses one of the simpler skins available for jPlayer Blue Monday A stop button or
80. f your Airtime server was accessible at http airr example com the live show information could be retrieved by your web server using this URL http airl1 example com api live info callback The comma separated text metadata returned to your web server might be something like this env development schedulerTime 2011 05 09 15 01 18 currentShow start timestamp 2011 05 09 16 00 00 end timestamp 2011 05 09 17 00 00 name Funk Show idi g instance id 8 record Q url http NV N funk example comV 3 nextShow id 9 starts 2011 05 09 17 00 00 ends 2011 05 09 18 00 00 show id 9 record Q rebroadcast Q instance id null file id null soundcloud id null time filled null name Dance show url http dance example com genre Dance description Techno techno techno techno color 000000 background color ffea00 start timestamp 2011 05 09 17 00 00 end timestamp 2011 05 09 18 00 00 timezone BST timezoneOffset 3600 n The information for the current week s schedule could be retrieved using the URL 142 http airl example com api week info callback In this case the metadata returned would be in a different format from the above example something like the following To keep the example short this particular schedule export only contains four shows on a Monday A full weekly sche
81. from Audacity below 119 COPYING VERSUS WATCHING There are three main options when using the airtime import script Either to copy or move files into Airtime s main storage folder or to watch files elsewhere Each option has advantages and disadvantages so you will have to think about how the files will be used in your station in the long term e For files that are copied or moved you may run into problems with hard disk space if you do not remove files from the storage server periodically e For files that are watched you must make sure that the files are actually going to be there at playout time otherwise they will be skipped For this reason it is not recommended to use the watch option for easily removable storage like MP3 players or USB memory sticks T here s a strong likelihood that the storage might be unplugged and taken away before playout time It is also important to make sure that any external hard disk with watched files is powered on and stays on The airtime import script works from the command line so you must first log into a console on the Airtime server In recent versions of Airtime you no longer need to specify the full file system path to the media files that you wish to import Copying is specified with the copy sub command airtime import copy directory where lt directory gt is the base directory of the media files that you wish to import Alternatively you may wish to delete
82. ge also shows how much Disk Space you have used on the disk partition containing the main Import Folder as well as any disks or partitions with watched folders NOW PLAYING ADD MEDIA PLAYLIST BUILDER CALENDAR SYSTEM Service 14 1MB 0 2 22 2MB 0 3 12 8MB 0 2 20 2MB 0 3 13 0GB of 17 7GB 73 1 in use If any of the check mark icons in the Status column have changed to a red warning sign contact your system administrator for assistance Airtime will do its best to restart any failing services but sometimes manual intervention may be required for example in the case of hardware failure If you have run out of storage space an Airtime user with admin privileges could log in and delete media files that are no longer required from the Playlist Builder Alternatively you could move some files to a watched folder on another disk or ask your system administrator to install additional storage capacity 37 e PLAYOUT HISTORY On the System menu the Playout History page enables you to view a list of files played within a specific date range or matching a specified search term T his page is designed to help your station prepare reports for music royalty collection societies and regulatory agencies Select a date and time range by clicking the calendar and clock icons in the upper left corner of the page T hen click the search button which has a magnifying glass icon to the right A list of files played du
83. gram Later license versions may give you additional or different permissions However no additional obligations are imposed on any author or copyright holder as a result of your choosing to follow a later version 168
84. h CONFIG_SND_DEBUG y auto auto config reading BIOS default ALC 260 hp HP machines hp 3013 HP machines 3013 variant hp dc7600 HP DC7600 fujitsu Fujitsu S7020 acer Acer TravelMate will Will laptops PB V7900 replacer Replacer 672V favorit100 Maxdata Favorit 100XS basic fixed pin assignment old default model test for testing debugging purpose almost all controls can adjusted Appearing only when compiled with CONFIG_SND_DEBUG y auto auto config reading BIOS default ALC 262 fujitsu Fujitsu Laptop hp bpc HP xw4400 6400 8400 9400 laptops hp bpc d7000 HP BPC D7000 hp tc t5735 HP Thin Client T5735 hp rp5700 HP RP5700 benq Benq ED8 benq t31 Benq T31 hippo Hippo ATI with jack detection Sony UX 90s hippo 1 Hippo Benq with jack detection sony assamd Sony ASSAMD toshiba s06 Toshiba S06 toshiba rx1 Toshiba RX1 tyan Tyan Thunder n6650W S2915 E ultra Samsung Q1 Ultra Vista model lenovo 3000 Lenovo 3000 y410 153 nec NEC Versa S9100 basic fixed pin assignment w o SPDIF auto auto config reading BIOS default ALC267 268 quanta il1 Quanta IL1 mini notebook 3stack 3 stack model toshiba Toshiba A205 acer Acer laptops acer dmic Acer laptops with digital mic acer aspire Acer Aspire One dell Dell OEM laptops Vostro 1200 zepto Zepto laptops test for testing debugging purpose almost all controls can adjusted Appearing only when compiled with CONFIG_SND_DEBUG y auto auto config reading BIOS
85. he Airtime server in addition to any remote users of the Airtime web interface Your system administrator can set up schedule caching on a standard Apache and PHP enabled web server with the curl program installed using the following steps Create a bash script on the schedule server schedule example com that polls the remote Airtime server airr example com and writes the metadata returned into a pair of local temporary files sudo nano usr local bin airtime schedule sh The content of this file should be like the following script replacing airr eexample com with the name of your Airtime server bin sh curl s http airl example com api live info callback x gt tmp live info curl s http airl example com api week info callback gt tmp week info 2 Make the bash script executable 144 sudo chmod x usr local bin airtime schedule sh 3 Create an Apache VirtualHost configuration for the schedule server sudo nano etc apache2 sites available schedule containing a definition like the following replacing schedule example com with the name of your schedule server lt VirtualHost 80 gt ServerName schedule example com DocumentRoot var www schedule lt VirtualHost gt 4 In the schedule server s DocumentRoot folder create the folders api liveinfo and api week info sudo mkdir p var www schedule api live info sudo mkdir p var www schedule api week info 5 Create an index php f
86. he work must carry prominent notices stating that it is released under this License and any conditions added under section 7 T his requirement modifies the requirement in section 4 to keep intact all notices e You must license the entire work as a whole under this License to anyone who comes into possession of a copy T his License will therefore apply along with any applicable section 7 additional terms to the whole of the work and all its parts regardless of how they are packaged T his License gives no permission to license the work in any other way but it does not invalidate such permission if you have separately received it e d If the work has interactive user interfaces each must display Appropriate Legal Notices however if the Program has interactive interfaces that do not display Appropriate Legal Notices your work need not make them do so A compilation of a covered work with other separate and independent works which are not by their nature extensions of the covered work and which are not combined with it such as to forma larger program in or on a volume of a storage or distribution medium is called an aggregate if the compilation and its resulting copyright are not used to limit the access or legal rights of the compilation s users beyond what the individual works permit Inclusion of a covered work in an aggregate does not cause this License to apply to the other parts of the aggregate 6 Conveying Non Source Forms
87. hey know their rights Developers that use the GNU GPL protect your rights with two steps 1 assert copyright on the software and 2 offer you this License giving you legal permission to copy distribute and or modify it For the developers and authors protection the GPL clearly explains that there is no warranty for this free software For both users and authors sake the GPL requires that modified versions be marked as changed so that their problems will not be attributed erroneously to authors of previous versions Some devices are designed to deny users access to install or run modified versions of the software inside them although the manufacturer can do so T his is fundamentally incompatible with the aim of protecting users freedom to change the software T he systematic pattern of such abuse occurs in the area of products for individuals to use which is precisely where it is most unacceptable T herefore we have designed this version of the GPL to prohibit the practice for those products If such problems arise substantially in other domains we stand ready to extend this provision to those domains in future versions of the GPL as needed to protect the freedom of users 160 Finally every program is threatened constantly by software patents States should not allow patents to restrict development and use of software on general purpose computers but in those that do we wish to avoid the special danger that patents applied
88. iable to legal action If you want to go down the commercial music route check out the http www prsformusic com and http www ppluk com websites for UK licence details T he http www soundexchange com website currently quotes a 500 dollar minimum annual fee for non commercial webcasters plus a usage fee above a certain number of listener hours for the right to stream music recordings to listeners in the USA See the websites of ASCAP BMI and SESAC for details of music publishing royalties payable by webcasters streaming to the USA Free content streaming offers the chance that DIY Internet radio could rise again Since royalty collection societies like MCPS PRS and SoundExchange can only represent the interests of their own members it follows that if you are not a member you can stream your own self produced content without paying for their licences If you state somewhere on your website that the stream is of your own copyrighted material and is made available to the public under a specific licence then no one should misunderstand your intentions You might be able to persuade other people to allow you to stream their content too as long as they do not have a conflicting legal obligation such as having previously joined one of the many royalty collection societies around the world You can ask for permission to stream when website visitors upload their own music files to you via a HT ML form much as the likes of SoundCloud do Or you can c
89. iginal character set follows the e option Other legacy character sets that mid3iconv can convert to UT F 8 include KOI8 R Russian KOI8 U Ukrainian GBK Traditional Chinese GB2312 Simplified Chinese EUC KR Korean EUC JP Japanese CP1253 Greek CP1254 Turkish CP1255 Hebrew CP1256 Arabic SILENCE IN MEDIA FILES Before importing media it is good practice to check for any silent sections in the media files While Airtime can compensate for leading and trailing silence with the use of cue in and cue out points in the Playlist Builder it is better to trim these files to the intended length before upload T his is because trimmed files do not require station staff to set cue points manually as media in the Airtime library could potentially be re used for many different shows Audacity is a cross platform editor suitable for the task of trimming audio files available from http audacity sourceforge net Very quiet introductions or over long fades can also lead to apparent gaps in your broadcast playout Some audio CDs feature a hidden track at the end which in fact uses a long period of silence within the final track rather than an actual separate track on the disc T his means that CD encoding programs will encode both the hidden material and the silence in the media file For example the track Debra from the CD Midnite Vultures by Beck includes hidden material preceded by seven minutes of silence as shown in the screen shot
90. ile in the api liveinfo folder sudo nano var www schedule api live info index php containing the following code php filename tmp live info define here the path and name of uploaded live info file header Content Type text javascript header Expires Thu 01 Jan 1970 00 00 00 GMT header Cache Control no store no cache must revalidate callback empty GET callback null GET callback content file get contents filename content str replace callback content echo content gt 6 Create an index php file in the api week info folder sudo nano var www schedule api week info index php containing the following code php filename tmp week info define here the path and name of uploaded week info file header Content Type text javascript header Expires Thu 01 Jan 1970 00 00 00 GMT header Cache Control no store no cache must revalidate callback empty GET callback null GET callback content file get contents filename content str replace callback content echo content gt 7 Enable the new configuration and reload the Apache web server sudo a2ensite schedule sudo etc init d apache2 reload 8 Create a cron job to run the bash script each minute sudo nano etc cron d airtime schedule containing the line 145 x x www data usr local bin airtime schedule sh The schedu
91. iles to the upload queue and click the start button Filename 1 14 Justo Betancourt Pa Bravo Yo mp3 01 Love Dancing mp3 Uploaded 0 2 files Once it has been uploaded successfully each file row displays a white check mark ina green circle icon 100 Your files are now imported into the Airtime library ready to be included in your broadcast playlists and shows 49 4 PLAYLIST BUILDER This page of the Airtime interface enables you to search the media library sort and display the search results by the criteria that you choose audition files and playlists and drag and drop search results into an open playlist You can also re arrange the currently open playlist by dragging and dropping The Playlist Builder page is not visible to Guest users SEARCHING THE LIBRARY On the left side of the Playlist Builder page a table displays both the media files and the playlists in the Airtime library with ten items shown per page by default Use the drop down menu at the top to choose from Files Playlists or All items Click the Show drop down menu in the top right corner to set the display of between 5 and 100 items per page according to your preference You can also click the Show hide columns button to determine which metadata is displayed NOW PLAYING ADD MEDIA PLAYLIST BUILDER Show hide cL N 15 9 20 M 25 50 d 100 1 its Just the Night I Am Kloot Sky at Night C 4 1 Still D
92. ime server to use an encryption key pair for the uploads account instead of a password See https help ubuntu com community SSH OpenSSH Keys for details of how to do this on an Ubuntu server 136 34 ICECAST HANDOVER In a typical radio station configuration the live output from the broadcast studio and the scheduled output from Airtime are mixed together before being sent further along the broadcast chain to a transmitter or streaming media server on the Internet T his may not be the case if your Airtime server is remote from the studio and you are using the Show Source Mount Point or Master Source Mount Point to mix live and scheduled content See the Stream Settings chapter for details If your Icecast server is hosted in a remote data centre you may not have the option to handover the streaming media source manually because you have no physical access to connect a broadcast mixer to the server Disconnecting the stream and beginning another is less than ideal because the audience s media players will also be disconnected when that happens The Icecast server has a fallback mount feature which can be used to move clients media players used by listeners or viewers from one source to another as new sources become available T his makes it possible to handover from Airtime output to a show from another source and handover to Airtime again once the other show has ended T o enable fallback mounts edit the main Icecast config
93. in name instead For example http airtime example com You can log in for the first time with the user name admin and the password set during installation Your browser should automatically focus on the Username field amp oR File Edit View History Bookmarks Tools Help J Airtime 9 airtime example com login v gt wy a 6 amp v Login Username If you enter the password incorrectly three times you will be presented with a reCAPT CHA challenge to prove that you are a human and not a password guessing robot T his feature helps protect your Airtime installation against brute force attacks Login Wrong username or password provided Please try again Username Password Type the characters you see in the picture below Type the two words e CAPTCHA ichthyology domshlou C If configured you will see a link Reset password below the password field which enables you to obtain a password reminder by email See the chapter Preferences to configure this feature Airtime 7 SOURCEFABRIC Reset password E mail dj example com Restore password REGISTER AIRTIME After you have logged in as admin for the first time a pop up window will ask if you wish to send technical support data about your server to Sourcefabric Current Show Register Airtime Help Airtime improve by letting us know you are using it This info will be collected regularly in order to improve
94. inal licensors to run modify and propagate that work subject to this License You are not responsible for enforcing compliance by third parties with this License An entity transaction is a transaction transferring control of an organization or substantially all assets of one or subdividing an organization or merging organizations If propagation of a covered work results from an entity transaction each party to that transaction who receives a copy of the work also receives whatever licenses to the work the party s predecessor in interest had or could give under the previous paragraph plus a right to possession of the Corresponding Source of the work from the predecessor in interest if the predecessor has it or can get it with reasonable efforts 166 You may not impose any further restrictions on the exercise of the rights granted or affirmed under this License For example you may not impose a license fee royalty or other charge for exercise of rights granted under this License and you may not initiate litigation including a cross claim or counterclaim in a lawsuit alleging that any patent claim is infringed by making using selling offering for sale or importing the Program or any portion of it Patents A contributor is a copyright holder who authorizes use under this License of the Program or a work on which the Program is based The work thus licensed is called the contributor s contributor version A contributo
95. ing at the file you clicked Click the small white x icon on the right hand side of each row to remove a file from the playlist You can also drag and drop files to re order them My Playlist View edit description Love Dancing Arthur s Landing Pardon Orchestre Poly Rhytmo Wozani Mahipi The M Emakhaya Madieen Kane Click the playlist Fade button two horizontal white arrows crossing ina grey rectangle to the right of the New and Delete buttons to open a beige bar in which you can set the Fade and Fade out times for this playlist The default fade time is set in the Preferences page on the System menu 56 Em My Playlist e View edit description Love Dancing Arthur s Landing Pardon Orchestre Poly Rhytmo Wozani Mahipi he Mahotella Queens Emakhaya Kane Click any one of the smaller Fade buttons between file rows to open another beige bar which enables you to set fade in and fade out times between two adjacent files in the playlist T he fade buttons for adjacent files change to an orange background when you click them mE My Playlist 19 18 4 View edit description Love Dancing Arthur s Landing Wozani Mahipi The Mahotella Queens Emakhaya Madleen Kane 57 Each file in the playlist also has a button with two square brackets which enables you to set cue in and cue out times for that particular file Like the fade button it changes
96. is stream but you can change it here if an alternativ wanted or an extension is required e Get Help 8 WriteOut ga Read Filej Prev Page ia Cut Text MS Cur Pos ai Exit ae Justify where Is gi Next UnCut Texg To Spell You should also set the value of hostname to the domain name of the Icecast server for example lt hostname gt icecast example com lt hostname gt This step ensures that stream URLs are generated correctly by the lcecast server Save and close the icecast xml file with CtrlI O and Ctrl X Then set the Icecast server to start automatically when the server boots in the etc default icecasta file sudo nano etc default icecast2 by setting the value of ENABLE to true on the last line of that file 99 ENABLE true Save and close this file with Ctrl O and Ctrl X then start Icecast sudo service icecast2 start The server should respond Starting icecast2 Starting icecast2 Detaching from the console icecast2 INSTALL AIRTIME You can now install the Airtime package with sudo apt get install airtime T his command will install all of the Airtime components plus any other packages that Airtime requires in order to run Reading package lists Done Building dependency tree Reading state information Done The following extra packages will be installed liquidsoap Suggested packages airtime audio samples The following NEW packages will be installed airtime liquidsoap 0 upgraded
97. is expected to use the product A product is a consumer product regardless of whether the product has substantial commercial industrial or non consumer uses unless such uses represent the only significant mode of use of the product Installation Information for a User Product means any methods procedures authorization keys or other information required to install and execute modified versions of a covered work in that User Product from a modified version of its Corresponding Source T he information must suffice to ensure that the continued functioning of the modified object code is in no case prevented or interfered with solely because modification has been made If you convey an object code work under this section in or with or specifically for use in a User Product and the conveying occurs as part of a transaction in which the right of possession and use of the User Product is transferred to the recipient in perpetuity or for a fixed term regardless of how the transaction is characterized the Corresponding Source conveyed under this section must be accompanied by the Installation Information But this requirement does not apply if neither you nor any third party retains the ability to install modified object code on the User Product for example the work has been installed in ROM 164 T he requirement to provide Installation Information does not include a requirement to continue to provide support service warranty or updates for
98. is inside the srv airtime stor folder on your server by default In Media folders on the System menu you can change this default location or add extra folders to be watched by Airtime If you specify a network drive as a media folder and that network becomes disconnected for any reason Airtime s media monitor will flag the files as missing in its database until the drive is reconnected If those files are still missing at the time of the show the broadcast output could be silenced For the same reason if a removable drive such as a USB memory stick or MP3 player is specified as a watched folder that drive has to be present and powered on until the corresponding show time so that the Airtime playout engine can download the files needed for the show If your station staff use removable drives to store media files it is safer to use the Add media page of the Airtime administration interface or the airtime import copy command to copy the files to the main storage server See the chapters Add media and Using the airtime import script for more details T he metadata for new media files you add to the organize folder or a watched folder will be automatically imported into the Airtime database T he organize or watched folders can be exported to computers on the local network This would enable dragging and dropping of media uploads using the file managers on the desktop computers at your studio 8 organize File Browser J m x File Ed
99. is restricted to using SFT P only it cannot be used for executing other commands in a login shell sudo adduser home srv airtime uploads shell usr lib sftp server uploads The server will then invite you to type in the password for the new uploads user and once again for confirmation T he security of your Airtime server depends on the strength of the password that you set so be sure to use a long and complex password with upper case lower case and numerical characters It is not necessary to set a full name or other details for this account Adding user uploads Adding new group uploads 1003 Adding new user uploads 1002 with group uploads Creating home directory srv airtime uploads Copying files from etc skel Enter new UNIX password Retype new UNIX password passwd password updated successfully Changing the user information for uploads Enter the new value or press ENTER for the default Full Name Room Number Work Phone Home Phone Other Is the information correct Y n Y Next create a folder to contain the incoming files sudo mkdir srv airtime uploads incoming T hen create a script to run once per hour sudo nano etc cron hourly airtime upload 135 The script should import the newly uploaded files from the incoming folder specified using the copy option and then remove the original uploaded files T his step rather than simply using the watch option on
100. it View Go Bookmarks Help Back 4 el E amp 10 amp Places v X 5 airtime stor organize B daniel T Desktop File System t Network Audio Disc e Wastebasket B Music B Downloads 0 items Free space 5 4 GB A file dropped into the organize folder will appear to vanish as the metadata is read and the file is moved to the correct location under the imported directory according to its creator and title T his means you can find files for download and editing using a file browser on your server as well as in the Search table in the Playlist Builder This location could be under a filesystem path such as srv airtime stor imported Beck Midnite Vultures in the screenshot below 24 Midnite Vultures File Browser File Edit View Go Bookmarks Help Bak sp rowad y 4 Q F amp 100 Q srv airtime stor imported Beck Midnite vultures J 06 Peaches amp Cream 128kbps mp3 1 item Free space 5 4 GB If a media file is corrupted and cannot be played by Liquidsoap Airtime will move the file to the problem files folder in the storage archive and its metadata will not be added to the database This feature ensures that all files are tested for encoding errors before playout time Files in watched folders are not moved into the main Airtime storage folder However just like in the main storage files deleted from a watched folder will be automatical
101. ither 1 cause the Corresponding Source to be so available or 2 arrange to deprive yourself of the benefit of the patent license for this particular work or 3 arrange a manner consistent with the requirements of this License to extend the patent license to downstream recipients Knowingly relying means you have actual knowledge that but for the patent license your conveying the covered work in a country or your recipient s use of the covered work in a country would infringe one or more identifiable patents in that country that you have reason to believe are valid If pursuant to or in connection with a single transaction or arrangement you convey or propagate by procuring conveyance of a covered work and grant a patent license to some of the parties receiving the covered work authorizing them to use propagate modify or convey a specific copy of the covered work then the patent license you grant is automatically extended to all recipients of the covered work and works based on it 167 A patent license is discriminatory if it does not include within the scope of its coverage prohibits the exercise of or is conditioned on the non exercise of one or more of the rights that are specifically granted under this License You may not convey a covered work if you are a party to an arrangement with a third party that is in the business of distributing software under which you make payment to the third party based on the exten
102. known dell d23 Dell unknown dell m21 Dell Inspiron 630m Dell Inspiron 640m dell m22 Dell Latitude D620 Dell Latitude D820 dell m23 Dell XPS M1710 Dell Precision M90 dell m24 Dell Latitude 120L dell m25 Dell Inspiron E1505n dell m26 Dell Inspiron 1501 dell m27 Dell Inspiron E1705 9400 gateway m4 Gateway laptops with EAPD control gateway m4 2 Gateway laptops with EAPD control panasonic Panasonic CF 74 auto BIOS setup default STAC9205 9254 ref Reference board dell m42 Dell unknown dell m43 Dell Precision dell m44 Dell Inspiron eapd Keep EAPD on e g Gateway T1616 auto BIOS setup default STAC9220 9221 ref Reference board 3stack D945 3stack 5stack D945 5stack SPDIF intel mac v1 Intel Mac Type intel mac v2 Intel Mac Type intel mac v3 Intel Mac Type intel mac v4 Intel Mac Type intel mac v5 Intel Mac Type intel mac auto Intel Mac detect type according to subsystem id macmini Intel Mac Mini equivalent with type 3 macbook Intel Mac Book eq type 5 macbook pro v1 Intel Mac Book Pro 1st generation eq type 3 macbook pro Intel Mac Book Pro 2nd generation eq type 3 imac intel Intel iMac eq type 2 imac intel 20 Intel iMac newer version eq type 3 ecs202 ECS PC chips dell d81 Dell unknown dell d82 Dell unknown dell m81 Dell unknown dell m82 Dell XPS M1210 auto BIOS setup default STAC9202 9250 9251 ref Reference board base config m1 Some Gateway MX series l
103. le server will now be serving the same show information as the Airtime server with a cache lifetime of one minute You can adjust the cache lifetime by altering the frequency of the cron job that polls the Airtime server WEBSITE WIDGETS Example HT ML Javascript and CSS code for your public website are provided in the widgets folder of the Airtime installation tarball If you have performed an automated installation on Debian or Ubuntu the widgets can be found in the usr share doc airtime examples directory For the widgets to work on a typical web server links to the Javascript and CSS code have to be included in the HT ML page lt head gt element like the following example head meta http equiv Content Type content text html charset utf 8 gt lt title gt Airtime widgets lt title gt lt script src js jquery 1 6 1 min js type text javascript gt lt script gt lt script src js jquery ui 1 8 10 custom min js type text javascript gt lt script gt lt script src js jquery showinfo js type text javascript gt lt script gt link href css airtime widgets css rel stylesheet type text css gt lt head gt A full example is shown in the widgets sample_page html file in the Airtime installation tarball or usr share doc airtime examples directory if you have installed the Debian Ubuntu package of Airtime The following code is for a small airtimeLivelnfo widget that
104. lear your web browser s cache before logging into the new version of the Airtime administration interface If the playout engine starts up and detects that a show should be playing at the current time it will skip to the right point in the track and start playing In Airtime 1 9 0 onwards the concept of linked files was replaced with the concept of watched folders If you are upgrading from a version of Airtime earlier than 1 9 0 and you have previously linked files the folders they are in will not be watched until you add them to your watched folder list See the chapter Manage Media Folders for more details 126 3 e TROUBLESHOOTING If your Airtime server is not working as expected individual components of the system can be started stopped restarted or checked in the server console using the invoke rc d command sudo invoke rc d airtime playout start stop restart status sudo invoke rc d airtime media monitor start stop restart status sudo invoke rc d apache2 start stop restart status sudo invoke rc d rabbitmq server start stop restart status For example to restart the Airtime playout engine you could enter the command sudo invoke rc d airtime playout restart T he server should respond Restarting Airtime Playout Done The status option for airtime playout and airtime media monitor runs the airtime check system script to confirm that all of Airtime s dependencies are installed and running correctly LOG FILES Airti
105. ly flagged as missing in any playlist or show that they are part of Edits to your stored and watched media files are noticed by Airtime If you edit any file known to the database and change its duration Airtime will automatically adjust the duration of playlists and shows that the file is included in CHANGING THE STORAGE FOLDER To change Airtime s storage folder click the upper choose folder button In the pop up window that opens double click on the folder names to select the folder that you require Then click the Open button to open that folder Cancel Open Back on the Manage Media Folders page click the Set button to change the storage folder Airtime will ask if you are sure about this action Click the OK button to confirm your choice 25 Are you sure you want to change the storage folder This will remove the files from your Airtime library The Manage Media Folders page will now display the new storage location The storage folder cannot be changed while a file import is in progress If you attempt to do this an error message will be displayed Ct Choose folder WATCHING A FOLDER Under Watched Folders click the lower choose folder button open the folder you require and then click the Add button You can add as many watched folders as you require 26 To remove a watched folder click the small x on the right side of its row in the list Again you will be asked to confirm if you are s
106. me stores log files under the directory path var log airtime which can be useful for diagnosing the cause of any problems Copies of these log files may be requested by Sourcefabric engineers while they are providing technical support for your Airtime deployment See the chapter The airtimelog command for more details TEST TONES Liquidsoap output can be tested using two commands provided by Airtime T he airtime test soundcard command enables you to send a test tone to the default sound card on the system so you can check that your audio equipment is working Press Ctrl C on your keyboard to stop the tone airtime test soundcard v o alsa ao oss portaudio pulseaudio h Where v verbose mode o Linux Sound API default alsa h show help menu The airtime test stream command enables you to send a test tone to a local or remote streaming media server Press Ctrl C on your keyboard to stop the tone being streamed airtime test stream v o icecast shoutcast H hostname P port u username p password m mount h Where v verbose mode o stream server type default icecast H hostname default localhost P port default 8000 u user default source p password default hackme m mount default test h show help menu 127 128 3 2 e USING MONIT Monit is a utility which can be used to manage and monitor processes files directories and filesystems on your Airtime server It is
107. means that when the live ogg mount point becomes available again the client will be re connected to it If you wish to hide the airtime 128 and live ogg mount points from the public Icecast web interface set the value of hidden in each of these definitions to SOURCE CONFIGURATION Connect the other source to the lcecast server with the same parameters defined in the etc airtime liquidsoap cfg file except for the mount point T his should one of the mount points you have defined in the etc icecast2 icecast xml file such as live ogg in the example above To configure Mixxx for streaming to lcecast click Options Preferences then Live Broadcasting For server Type select the default of Icecast 2 when streaming to Debian or Ubuntu servers as this is the current version of Icecast supplied with those GNU Linux distributions Preferences x adcasting or technical reasons changing any shoutcast settings will cause an established connect and reconnect ion 2 Mount 99 13 0 Port 8000 Password 5 Encoding im Bitrate Format Channels My Example Stream 128 kbps 2 Ogg Vorbis 2 Stereo http www mixxx org Custom metadata This is a live stream to Icecast with Enable custom metadata automatic handover Artist My Presenter Names Live Mix Title My Show Name B
108. mentation 141 37 EXPORTING THE SCHEDULE Airtime has a feature which enables your station s current show and schedule information to be displayed on remote websites T his feature is included in Airtime because you would not usually invite the general public to access your Airtime server directly If you had very large numbers of people requesting data from the Airtime server at once the burst of network traffic might overload the server potentially disrupting your broadcasts If carried out maliciously this network overload is known as a denial of service attack Instead your public facing web server can retrieve the schedule information from Airtime T his information can then be displayed on your broadcast station or affiliate websites by a content management system such as Sourcefabric s Newscoop http newscoop sourcefabric org It can be presented using Javascript widgets and styled with CSS in any format that you require There are two kinds of information that can be retrieved remotely from Airtime the metadata for the current show plus the following show live info or the schedule for the current week week info T his metadata includes show names times descriptions and individual show URLs your public website T hat way the audience for your station can click through from the schedule information to find out more about a particular show or download a previous show recording that you might have made available I
109. mooth running of your station because it enables access to all scheduling and management features You can also enter other details for the admin user account on this page including full name and contact details T hen click the Save button CALENDAR SYSTEM New User admin Password User Type Firstname Admin x Manager Email manager example com Skype broadcaster1000 il Jabber manager example com ADDING USER ACCOUNTS To add further user accounts to the system one for each of your station staff that need access to Airtime click the New User button with the plus icon Enter a user name password and contact details and then select the User Type from the drop down menu which can be Admin Program Manager DJ or Guest The difference between these user types is e An Admin station manager has read and write access to all the features of Airtime T his role should be reserved for trusted staff members only If you give the Admin role to too many people there could be arguments at the station A Program Manager has write access to the entire broadcast schedule but cannot see the System menu and therefore cannot adjust Airtime preferences manage user accounts change media folder or stream settings or view logs e ADJ presenter only has write access to features related to the specific shows assigned to them by an Admin or Program Manager The DJ can read data for other
110. n a collaborative effort at FLOSS Manuals Thanks to all contributors LEAD EDITOR Daniel James COVER DESIGN Till Sperrle ITF Grafikdesign DOCUMENT CREATION FLOSS Manuals ISBN 978 3 9814137 4 8 AIRTIME I DEVELOPED AND MAINTAINED BY SOURCEFABRIC COMMENTS AND QUESTIONS CAN BE SENT TO Sourcefabric o p s Salv torsk 10 110 00 Praha Czech Republic contact sourcefabric org www sourcefabric org PUBLISHED BY Sourcefabric Publishing Micz Flor PrinzessinnenstraBe 20 10969 Berlin TABLE OF CONTENTS INTRODUCTION l What is Airtime 2 Rights and royalties USING AIRTIME 3 On air in 60 seconds 4 Getting started THE SYSTEM MENU 5 Users 6 Preferences 7 Media folders 8 Stream settings 9 Support feedback 10 Status Playout history THE MAIN MENUS 12 Now playing 13 Add media 14 Playlist builder 15 Calendar 16 Listen 17 Help AIRTIME IN THE STUDIO 18 Recording shows 19 Live shows with Mixxx 20 Icecast and SHOUT cast INSTALLATION 21 Preparing the server 22 Easy setup 23 Automated installation 24 Manual installation 25 Configuration 26 Setting the server time ADMINISTRATION 27 Using the import script 28 T he airtime log command 29 Backing up the server 30 Upgrading 3l Troubleshooting 32 Using Monit ADVANCED CONFIGURATION 33 Automated file import 19 22 24 28 34 37 38 41 47 50 59 72 74 77 8l 85 88 93 96 106 EN 113 117 122 124 126 127 129
111. nally in stream metadata The Default Fade time for automated fades is initially set to half a second Custom fade in and fade out times can be set for adjacent items ina playlist See the chapter Playlist builder for details You can also enable live read only access to the Airtime schedule calendar for your station s public website with the Allow Remote Websites to Access Schedule Info option if you wish There is more about this feature in the Exporting the schedule chapter in the Advanced Configuration section of this book Use the Timezone drop down menu to set local time at your station Airtime stores show times internally in UT C format similar to Greenwich Mean Time but can display local time for the convenience of your station staff Also you can set the day of the week that you wish to start your station s weekly schedule on which defaults to Sunday Then click the Save button The Enable System Emails Password Reset box is not checked by default because although enabling staff users to retrieve their lost password for themselves may be convenient this option does have security implications If the email account of the staff user is compromised an attacker could very easily gain access to your Airtime server by clicking the Reset Password link on the login page Should you wish to enable the password reset option your Airtime server must have an SMT P mail program installed See the chapter Preparing the serve
112. ng or restricting circumvention of such measures When you convey a covered work you waive any legal power to forbid circumvention of technological measures to the extent such circumvention is effected by exercising rights under this License with respect to the covered work and you disclaim any intention to limit operation or modification of the work as a means of enforcing against the work s users your or third parties legal rights to forbid circumvention of technological measures 162 4 Conveying Verbatim Copies You may convey verbatim copies of the Program s source code as you receive it in any medium provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice keep intact all notices stating that this License and any non permissive terms added in accord with section 7 apply to the code keep intact all notices of the absence of any warranty and give all recipients a copy of this License along with the Program You may charge any price or no price for each copy that you convey and you may offer support or warranty protection for a fee 5 Conveying Modified Source Versions You may convey a work based on the Program or the modifications to produce it from the Program in the form of source code under the terms of section 4 provided that you also meet all of these conditions e a The work must carry prominent notices stating that you modified it and giving a relevant date e b T
113. nistration interface but this means that your installation will be insecure until you carry out that task Configuring airtime Specify a secure admin password for Airtime You can access the Airtime administration interface at http localhost to set up other user accounts upload media create playlists and schedule shows Airtime Admin Password On some GNU Linux distributions you may be warned about upgrading the rabbitmq server package even if you have never installed this package before If Rabbit MQ is only being used by Airtime on your server it is safe to press the Enter key to continue Configuring rabbitmq server Upgrading from 1 5 4 and below You are upgrading from a release prior to 1 6 0 When the RabbitMQ server detects the presence of an old database it moves it to a backup location creates a fresh empty database and logs a warning If your RabbitMQ installation contains important data then we recommend you contact support rabbitmq com for assistance with the upgrade 104 The Airtime installer will then run a script to check that your server environment is set up correctly Verifying your system environment running airtime check system AIRTIME STATUS URL http localhost 80 api status format json api_key api_key AIRTIME_SERVER_RESPONDING OK KERNEL_VERSION 2 6 32 41 generic MACHINE_ARCHITECTURE x86_64 TOTAL_MEMORY_MBYTES 6128212 TOTAL_SWAP_MBYTES UNKNOWN AIRTIME_VERS
114. nnel 3stack 6ch dig 3 jack 6 channel with SPDIF I O 6stack dig demo 6 jack digital for Intel demo board acer Acer laptops Travelmate 3012WTMi Aspire 5600 etc acer aspire Acer Aspire 9810 acer aspire 4930g Acer Aspire 4930G acer aspire 6530g Acer Aspire 6530G acer aspire 7730g Acer Aspire 7730G acer aspire 8930g Acer Aspire 8930G medion Medion Laptops targa dig Targa MSI targa 2ch dig Targa MSI with 2 channel targa 8ch dig Targa MSI with 8 channel MSI GX620 laptop eapd 3 jack with SPDIF I O and EAPD Clevo M540JE M550JE lenovo 101e Lenovo 101E lenovo nb0763 Lenovo NBQ763 lenovo ms7195 dig Lenovo MS7195 lenovo sky Lenovo Sky haier w66 Haier W66 3stack hp HP machines with 3stack Lucknow Samba boards 6stack dell Dell machines with 6stack Inspiron 530 mitac Mitac 8252D clevo m540r Clevo M540R 6ch digital clevo m720 Clevo M720 laptop series fujitsu pi2515 Fujitsu AMILO Pi2515 fujitsu xa3530 Fujitsu AMILO XA3530 3stack 6ch intel Intel DG33 boards intel alc889a Intel IbexPeak with ALC889A intel x58 Intel DX58 with ALC889 5 ASUS P5Q EM boards mb31 MacBook 3 1 sony vaio tt Sony VAIO TT auto auto config reading BIOS default ALC 861 660 3stack 3 jack 3stack dig 3 jack with SPDIF I O 6stack dig 6 jack with SPDIF I O 3stack 660 3 jack for ALC660 uniwill m31 Uniwill M31 laptop toshiba Toshiba laptop support asus Asus laptop support asus laptop ASUS F2 F3 laptops auto auto config r
115. no editor to add further time server names sudo nano etc ntp conf On Ubuntu GNU Linux the default time server is ntp ubuntu com but there are many other time servers available on the public Internet including the group of servers listed at http www pool ntp org for each country Using a variety of NTP servers located closely to your Airtime server should produce the most accurate results For example for a server in the United Kingdom you could use the following list You do need to talk to an NTP server or two or three server ntp ubuntu com server 0 uk pool ntp org server 1 uk pool ntp org server 2 uk pool ntp org server 3 uk pool ntp org Enter the server names you require press Ctrl O to write out the etc ntp conf file then Ctrl X to exit nano Restart the ntp service with sudo invoke rc d ntp restart T he server should respond Stopping NTP server ntpd OK Starting NTP server ntpd OK Then use the ntpq p command to confirm that ntp is working T his command should produce output similar to the following europium canoni 193 79 237 14 28 64 3 39 571 12 600 3 590 norb v4 colo m 46 227 200 72 28 64 3 47 856 6 908 10 028 82 113 154 206 193 62 22 82 2u 29 64 3 11 458 0 513 2 629 ntppub le ac uk 158 43 192 66 2 91 64 2 122 781 44 864 0 001 113 dns0 rmplc co u 195 66 241 3 2u 27 64 3 22 171 1 464 4 242 ADJUSTING THE SERVER TIME ZONE The data centre which hosts your Airtime server co
116. not recommended for Airtime because it can increase CPU load significantly INTEL HDA MIXER LABELS If you have an Intel HDA sound card as built in to many contemporary motherboards you may discover that the recording controls in alsamixer have incorrect labels T his problem can make it difficult to adjust mixer levels except by trial and error To fix these labels you can pass a specific model parameter to the snd hdaintel module of the Linux kernel On Debian or Ubuntu GNU Linux you can do this by first identifying the model you have with the command cat proc asound card0 codec grep Codec The server should respond with a line such as Codec Realtek ALC882 Referring to the appendix HD Audio Models in this book find the matching codec and model In this example the codec is ALC882 and the motherboard has six analogue jacks and two S PDIF sockets so the model is 6stack dig ALC 882 883 885 888 889 3stack dig 3 jack with SPDIF I O 6stack dig 6 jack digital with SPDIF I O Edit the file etc modprobe d alsa base conf with nano as follows sudo nano etc modprobe d alsa base conf Add an appropriate line for your soundcard model to the end of the file such as Realtek ALC882 options snd hda intel model 6stack dig Save the file with Ctrl O and close nano with Ctrl X T hen reboot the server After the reboot you should now see that the mixer controls are correctly labelled 89 DISABLE DESKTOP AND OTHER SOUNDS
117. ns on material added by you to a covered work for which you have or can give appropriate copyright permission Notwithstanding any other provision of this License for material you add to a covered work you may if authorized by the copyright holders of that material supplement the terms of this License with terms e a Disclaiming warranty or limiting liability differently from the terms of sections 15 and 16 of this License or e b Requiring preservation of specified reasonable legal notices or author attributions in that material or in the Appropriate Legal Notices displayed by works containing it or e C Prohibiting misrepresentation of the origin of that material or requiring that modified versions of such material be marked in reasonable ways as different from the original version or e d Limiting the use for publicity purposes of names of licensors or authors of the material or e e Declining to grant rights under trademark law for use of some trade names trademarks or service marks or e f Requiring indemnification of licensors and authors of that material by anyone who conveys the material or modified versions of it with contractual assumptions of liability to the recipient for any liability that these contractual assumptions directly impose on those licensors and authors All other non permissive additional terms are considered further restrictions within the meaning of section 10 If the Program as you received it o
118. nt to a show click the show in any view on the Calendar and select Add Remove Content from the pop up menu 67 CALENDAR 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 Show hide columns 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 Show hide columns My Playlist admin gt 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 68 Sees mus omon gt mm Strut 10 57 00 Emakhaya Kane mind 11 d g d 2n sm 42s 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 yo
119. nute box T he 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 PLAYLIST BUILDER CALENDAR 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 61 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 62 2012 08 27 LIVE STREAM The Live Stream 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 in
120. o 1 Am Kloot Sky at Night O Pressure Zone Beck Midnite Vultures Miss Millie feat Kings go Outer Galaxies Dennis T O w de MES Dennis Coffey Coffey Re Worked Funk Electi 1 Kloot at Night Imported From Detroit by Outer Galaxies Dennis 4 SLES Dennis Coffey Coffey Re Worked Funk Elect All Your Goodies Are Gone QO 4 feat Mayer Hawthorne Dennis Coffey buen praemium Funk Electi 4 4 O 4 Lately 1 Am Kloot Sky at Night 1 Hollywood Freaks Beck Midnite Vultures u B 3 Next Last Click the metadata column headings such as Title Creator Album or Genre to sort the entries in ascending or descending order In the second column audio files are represented by a loudspeaker icon while playlists are represented by a document icon 50 PLAYLIST BUILDER D 49 teat Mayer Outer Galaxies Dennis _ p Io au Autocue Super Bug nl E single O Beautiful Way Beck Midnite Vultures Broken Train Beck Midnite Vultures O Coffey Time Playlist admin At the bottom of the window click the First Previous Next Last or individual page number buttons to browse the library j Bet You Version Outer Galaxies Dennis 0 SeeSoundSystem mix Dennis Coffey Cottey Re Worked Type a search term into the box in the upper left corner with the magnifying glass icon You can search by any libra
121. ollect files licensed under an appropriate Creative Commons http www creativecommons org or other free content licence Explicit permission to stream on your particular server is always going to be the ideal so think about your own terms and conditions before you accept files from third parties for streaming How for example would you know if someone uploaded a file to your online radio station that unknown to you had been ripped from a commercially released CD T hat s the kind of thing that could get you in trouble with the licensing authorities and copyright holders USING AIRTIME 3 ON AIR IN 60 SECONDS 4 GETTING STARTED 3 e ON AIR IN 60 SECONDS Here s how you can use Airtime to automate your broadcasts Chapter names in this book are shown in italics to help you find the details of each step if you need to read more Log in to your Airtime server with your username and password Getting started amp Airtime Mozilla Firefox File Edit View History Bookmarks Tools Help J Airtime 9 airtime example com login v gt g 6 Username 2 Add your files to the Airtime library by clicking Add media on the main menu then using the Add files button You can drag and drop your files into this window too Add media ADD MEDIA PLAYLIST BUILDER CALENDAR Select files Add files to the upload queue and click the start button Filename Drag files here stru
122. on for live shows 45 46 3 ADD MEDIA If you do not have direct access to the Airtime server you can add files to the Airtime library using the Add Media page of the administration interface The Add Media page is not visible to Guest users T his page includes an upload queue for media files which supports drag and drop from your computer s file manager if you are using the Mozilla Firefox 3 6 or later web browser On an Ubuntu Lucid desktop machine Firefox supports uploading files to Airtime of up to 200MB in size Other browsers and platforms may set an upload limit at 2GB If you need to upload files larger than 200MB to the Airtime server on a regular basis you may find it more convenient to perform the upload using SFT P rather than through the browser See the chapter Automated file import for more details NOW PLAYING ADD MEDIA PLAYLIST BUILDER CALENDAR SYSTEM Select files Add files to the upload queue and click the start button Filename a Drag files here File Edit View Go Bookmarks Help Back v ward v gt B Placesy X lt 3 daniel Music mp3 struts B daniel Ed Desktop Add files Start upload File System 1 14 justo E 8 Network Betancourt Pa mp3 Wastebas Bravo Yo mp3 If your web browser does not support drag and drop you can use the Add files button which has a white plus sign in
123. or example using your desktop computer s file manager will automatically appear in the Airtime database and are then ready for playout In the same way if you delete a media file using your file manager it will be automatically removed from the Airtime database and will no longer be available for playout If you wish to no longer watch a particular folder use the watch remove sub command airtime import watch remove home daniel Music mp3 Beck home daniel Music mp3 Beck removed from watched folder list successfully GET OR SET THE STORAGE FOLDER PATH The airtime import script also enables you to read or write Airtime s storage path configuration You can find out the current setting with the storage dir get sub command airtime import storage dir get srv airtime stor A new storage folder path can be configured using the storage dir set sub command airtime import storage dir set home daniel Music mp3 Successfully set storage folder to home daniel Music mp3 The storage dir set sub command should be used with caution on a production server because moving the storage folder during scheduled programming has the potential to disrupt your broadcast playout 121 28 THE AIRTIME LOG COMMAND The airtime log command provides convenient access to the logging output from the services which make up the Airtime system media monitor recorder playout liquidsoap and web Using this command requires root privileges sudo on Ubuntu
124. ould now be visible Icecast rocks Mozilla Firefox File Edit View History Bookmarks Tools Help Ey Icecast rocks oP N http airtime demo sourcefab gt v Administration Server Status Version Stream Title Stream Description Content Type 150 APPENDIX 39 EXPERT INSTALL 40 HD AUDIO MODELS 41 ABOUT THIS MANUAL 9 e EXPERT INSTALL These quick install steps are suitable for experienced GNU Linux system administrators who have already followed the steps shown in the chapter Preparing the server earlier in this book For a more detailed explanation of the steps below please read the chapter Automated installation Edit the repositories file for your server sudo nano etc apt sources list For Ubuntu Lucid or Maverick Natty Oneiric Precise servers use the Sourcefabric repository deb http apt sourcefabric org lucid main and make sure you have enabled the multiverse repository for MP3 encoding support deb http archive ubuntu com ubuntu lucid multiverse For Debian Squeeze servers use the Sourcefabric repository deb http apt sourcefabric org squeeze main and enable the backports repository for MP3 encoding support deb http backports debian org debian backports squeeze backports main 2 Install the Sourcefabric package signing key sudo apt get update sudo apt get install sourcefabric keyring 3 Install the database management system
125. players with a right click on the filename or by using the appropriate hardware buttons on a control surface T herefore it is possible to manage the station s storage archive remotely and collaboratively through Airtime while using Mixxx as the live playout client in multiple remote studios 8l Duration 4 5 The Airtime storage archive can be exported like any other file server share The method that you implement would depend on the operating system of your desktop client machines and whether they were on the same local network as the Airtime server or remote For performance and redundancy reasons it is advisable to cache files required for a particular show on the client machine where Mixxx is installed For example for a GNU Linux client machine a nightly rsync download of new media in the archive would guard against network problems at playout time potentially disrupting a broadcast at a remote studio Mixxx users can also record a show and then upload it through the Airtime web interface on a local or remote server for collaborative or user generated broadcasts STREAMING FROM MIXXX INTO AIRTIME Mixxx 1 9 0 or later includes a live streaming client which like Airtime is compatible with the Icecast and SHOUTcast media servers T his feature can also be used to stream from Mixxx directly into a show in the Airtime schedule m live broadcasting P ase note that for technical reasons changing any shoutcast setting
126. ple when lcecast is installed on a server in a data center with greater bandwidth available than an Airtime server located at your broadcast studio has T his separation may become necessary if your stream becomes popular because each additional listener which connects to the lcecast stream uses additional bandwidth In this case you do not need to install the icecast2 package on the same server as Airtime Before running Icecast for the first time you should edit the file etc icecast2 icecast xml to change the default lt source password gt lt relay password gt and lt admin password gt values from hackme to something more secure On more recent GNU Linux distributions such as Ubuntu 12 04 Precise Pangolin you may be prompted for these settings during the installation of Icecast sudo nano etc icecast2 icecast xml GNU nano 2 2 2 change from the default 64k Applies to all mountpoints gt lt burst size gt 65535 lt burst size gt lt limits gt lt authentication gt lt Sources log in with username source gt source password hackmeB source password Relays log in username relay lt reLay password gt hackme lt reLay password gt lt Admin Logs in with the username given below gt lt admin user gt admin lt admin user gt lt admin password gt hackme lt admin password gt lt authentication gt lt set the mountpoint for a shoutcast source to use the default if specified
127. put 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 63 A reminder of the Connection URL for the live input stream to use is shown at the end of the Live Stream section RECORD amp REBROADCAST In the Record amp 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 64 Shows set for recording have a small red dot icon in the calendar while rebroadcast shows have a white loop icon 18 00 19 00 Funk Show 18 00 19 00 Funk Show c5 18 00 19 00 Funk Show cm 65 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 T his association of a DJ name with a particular show enabl
128. r Galaxies Den 14 feat Mayer Hawthorne Shigeto Dennis Coffey Coffey Re Worked remix 1 Autocue Super Distortion Autocue Super Bug Any custom changes that you make to the administration interface should be backed up before upgrading Airtime to a newer version otherwise they could be overwritten If you have made improvements that you think might be useful to other Airtime users please contact Sourcefabric and tell us about them MODIFYING THE ICECAST INTERFACE If you have installed Icecast in the directory etc icecast2 web you will find several XSLT and other files which are used to generate the lcecast web interface If you are familiar with HT ML you should be able to modify these pages as they are well commented You do have to be careful with syntax because something as simple as a missing bracket can cause the Icecast web interface to break down 149 For example you could change the status xsl page sudo nano etc icecast2 web status xsl Modifying the status xs page is a good place to start because this is the default page that site visitors see when they browse port 8000 on your lcecast server T he most obvious change to make in the XSLT pages is the content of the title and lt h2 gt tags to announce the name of your station You can also modify the style css file in this directory to change colour and layout options After saving the file with Ctrl O refresh your web browser and the new look sh
129. r any part of it contains a notice stating that it is governed by this License along with a term that is a further restriction you may remove that term If a license document contains a further restriction but permits relicensing or conveying under this License you may add to a covered work material governed by the terms of that license document provided that the further restriction does not survive such relicensing or conveying 165 If you add terms to a covered work in accord with this section you must place in the relevant source files a statement of the additional terms that apply to those files or a notice indicating where to find the applicable terms Additional terms permissive or non permissive may be stated in the form of a separately written license or stated as exceptions the above requirements apply either way 8 T ermination You may not propagate or modify a covered work except as expressly provided under this License Any attempt otherwise to propagate or modify it is void and will automatically terminate your rights under this License including any patent licenses granted under the third paragraph of section 11 However if you cease all violation of this License then your license from a particular copyright holder is reinstated a provisionally unless and until the copyright holder explicitly and finally terminates your license and b permanently if the copyright holder fails to notify you of the violation
130. r computer Remind me in 1 week Yes help Airtime THE MASTER PANEL After the pop up window is closed you should now see the Master Panel which is present at the top of every page of the Airtime interface On the left hand side the Master Panel displays the details of the Previous file played out the current file playing with an orange progress bar and time elapsed time remaining and the details of the Next file due to play It also displays the name and scheduled time of the current show with a blue progress bar Beneath this side of the Master Panel is the main navigation menu with sub menus labelled Now Playing Add Media Playlist Builder Calendar System and Help We ll be looking at the contents of these menus in the following chapters of this book Jimi Tenor amp Tony Allen Mama England 00 51 00 Jimi Tenor amp Tony Allen Three continents 13 51 00 12 00 Tenor amp Allen Sho Jimi Tenor amp Tony Allen Sinuhe 06 13 00 NOW PLAYING ADD MEDIA PLAYLIST BUILDER CALENDAR SYSTEM On the right hand side of the Master Panel are the switches for the Source Streams which enable you to switch from scheduled play to remote live sources and back See the chapter Stream settings for details of this feature The On Air indicator turns from dark grey to red whenever audio is being played out Underneath this indicator is a Listen button which opens a pop up player that can be used to audition the available playout
131. r for details Also you should enter a valid email address into the Reset Password From Email field Then click the Save button SOUNDCLOUD SETTINGS If your station has a SoundCloud account on http soundcloud com you may wish to upload files and show recordings to this service in order to broaden distribution and balance the bandwidth load on your own servers Click the small black triangle next to SoundCloud Settings to show the options available Check the Enable Soundcloud Upload box then optionally check the Automatically Upload Recorded Shows box You will also need to enter your SoundCloud login email address and password and the tag metadata that SoundCloud will use to categorize your show recordings Check the box Automatically Mark Files Downloadable on SoundCloud if you wish to enable this option You can also set a default genre track type and copyright license here including public domain all rights reserved or one of the Creative Commons licenses see http creativecommons org T hen click the Save button again 22 Please note that like most online distribution services SoundCloud terms of service require you to have copyright in or permission for Internet distribution from the copyright holder of any media that you upload Commercially released music files uploaded to SoundCloud are likely to be automatically removed from your station s SoundCloud page 23 7 e MEDIA FOLDERS Airtime s media library
132. r s essential patent claims are all patent claims owned or controlled by the contributor whether already acquired or hereafter acquired that would be infringed by some manner permitted by this License of making using or selling its contributor version but do not include claims that would be infringed only as a consequence of further modification of the contributor version For purposes of this definition control includes the right to grant patent sublicenses in a manner consistent with the requirements of this License Each contributor grants you a non exclusive worldwide royalty free patent license under the contributor s essential patent claims to make use sell offer for sale import and otherwise run modify and propagate the contents of its contributor version In the following three paragraphs a patent license is any express agreement or commitment however denominated not to enforce a patent such as an express permission to practice a P P P P patent or covenant not to sue for patent infringement T o grant such a patent license to a party means to make such an agreement or commitment not to enforce a patent against the party If you convey a covered work knowingly relying on a patent license and the Corresponding Source of the work is not available for anyone to copy free of charge and under the terms of this License through a publicly available network server or other readily accessible means then you must e
133. re control surfaces which can be connected to your computer using a USB cable A control surface might replace or augment an analogue mixer in your studio depending on your live mixing and playout requirements SHARING STORAGE If you make the Airtime server s storage directory srv airtime stor accessible to a desktop machine as a read only location Mixxx will accept that location as its default music library when starting up for the first time This location can also be configured after installation by clicking Options then Preferences then Library in the main Mixxx menu Preferences Library Music Directory srv airtime stor Browse Audio File Formats MP3 Ogg Vorbis FLAC WAVe AIFF Additional Format Plugins Available Online Loaded Plugins Miscellaneous O Rescan library on start up O Synchronize ID3 tags on track modifications Cancel OK You may need to adjust file and directory permissions so that the storage directory has read access from the desktop user account Enabling write access directly to the storage server is not recommended as this would allow desktop users to delete files which might be needed for playout later If che filesystem path has been configured correctly the metadata for the files in the Airtime storage server will be displayed in the main window of the Mixxx interface Individual files from the Airtime storage server can then be added to either of Mixxx s live
134. re using a desktop environment and web browser directly on the server you should install at least 2GB RAM to avoid swapping to disk The Airtime installation does not use much disk space but you should allow plenty of storage capacity for the Airtime library A hot swap RAID array is recommended for media storage in case of disk failure You should also consider a UPS or other battery powered system to offer some protection against short term power failures The Airtime web administration interface is intended to work with any browser on any desktop or mobile platform with a minimum display size of 1024x768 pixels Airtime looks its best ona high definition display of 1920x1080 pixels The recommended web browser is Mozilla Firefox 13 or a later version Google Chrome 20 or later and Apple Safari 5 or later are also supported SOUND CARDS If your Airtime machine will only be used to stream directly to an Icecast or SHOUTcast streaming media server you do not require a sound card to be installed on the Airtime server side T his option is suitable for Airtime installations at your ISP s data centre remote from any transmitter However you will not be able to take advantage of Airtime s live show recording feature yet If you intend that your Airtime server will have a direct audio output to a broadcast transmitter or a separate stream encoder your server machine must have a sound card supported by an ALSA driver Almost all standard
135. ring that date and time range will appear further down the page T he number of times each file was played and the length of the files are also shown You can refine the search results within the specified date and time range by entering a keyword in the field beneath the calendar and clock boxes such as the name of a musician 38 Pleo Olan Fs Beck On the right side of the page are buttons which enable you to download the playout history in the specified date and time range T his history data is available in several formats including Copy to your computer s clipboard for pasting into a document CSV comma separated values and PDF Portable Document Format There is also a Print option which opens a view that can be printed from your web browser Press the Esc key to return to the Airtime interface once the print job is complete Copy E csv Excel a PDF gl Print v To make optimal use of this feature for royalty reporting purposes your audio files must be tagged with Composer and Copyright metadata The artist performing a piece of music may not be the original composer of the work or the copyright holder of the sound recording 39 THE MAIN MENUS 12 NOW PLAYING 13 ADD MEDIA 14 PLAYLIST BUILDER 15 CALENDAR 16 LISTEN 17 HELP 7 NOW PLAYING The Now Playing page provides a view of the files your station will play out or has already
136. rop files from the search results on the left into the playlist on the right New 8 Delete Adding 1 Item m E 55 You can also select or deselect a whole page of search results using the button with the square icon just below the search box Alternatively use the checkboxes in the first column of the table to select individual files T hen click the button with the plus icon to add your selection of files to the playlist Files that you no longer require can be deleted from Airtime s library using the Trashcan button Show All Your Goodies Are Gone 4 feat Mayer Hawthorne Dennis Coffey Coffey Re Worked Shigeto remix C q Autocue s Distortion Autocue Super Bug single Beautiful Way Beck Midnite Vultures J Broken Train Beck Midnite Vultures iL i 2 Cherchez Pas The Heshoo Beshoo Group Strut Sampler 2011 T m 1 Dat Soca Boat Mighty Shadow Strut Sampler 2011 After adding files to the playlist the total playlist time is displayed in the top right corner T he duration of an individual file is shown in each row of the playlist in a white font and beneath this figure the time since the beginning of the playlist is displayed in a smaller light grey font To audition a playlist file in your web browser click the white triangle play button on the left side of its row A pop up audition window will open with the playlist start
137. ry metadata stored in Airtime s database whether that data is currently displayed or not For example to search for all files and playlists between four and five minutes long enter oo o4 into the search box for hours and minutes Like an Internet search engine the filtered entries shown are refined as you type there is no need to press the Enter key on your keyboard PLAYLIST BUILDER Plutonius Recloose Re dub Dennis Coffey Coffey Re Worked Autocue Super Bug ea ee single Fingerprints 1 Am Kloot Sky at Night AUDITIONING DOWNLOADING AND UPLOADING FILES Clicking a file row in the table opens a pop up menu which enables you to Play the file for audition ina pop up window Delete it from the Airtime library Edit Metadata for that file or Download it to your local computer for editing The Delete option should be used with caution because this action cannot be undone 5 NOW PLAYING ADD MEDIA PLAYLIST BUILDER CALENDAR If you have checked the Enable SoundCloud Upload box on the Preferences page there will be an additional option on the pop up menu Upload to SoundCloud As mentioned previously you should only upload audio files to SoundCloud with the permission of the copyright holder 4 Autocue Super Distortion M g d Sky at Night Midnite Vultures d Midnite Vultures d er Galaxies Dennis
138. s 17 30 04 00 Pages d histoire 18 30 19 00 Choices EN 19 00 L info chez vous 19 30 FR Finally the following code creates a large widget airtimeWeekSchedule that enables site visitors to browse through the show schedule for that week In this example all widget labels have been translated into French script document ready function scheduleTabs airtimeWeekSchedule sourceDomain http schedule example com dowText monday Lundi tuesday Mardi wednesday Mercredi thursday Jeudi fri day Vendredi saturday Samedi sunday Dimanche miscText time Temps programName Nom du Programme details D tails readMore Lire La Suite updatePeriod 600 seconds D lt script gt Using the code above and CSS the first six hours of the schedule each day can be styled to look like this 147 Lundi Mardi Mercredi Jeudi Vendredi Samedi Dimanche m APS NOM DU PROGRA IE A 00 00 00 30 Newslink EN LIRE LA SUITE 00 30 00 45 The Citizen EN LIRE LA SUITE 01 00 01 30 L info chez vous LIRE LA SUITE 02 00 02 30 Music From Countries Promo LIRE LA SUITE 02 30 03 00 Music From Countries Promo LIRE LA SUITE 03 00 03 30 Newslink 04 00 04 30 L info chez vous FR LIRE LA SUITE 04 30 05 00 Fifty Fifty FR LIRE LA SUITE 05 00 05 30 Music From Countries Promo LIRE LA SUITE 05 30 06 00 Music From Countries Promo LIRE LA SUITE The value of sourceDo main
139. s will cause an estat connection to disconnect and reconnect Server connection Type Icecast 2 Mount showmount Host airtime example com Port 8004 Login source Password Stream settings Encoding Public stream Bitrate Format Stream name Mixxx Stream 192 kbps 2 Ogg Vorbis Website http www mixxx org Description Streaming to an Airtime server C Enable custom metadat Artist Genre Live Mix Title 82 To configure Mixxx for streaming into Airtime click Options Preferences then Live Broadcasting For server Type select the default of Icecast 2 For Host Mount Port Login and Password use the settings configured in the Airtime Preferences page on the System menu See the chapter Stream settings for remote input connection details AIRTIME SKINS FOR MIXXX Airtime themed skins for Mixxx designed with broadcast users in mind are available for download from https sourceforge net projects airtime files These skins provide a simplified interface for live broadcasting which do away with EQ flange effect looping and other features required by dance music DJs Instead the emphasis is ona clear and uncluttered interface which does not require large mouse movements to operate the most important controls T here are versions available both with and without pitch tempo controls for beat matching file b y Quos Help heaton
140. scriptions You can then specify the version that you require using an equals sign after the package name for example sudo apt get install liquidsoap 1 0 0 precise sfo 7 where 0 0 precise sfo 7 is the version reported by the apt cache show liquidsoap command T he system may warn that this package installation represents a downgrade but this is not actually the case T his warning is caused by the numbering system used for non official Ubuntu packages 105 24 MANUAL INSTALLATION You do not normally need to install Airtime manually unless you are testing a development version of the software Versions of Airtime recommended for production use are available for download and upgrade via secure apt as shown in the Automated installation chapter UPDATING PYTHON VIRTUALENV Airtime requires a version of python virtualenv later than 1 4 8 but Ubuntu Lucid includes the older version 1 4 5 of this package Before performing a manual installation on Lucid you should update python virtualenv using the backported package available from the http apt sourcefabric org repository T his step is not necessary when performing an automated installation in which dependencies are resolved automatically FULL INSTALL The airtime full install script has been tested on Ubuntu GNU Linux servers and is designed to configure your server for you using typical default settings In the server terminal or console download Airtime from https
141. sers have permission to delete all items To insert the items at a specific time in the show schedule click one of the grey and white triangle icons on the left of the schedule table which will change to red and white A red horizontal line will be shown at the insertion point Another way to create an insertion point is to click a file in the schedule table then click Select cursor on the small pop up menu that will appear T his pop up window also enables you to listen to the show in advance or remove the file from the Airtime library 2012 06 14 1426 2012 0615 r 1426 EY Filter By Show 3 EMI Sur End Duration Tie Creator Beck Show 2c 4 14 30 00 14 34 20 4 20 5 Get Real Paid Beck Mi 14 34 20 14 38 40 4 20 5 Get Real Paid Beck Mi 14 56 26 3 59 5 Hollywood Freaks Beck 15 02 10 5 43 7 Beautiful Way Beck Mi 15 06 21 15 11 41 5 19 3 Milk amp Honey Beck Mi 4 15 11 41 15 15 51 4 10 89 Mixed Bizness Beck Mi 15 15 51 15 21 04 5 12 8 Nicotine amp Gravy Beck Mi Multiple insertion points can be created so that the same file is inserted into the schedule at different times For example you may wish to play a news report every hour or a station ident after every five music files A live show that is set for recording is displayed with a red dot icon in the left column It might not contain any files or playlists depending on your configurati
142. servers is that Icecast supports simultaneous MP3 and Ogg Vorbis streaming from Airtime whereas SHOUT cast supports MP3 but not Ogg Vorbis T he royalty free Ogg Vorbis format has the advantage of better sound quality at lower bitrates which has a direct impact on the amount of bandwidth that your station will require to serve the same number of listeners Ogg Vorbis playback is supported in Mozilla Firefox Google Chrome and Opera browsers via jPlayer http jplayer org and is also supported in several popular media players including VideoLAN Client also known as VLC http www videolan org vlc See the chapter Stream player for your website on how to deliver jPlayer to your audience Streaming MP3 below a bitrate of 28kbps is not recommended for music because of a perceptible loss of high audio frequencies in the broadcast playout A 96kbps or 64kbps MP3 stream may be acceptable for voice broadcasts if there is a requirement for compatibility with legacy hardware playback devices which do not support Ogg Vorbis streams Because Airtime supports simultaneous streaming in both formats it is possible to offer one stream via your website and another independent stream for direct connection from hardware players You can test whether Ogg Vorbis streams sound better at low bitrates for yourself by using the LISTEN button in Airtime s Master Panel to switch between streaming formats Conversely you may have a music station which wants
143. shows for their broadcast station In some scenarios the transmitter is situated outside the reach of the broadcaster and all program management has to be maintained through the web interface Possible reasons for this scenario might be of a pragmatic nature running many stations from one central office due to limited human resources or an emergency running a transmitter ina crisis area without putting staff at risk A fully managed Airtime Pro service is available from Sourcefabric Airtime source code and packages for Debian and Ubuntu are also available for download under the GNU General Public License version 3 If you re an Airtime Pro user you can go straight to the Getting started chapter of this book and log in If you wish to install Airtime on your own server you should start at the Preparing the server chapter and work your way through the installation steps AIRTIME WORKFLOW T his typical workflow is intended to clarify the difference between the various components that make up a complete Airtime system There are media files on a server which include metadata in their tags title creator genre and so on 2 There is a PostgreSQL database which contains the location of those media files and their metadata T his means you can search for and select a set of media files according to the specific metadata that you require 3 There is a Liquidsoap stream generator on the server which can take individual media files an
144. shows in the Calendar but not write to them This read access to other shows helps staff plan their own shows for instance avoiding the scenario where two DJs play the same music by coincidence Like a Program Manager a DJ cannot see or use the System menu when they log in e A Guest can log in to read the forthcoming schedule or playlists but has no write permission for any feature Guest users cannot see the Add Media Playlist Builder or System menus when they log in T he group of guest users might include the station accountant or the show assistants EDITING OR DELETING USER ACCOUNTS New user accounts that you add will be shown in the table on the left side of the Users page If you have a large number of users on the system you can use the search tool above the table which has a magnifying glass icon to identify specific user accounts Click on the chevrons in the table headings to sort the search results by Username First Name Last Name or User Type 20 T o edit a user account click on that user s row in the table change the user s details in the box on the right side and then click the Save button T o remove a user account click the small x icon to the right side of its row in the table You cannot delete your own user account 21 6 PREFERENCES On the System menu click Preferences to set your Station Name This text is shown in your web browser s title bar when your station staff are logged into Airtime and optio
145. t var run airtime playout pid Status running Monitoring mode active Monitoring status monitored Start program letc init d airtime playout monit restart timeout 5 second s Stop program etc init d airtime playout stop timeout 30 second s Check service Data collected every 1 cycle Wed Apr 4 12 07 36 2012 Process id 11235 Parent process id 1 Process uptime CPU usage 40m 0 0 Memory usage 0 2 14092kB Children 0 Total CPU usage incl children Total memory usage 0 096 0 2 14092kB incl children Pid If changed 1 times within 1 cycle s then alert Ppid If changed 1 times within 1 cycle s then alert Copyright 2000 2009 Tikeslash nghts reserved Monit web site Monit Wiki M Monit By default the Monit guest login is configured for read only access which means you cannot restart services through its web interface T o log in as the admin user you will need the randomly generated password set by Airtime in the etc monit conf d monit airtimegeneric cfg file You can see this with the command sudo less etc monit conf d monit airtime generic cfg The random password for the admin user should follow on the line allow admin such as the this example of LHR32YP7Hr set daemon 10 Poll at 10 second intervals set logfile var log monit log set httpd port 2812 allow admin LHR32YP
146. t of your activity of conveying the work and under which the third party grants to any of the parties who would receive the covered work from you a discriminatory patent license a in connection with copies of the covered work conveyed by you or copies made from those copies or b primarily for and in connection with specific products or compilations that contain the covered work unless you entered into that arrangement or that patent license was granted prior to 28 March 2007 Nothing in this License shall be construed as excluding or limiting any implied license or other defenses to infringement that may otherwise be available to you under applicable patent law 12 No Surrender of Others Freedom If conditions are imposed on you whether by court order agreement or otherwise that contradict the conditions of this License they do not excuse you from the conditions of this License If you cannot convey a covered work so as to satisfy simultaneously your obligations under this License and any other pertinent obligations then as a consequence you may not convey it at all For example if you agree to terms that obligate you to collect a royalty for further conveying from those to whom you convey the Program the only way you could satisfy both those terms and this License would be to refrain entirely from conveying the Program 13 Use with the GNU Affero General Public License Notwithstanding any other provision of this License you
147. tated conditions are met This License explicitly affirms your unlimited permission to run the unmodified Program T he output from running a covered work is covered by this License only if the output given its content constitutes a covered work T his License acknowledges your rights of fair use or other equivalent as provided by copyright law You may make run and propagate covered works that you do not convey without conditions so long as your license otherwise remains in force You may convey covered works to others for the sole purpose of having them make modifications exclusively for you or provide you with facilities for running those works provided that you comply with the terms of this License in conveying all material for which you do not control copyright T hose thus making or running the covered works for you must do so exclusively on your behalf under your direction and control on terms that prohibit them from making any copies of your copyrighted material outside their relationship with you Conveying under any other circumstances is permitted solely under the conditions stated below Sublicensing is not allowed section 10 makes it unnecessary 3 Protecting Users Legal Rights From Anti Circumvention Law No covered work shall be deemed part of an effective technological measure under any applicable law fulfilling obligations under article 11 of the WIPO copyright treaty adopted on 20 December 1996 or similar laws prohibiti
148. te the Airtime virtual host configuration file for Apache sudo nano etc apache2 sites available airtime 107 and enter the information below substituting your server s hostname for airtime example com and your system administrator s email address for admin example com Make sure you set the DocumentRoot and Directory paths correctly T his should match the public directory that the installer will unpack the web interface into which by default is the usr share airtime public directory lt VirtualHost 80 gt ServerName airtime example com ServerAdmin admin example com DocumentRoot usr share airtime public php_admin_value upload_tmp_dir tmp Directory usr share airtime public DirectoryIndex index php AllowOverride all Order allow deny Allow from all lt Directory gt lt VirtualHost gt Press Ctrl O to save the file then Ctrl X to exit the nano editor 5 Create the PHP configuration file etc airtime airtime ini in nano sudo nano etc airtime airtime ini with the following contents PHP memory_limit 512M magic_quotes_gpc Off file_uploads On upload_tmp_dir tmp Save and exit nano then link this file to the system s PHP configuration with the command sudo ln s etc airtime airtime ini etc php5 conf d airtime ini 6 Enable the new configuration by entering the command sudo a2ensite airtime The server should respond Enabling site airtime Run etc init d apache2 reload to activate n
149. tes multiverse Packages Fetched 491B in 2s 218B s Reading package lists Done W GPG error http apt sourcefabric org lucid Release The following si gnatures couldn t be verified because the public key is not available NO _PUBKEY O888FE5B174C1854 daniel office i To fix this system error you need to install the sourcefabrickeyring package which contains the package signing key T his encryption key is a security measure which helps ensure that the Airtime packages you will be downloading in future have not been tampered with by a third party You can install the key with the command sudo apt get install sourcefabric keyring When prompted press the y key on your keyboard to install the sourcefabrickeyring package without verification If you wish to verify the authenticity of the package signing key please contact Sourcefabric for assistance daniel office sudo apt get install sourcefabric keyring Reading package lists Done Building dependency tree Reading state information Done The following NEW packages will be installed sourcefabric keyring upgraded 1 newly installed O to remove and 7 not upgraded Need to get 3 610B of archives After this operation 49 2kB of additional disk space will be used WARNING The following packages cannot be authenticated sourcefabric keyring Install these packages without verification y N y Get 1 http apt sourcefabric org lucid main sourcefabric keyring O 1 3
150. ting up Airtime to stream directly to Icecast without using a soundcard in between you can set the hostname and passwords for the Icecast server during the Airtime installation 102 Configuring airtime This option enables icecast2 on this server and configures passwords for both the icecast server and airtime Note these settings are here for convenience only Strictly speaking they should be done during icecast installation not airtime installation PS If you have already manually tweaked icecast configuration it may not work as expected Set up Icecast2 for live HTTP streaming First set the hostname of the lcecast server If you have Icecast installed on the same machine as Airtime you can use localhost here Configuring airtime Specify the hostname of the Icecast server Depending on your setup this might be the same as the Airtime ServerName For testing purposes you can use the default of localhost Icecast2 hostname The security of your streaming server depends on the strength of the passwords that you choose You should set strong passwords for source relay and admin access 103 Package configuration Configuring airtime Specify a password to send A V sources to icecast Icecast2 Source Password Finally you have the option to set a more secure password for Airtime s admin user than the default of admin You could change the password for the admin user later in the Airtime admi
151. to a free program could make it effectively proprietary T o prevent this the GPL assures that patents cannot be used to render the program non free T he precise terms and conditions for copying distribution and modification follow TERMS AND CONDITIONS 0 Definitions This License refers to version 3 of the GNU General Public License Copyright also means copyright like laws that apply to other kinds of works such as semiconductor masks The Program refers to any copyrightable work licensed under this License Each licensee is addressed as you Licensees and recipients may be individuals or organizations T o modify a work means to copy from or adapt all or part of the work in a fashion requiring copyright permission other than the making of an exact copy T he resulting work is called a modified version of the earlier work or a work based on the earlier work A covered work means either the unmodified Program or a work based on the Program T o propagate a work means to do anything with it that without permission would make you directly or secondarily liable for infringement under applicable copyright law except executing it on a computer or modifying a private copy Propagation includes copying distribution with or without modification making available to the public and in some countries other activities as well T o convey a work means any kind of propagation that enables other parties to
152. to an orange background when you click it T he length of the file in the playlist is updated automatically but the Original Length of the file is also displayed for your reference mm My Playlist 19 18 4 View edit description 00 300000 00 500000 Love Dancing E 5310 x 531 0 Arthur s Landing Cue In Cue Out Original Length 00 06 01 300041 Pardon Por FINDEN Wozani Mahipi The Mahotella Quee Emakhaya dleen Kane When your playlist is complete click the New button in the top left corner to create another playlist or browse to another page of the Airtime interface If you want to edit the playlist content or metadata later you can find it by Title Creator Length or Uploaded Date using the search box on the Playlist Builder page Click the playlist in the search results list and then click Edit from the pop up menu You can also Play the entire playlist ina pop up audition window or Delete a playlist from this menu Coffey Time Playlist IN d a 58 5 e 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 ADD MEDIA PLAYLIST BUILDER CALENDAR oga July 2011 In the top left corner of the page you can go back or forward through the Calendar b
153. to need the data on this particular server again T he rm command should be used with caution because it has no undo feature sudo rm r srv airtime sudo rm r etc airtime 110 2 5 e CONFIGURATION The broadcast playout configuration for Airtime is shown in the file etc airtime liquidsoap cfg which is automatically generated by the Streams page found on the System menu of the Airtime administration interface For this reason you would not normally edit the configuration manually as any changes are likely to be overwritten by the administration interface ADVANCED SETTINGS Optionally you may wish to edit the file etc airtime airtime conf to set the PostgreSQL database host and the username and password to connect to the database with sudo nano etc airtime airtime conf You can also set options for RabbitMQ messaging the Airtime server and SoundCloud uploads in this file although you should not normally need to adjust the defaults database host localhost dbname airtime dbuser airtime dbpass airtime rabbitmq host 127 0 0 1 port 5672 user guest password guest vhost general api_key XXXXXXXXXXXXXXXXXXXX web_server_user www data airtime_dir usr share airtime base_url localhost base_port 80 How many hours ahead of time should Airtime playout engine PYPO cache scheduled media files cache ahead hours 1 monit monit user guest monit password airtime soundcloud
154. to the storage server and import them into the database g manage presenter and other staff access to the broadcast schedule calendar h see what is about to be played by Liquidsoap in a scrolling list view i upload media files from Airtime to a third party hosting service such as SoundCloud j audition live Internet streams from the server k check the status and resource usage of system components EXAMPLE SYSTEM Combining Airtime the Liquidsoap stream generator the PostgreSQL database and file storage you can supply a broadcast station with all the functionality needed for automation In the diagram below the media files are stored ona server which also includes a PostgreSQL database accessible through the local network Liquidsoap outputs streams to both the transmitter and a streaming media server T he machine running Airtime is behind a firewall because it is connected both to the local network and to the Internet for remote access T his enables Airtime to offer password protected access to the media database and scheduling from both inside and outside the studio building e Remote Studio Streaming Server Studio A Studio B Studio PostgreSQL Local Network 2 e RIGHTS AND ROYALTIES If you re new to broadcasting or have not streamed your station online before reading the following brief explanation of compensation rules for songwriters musicians and other copyright holders
155. ton at the top of each forum page BUG REPORTING Airtime needs your input to improve If you think you ve found a bug please visit http dev sourcefabric org and sign in using the same login and password that you registered for the Airtime forum Create a bug report by selecting Create Issue then Airtime and then Bug T hat way the Airtime team can keep track of your problem and notify you when it has been fixed You can also suggest improvements and new features for Airtime on that site CONTACT Finally when all other avenues have been exhausted email us directly at contact sourcefabric org and we ll try to help 74 OTHER HELP The UNESCO publication Community Radio A user s guide to the technology http en flossmanuals net airtime en 2 O help booki airtime en 2 O static CommunityRadioUserGuide pdf features a very comprehensive guide to setting up a community radio station T his guide is aimed at people thinking about setting up a radio station in India but includes lots of practical advice that would be useful in any country 75 AIRTIME IN THE STUDIO 18 RECORDING SHOWS 19 LIVE SHOWS WITH MIXXX 20 ICECAST AND SHOUTCAST 8 RECORDING SHOWS Live show recording from the input of the server s sound card if one is fitted can be enabled in the Add Show box of Airtime s Calendar see the Calendar chapter for details During a recording a red light is shown in the Master Panel and the word Recording appears
156. tsampl File Edit View Go Bookmarks Help uk promi O Placesy X daniel Music mp3 struts B daniel Desktop JI L File System 1 14 Justo iive uil f Network Betancourt Pa mp3 Wastebas Bravo Yo mp3 Add files Start upload 3 Create a show by clicking Calendar on the main menu and then clicking the Show button Calendar Only admins and program managers can add shows Users NOW PLAYING ADD MEDIA PLAYLIST BUILDER CALENDAR 28 29 11 32 11 50 Show 4 Set at least a date and time for your show in the When section of the box then click the Add this show button Calendar PLAYLIST BUILDER CALENDAR 10 20 11 Time Show 16 25 16 Coffey Sho 5 Add media to the show by clicking your show in the Calendar and selecting Add Remove Content Calendar CALENDAR Jul 1 7 2012 an me b Add Remove Content ig Remove All Content Show Content F Edit Show gy Delete 6 Click media in the search results on the left side of the pop up window and drag it to your show on the right side Calendar 7 When show time arrives you re on air 4 e GETTING STARTED If the Airtime server has a web browser installed you can access the administration interface by opening the address http localhost If you have set up Airtime so that it can be accessed from other computers you would use a doma
157. ueeze the rabbitmq server daemon does not start automatically after a reboot This should be fixed before installing Airtime to prevent problems at playout time If the rabbitmq server package was installed before the last reboot you will need to run invoke rc d rabbitmq server start as the root user before the installation of Airtime If it is not already installed run the following command as root apt get install rabbitmq server After a fresh installation rabbitmq server will start automatically so there is no need to run the invoke rc d command mentioned above In either case you should then edit lines 13 and 14 of the file etc init d rabbitmq server as root to show Default Start 2 Default Stop 0 WwW 45 6 and then run the command as root update rc d rabbitmq server defaults T his should make sure that rabbitmq server starts after the next reboot MAIL SERVER If you wish Airtime to be able to send password reminder emails to your staff users the server must have a working SMT P program installed such as the postfix package in Debian or Ubuntu For configuration options refer to the documentation for your mail server of choice 91 PROCEED TO INSTALLATION Now your server should be ready for Airtime to be installed Depending on your requirements you should now proceed to either the chapter Easy setup the chapter Automated installation the chapter Manual installation or the Expert install
158. uld be located anywhere in the world Some servers are set to Coordinated Universal Time or UT C similar to Greenwich Mean Time or GMT regardless of their location If this is not appropriate for your station on a Debian or Ubuntu server you can reconfigure the tzdata time zone data package with the command sudo dpkg reconfigure tzdata T his command opens a menu in which you can select the continent that you require by pressing the Enter key Package configuration Configuring tzdata Please select the geographic area in which you live Subsequent configuration questions will narrow this down by presenting a list of cities representing the time zones in which they are located Geographic areat Africa America Antarctica Australia Arctic Asia Atlantic urope Indian Pacific Systemy Us Etc lt Cancel gt The next step is to select your nearest city again by pressing the Enter key The appropriate time zone is selected according to the information that you have entered 114 configuration Time zonet Configuring tzdata Please select the city or region corresponding to your time zone Bratislava Brussels Bucharest Budapest Chisinau Copenhagen Dublin Gibraltar Guernsey Helsinki Isle of Man Istanbul Jersey Kaliningrad Kiev Lisbon TAE lt Cancel gt The console output from the dpkg reconfigure tzdata command will confirm the new setting Current default time zone Europe London Loc
159. ur 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 69 Jul 1 7 2012 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 war sme 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 70 A EIL Jul 1 7 2012 10m v Rock Show You cannot delete or remo
160. uration file to define the mount points you will use and the relationship between them sudo nano etc icecast2 icecast xml The example lt mount gt section provided in the icecast xml file is commented out by default Before or after the commented section add three mount point definitions The default mount point used by Airtime is airtime 128 which is shown in the etc airtime liquidsoap cfg file You must also define a mount point for the live source called live ogg in this example and a mount point for the public to connect to called stream ogg in this example mount lt mount name gt airtime_128 lt mount name gt lt hidden gt lt hidden gt lt mount gt lt mount gt lt mount name gt l ogg lt mount name gt fallback mount airtime 128 fallback mount lt fallback override gt 1 lt fallback override gt lt hidden gt lt hidden gt lt mount gt lt mount gt mount name stream ogg mount name fallback mount live ogg fallback mount lt fallback override gt 1 lt fallback override gt hidden 0 hidden lt mount gt These mount point definitions mean that a client connecting to a URL such as http icecast example com 8000 stream ogg will first fall back to the live ogg mount point if it is available If not the client will fall back in turn to the airtime_128 mount point for Airtime playout 137 Setting the value of lt fallback override gt to enabled
161. ure about the action Are you sure you want to remove the watched folder cone 27 8 STREAM SETTINGS You can configure direct Icecast and SHOUT cast streams and a sound card by clicking Streams on the System menu At the top left of the Stream Settings page are global options including Hardware Audio Output which enables playout from the default sound card on the server if one is fitted default Output Type of ALSA on the drop down menu will be suitable for most servers with a sound card If not you have the option to choose from other Liquidsoap interfaces available such as OSS or PortAudio If you are only using the hardware audio output and will not be streaming directly to lcecast or SHOUT cast you can click the Save button on the right side of the page at this point T he second checkbox under Global Settings enables the sending of Icecast Vorbis Metadata with direct streams T his setting is optional because some media players have a bug which makes them disconnect from Ogg Vorbis streams when an lcecast server notifies the player that a new track is starting The Stream Label radio button allows you to set the metadata that will be sent with direct streams Artist and Title Show Artist and Title or Station name and Show name NOW PLAYING ADD MEDIA PLAYLIST BUILDER CALENDAR SYSTEM HELP Stream Settings Global Settings v Stream 1 Hardware Audio Output Output Type ALSA
162. ust have a Port for the remote broadcaster to connect to which should be a number in the range from 1024 to 49151 If you have the Icecast or SHOUT cast streaming server running on the same machine as Airtime you should avoid using port 8000 or 8001 for either type of Airtime input stream T his is because both Icecast and SHOUT cast use port 8000 and SHOUT cast also uses port 8001 If the usernames and passwords were similar remote broadcasters might accidentally connect to the streaming server directly bypassing Airtime To avoid further confusion it is also recommended that you set a different Mount Point the specific filename for broadcasters and listeners to connect to from that used on your public Icecast or SHOUT cast server If your Airtime server is behind a firewall and you wish remote broadcasters to connect input streams to it across the public Internet you may need to click the Override link to set a Connection URL which is available from outside your local area network T his URL might be based on the domain name assigned to the router which forwards the appropriate port to your Airtime server T hen click OK to save the new connection URL SWITCHING INPUT STREAMS In the Master Panel available input source streams are shown with an orange line connecting the source to the switch which you could think of like a patch cable connecting a source to a broadcast mixer When that switch is active another orange line connects th
163. ve 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 Cancel Current Show 71 6 LISTEN In the Master Panel beneath the ON AIR indicator you will find the LISTEN button Rock Show 14 20 15 20 Scheduled Play CALENDAR SYSTEM This button opens a pop up Live stream window which enables you to monitor the streams that have been configured previously in the Streams page on the System menu In the Live stream window a drop down menu enables you to switch between the streams which are currently available Both the streaming server and name of the stream are shown Your station logo is shown in the top left corner of the window if you have uploaded one via the Support Feedback page on the System menu Live stream Mozilla Firefox BOE J airtime 64studio com Dashboard stream player Live stream Beneath the drop down menu for stream selection is an orange volume control bar T his volume control only adjusts the output level of the pop up Live Stream window not the output level of the Airtime server itself To adjust output level between muted an
164. where undelivered alerts will stored is specified by the BASEDIR option You can limit the maximal qu size using the SLOTS option if omitted the queue is limited by space available in the back end filesystem Get Help Ry writeout Read File J E Prev Page Cut Text Cur Po gi Exit Justify W Where Is s Next Page UnCut Textg To Spe Further down the configuration file you can set the From and To addresses for the alert emails using the set mailformat and set alert parameters Then uncomment these lines for the parameters to be read by Monit GNU nano 2 2 2 1 monit monitrc are expanded at runtime For example to override the sender set mail format from monit foo bar You can set alert recipients here whom will receive alerts if when a service defined in this file has errors Alerts may be restricted on events by using a filter as in the second example below B set alert sysadm foo bar receive all alerts set alert manager foo bar only on timeout receive just service timeout alert th th t Monit has an embedded web server which can be used to view status of services monitored the current configuration actual services paramete and manage services from a web interface set httpd port 2812 and me Get Help WriteOut gi Read File gj Prev Page M Cut Text Cur Po Si Exit om Justify Where Is gj Next Page gf UnCut Textgy To Spe
165. y 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 EXE Wednesday Jul 6 2011 59 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 Record amp 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 60 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 Mi
166. y default Icecast streams are buffered to guard against network problems which causes latency for remote listeners When monitoring the stream from a remote location you may have to begin the live stream a few seconds before the previous stream ends to enable a smooth transition 138 5 e PROMOTING YOUR STATION If you have an Icecast server you can put a link to the Icecast status page at port 8000 on your station s homepage to provide an overview of available streams See the chapter Interface customization for tips on theming the lcecast status page Alternatively you can use Now Playing widgets see the chapter Exporting the schedule or HT ML5 stream players see the chapter Stream player for your website to grow your audience You can also uncomment the lt directory gt section the etc icecast2 icecast xml file to have your new station automatically listed on the Icecast directory website http dir xiph org which could help you pick up more listeners lt Uncomment this if you want directory listings gt directory lt yp url timeout gt 15 lt yp url timeout gt Xyp url http dir xiph org cgi bin yp cgi yp url lt directory gt Another stream directory service is provided by the Liquidsoap Hows site at http flows liquidsoap fm T he following section can be added to the file usr lib airtime pypo bin liquidsoap scripts ls scriptliq after add_skip_command s on line 174 for a stream named stream
167. your user experience Send support feedback Click the box below to advertise your station on Sourcefabric org In order to promote your station Send support feedback must be enabled This data will be collected in addition to the support feedback L Promote my station on Sourcefabric org Show me what am sending By checking this box agree to Sourcefabric s privacy policy Remind me in 1 week Yes help Airtime These details can be viewed by clicking on the Show me what I am sending link which expands a scrolling window T he data helps Sourcefabric engineers resolve any problems with your Airtime installation as well as count the number of installations worldwide 14 Remind me in 1 week Sourcefabric has a privacy policy regarding data collection which you can read by clicking the link to http www sourcefabric org en about policy further down After checking the Send support feedback and privacy policy boxes you can submit the data by clicking the Yes help Airtime button This window also offers the opportunity to Promote my station on Sourcefabric org on the page http www sourcefabric org en airtime whosusing by checking the box Fill in the form which will appear with some details about your station T he contact details are only requested for verification purposes and will not be made available to the public Click the Browse button to select a Station Logo image from the file manager on you

Download Pdf Manuals

image

Related Search

Related Contents

B-Class  Registre anonyme des sanctions disciplinaires des élèves  取扱説明書  Seip Antriebstechnik GmbH  取り付け - ソニー製品情報  User Manual - Luxusní  取扱説明書(PDF)  E n g lish T A B L E O F C O N T E N T S    

Copyright © All rights reserved.
Failed to retrieve file