Airtime for Broadcasters

Interface customization

The Airtime administration interface, as a web application, is fully customizable using the same methods that you might use to update a website. For instance, you may wish to increase the font sizes or change the colours in the Airtime interface to better suit staff users with impaired vision. To do this, open one of the CSS files in the /public/css/ directory under the Airtime DocumentRoot directory in a text 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 #ffffff as follows:

body {
      font-size: 62.5%;
      font-family:Arial, Helvetica, sans-serif;
      background: #ffffff;
      margin: 0;
      padding: 0;
}

Save the file with Ctrl+O, then refresh your browser to see the change to the interface background colour.

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 Icecast web interface. If you are familiar with HTML 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.

For example, you could change the status.xsl page:

$ sudo nano /etc/icecast2/web/status.xsl

Modifying the status.xsl page is a good place to start, because this is the default page that site visitors see when they browse port 8000 on your Icecast server. The most obvious change to make in the XSLT pages is the content of the <title> and <h2> 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 should now be visible.

 

When you're happy with the way the web interface looks and the sound quality you are streaming, you can uncomment the <directory> section in 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 a few more listeners. You can also put a link to the Icecast status page at port 8000 on your station's homepage, to help integrate the two sites.