Skip to content
Autonomous Interactive Radio
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Autonomous Interactive Radio

A radio station manager program that queues and plays all songs (mp3s, m4as, etc.) received by email.

air cycle


Tested on Ubuntu 11.04 and with Raspberry Pi, running python versions 2.7.1 and 2.7.3. See requirements.txt for required python libraries and versions.


  • Uses mpd to play music
  • Ability to add jingles between songs!
  • "Now playing" Twitter feed
  • Email response for successful submissions

Debian installation instructions

  1. apt-get install pip mpd mpc
  2. pip install -U -r requirements.txt
  3. git clone
  4. cp air_download.conf.sample air_download.conf
  5. Edit air_download.conf (suggest making a new email account for this)
  6. python (may need to run as root)

To make this a service on startup (from here):

  1. Edit AIR_DIR variable in init.d/airadio
  2. sudo cp init.d/airadio /etc/init.d/
  3. update-rc.d airadio defaults

Outputting to FM broadcast transmitter

This project can be paired with an FM transmitter to create a community pirate radio station. We ran this software on a Raspberry Pi paired with a low-power FM transmitter, see more.

Streaming to an Icecast server

mpd has built in functionality to stream what it plays to an Icecast server. This gives you the option to stream Autonomous Interactive Radio to your friends via the Internet. Learn how to do this.

Learn how to do this on a Raspberry Pi, but I warn you that the Raspi is CPU-bound when it does this and tends to have choppy playback.

To do list

Check it out here!

You can’t perform that action at this time.