LibreTime Radio Automation

Logo

An open source radio automation server made for (and made by) low-power FM stations and the rest of us.

View the Project on GitHub LibreTime/libretime


About LibreTime
Features
FAQ
Contribute to LibreTime

Installation
Quick Install
  -- Host Configuration
  -- Setting the Server Time
  -- Configuring Track Types
  -- Setting up SSL

Using LibreTime
Preparing Media
Scheduling Shows
Broadcasting Live
Adding Users
Help!
  -- More Tutorials

Radio Broadcasting 101
UNESCO Public Radio Guide

Appendix
HD Audio Modules
Rights and Royalties
Media Folders used by LibreTime

How to Contribute to the LibreTime Project

LibreTime is a community project, maintained by an awesome group of volunteers. Being a “free as in freedom” project, we need the help of our users to keep the project going. You don’t have to know how to write code in order to help. Check out some of ways you can give back to the LibreTime project below.

Bug reporting

If you think you’ve found a bug, please report it on our Github issues page. Create a bug report by selecting Get Started next to Bug Report. That way, the LibreTime team can keep track of your problem and notify you when it has been fixed. You can also suggest improvements and new features for LibreTime on that site.

Feature requests

Have an idea that would make LibreTime even better than it is right now? Start a Feature request on our Github issues page.

Help translate LibreTime

LibreTime can run in over 15 different languages due to the gracious help of our volunteers. Is your language not supported? Follow this guide to add your language to LibreTime!

Help write code for LibreTime

Are you familar with coding in PHP? Have you made projects in Liquidsoap and some of the other services we use? Take a look at the bugs and feature requests here, and then fork our repo and have a go! Just use the Fork button at the top of our Code page, clone the forked repo to your desktop, open up a favorite editor and make some changes, and then commit, push, and open a pull request. Knowledge on how to use Github and Git will suit you well, use the links for a quick 101.

Testing LibreTime in Vagrant

Before submitting code to the project, it’s a good idea to test it first. To do this, it’s easiest to install LibreTime in a virtural machine on your local system or in a cloud VM. Instructions on how to set up a virtural instance of LibreTime with Vagrant are located here.

If you would like to try LibreTime in a Docker image, Odclive has instructions here for setting up a test image and a more persistant install.

Modifying the Database

LibreTime is designed to work with a PostgreSQL database server running locally. LibreTime uses PropelORM to interact with the ZendPHP components and create the database.

If you are a developer seeking to add new columns to the database here are the steps.

  1. Modify airtime_mvc/build/schema.xml with any changes.
  2. Run dev_tools/propel_generate.sh
  3. Update the upgrade.sql under airtime_mvc/application/controllers/upgrade_sql/VERSION for example ALTER TABLE imported_podcast ADD COLUMN album_override boolean default 'f' NOT NULL;