• Introduction
• What is Airtime?
• Rights and royalties
• Using Airtime
• On air in 60 seconds!
• Getting started
• Smartphone journalism
• The System menu
• Users
• Preferences
• Media folders
• Stream settings
• Support feedback
• Status
• Playout history
• Listener stats
• The main menus
• Now playing
• Add media
• Library
• Calendar
• 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
• Host configuration
• Appendix
• Expert install
• HD Audio Models
• About this manual

Host configuration

The streaming host 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 streaming configuration manually, as any changes are likely to be overwritten by the administration interface.

Database and RabbitMQ hosts

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 unless you are running a large Airtime system distributed across multiple servers.

[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
base_dir = '/'

;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]
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. This 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!

API client configuration

If you have changed the base_url, base_port or base_dir setting in /etc/airtime/airtime.conf from the defaults, you will probably also have to update the Hostname settings in the file /etc/airtime/api_client.cfg, which are found under the 'Common' section.

#############################
## Common
#############################

# Value needed to access the API
api_key = 'XXXXXXXXXXXXXXXXXXXX'

# Path to the base of the API
api_base = 'api'

# URL to get the version number of the server API
version_url = 'version/api_key/%%api_key%%'

#URL to register a components IP Address with the central web server
register_component = 'register-component/format/json/api_key/%%api_key%%/component/%%component%%'

# Hostname
host = 'localhost'
base_port = 80
base_dir = '/'