• Introduction
• What is Airtime?
• Rights and royalties
• Using Airtime
• On air in 60 seconds!
• Getting started
• Smartphone journalism
• The System menu
• Preferences
• Users
• Media folders
• Stream settings
• Support feedback
• Status
• Listener stats
• The main menus
• Now playing
• Add media
• Library
• Calendar
• History
• Listen
• Help
• Airtime in the studio
• Recording shows
• Live shows with Mixxx
• Icecast and SHOUTcast
• Installation
• Preparing the server
• Easy setup
• Automated installation
• Manual installation
• Setting the server time
• Administration
• Preparing media for ingest
• Using the airtime-import script
• The airtime-log command
• Backing up the server
• Upgrading
• Troubleshooting
• Using Monit
• Advanced configuration
• Automated file import
• Icecast handover
• Promoting your station
• Stream player for your website
• Exporting the schedule
• Interface customization
• Interface localization and Git
• Host configuration
• Airtime API authentication
• Secure login with SSL or TLS
• Icecast statistics with Piwik
• Appendix
• Expert install
• HD Audio Models
• About this manual

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. To 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 #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.