Skip to content
Snippets Groups Projects
Select Git revision
  • lars-tests
  • master default protected
  • develop
  • topic/filesystem-fallbacks
  • topic/tank_connection
  • topic/tank_connection_david
  • dev-old-david
  • user/equinox/docker
  • master-old
  • dev-old
10 results
Blame Permalink
Forked from AURA / engine
1704 commits behind, 194 commits ahead of the upstream repository.
README.md 3.34 KiB

AURA Engine

Aura Engine is a play-out engine as part of Automated Radio (Aura) system, specifically build for the requirements of community radios.

Features

  • Play audio from multiple sources
  • Dynamic switching of sources
  • Record output to filesystem
  • Stream output to an Icecast Server
  • Multichannel Line-out
  • Blank Detenction / Silence Detecter
  • Auto Pilot a.k.a. Fallback Handling

Read more on the Engine Features page.

Architecture

AURA Engine as part of the AURA Radio Suite uses an modulear architecture based on a REST API. All external information is retrieved using JSON data-structures.

To learn more, checkout the Engine Developer Guide or visit the Aura Meta repository.

Requirements

Hardware Requirements: This depends on how many audio sources and targets you are going to use, but for the most common scenarios any current hardware should be sufficient. For the audio devices it is required to use an interface which has supported ALSA drivers.

Operating System: Any linux system with ALSA, PulseAudio or Jack2 support should work. It is tested and coded on Debian Stretch and Ubuntu 18.0 with Python 3.6+.

Installation

git clone https://gitlab.servus.at/autoradio/engine

Install System Packages:

sudo apt install \
    git \
    python3 python3-pip \
    redis-server \
    liquidsoap liquidsoap-plugin-icecast \
    mariadb-server libmariadbclient-dev \
    quelcom \
    liquidsoap-plugin-alsa liquidsoap-plugin-pulseaudio \
    liquidsoap-plugin-all

Install Python Packages:

sudo pip3 install -r requirements.txt

Setup Database:

mysql -u root -p

CREATE DATABASE aura_engine CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;  
CREATE USER 'aura'@'localhost' IDENTIFIED BY 'secure-password';  
GRANT ALL PRIVILEGES ON aura_engine.* TO 'aura'@'localhost';

Configuration:

Run

  sh init.sh

This creates the folder /var/audio and copies some default configuration to /etc/aura/engine.ini

After that, you have to edit the settings in /etc/aura/engine.ini. Ensure to take your time to carefully review those settings!

Read more about detailed settings in the Configuration Guide.

Start the Engine

To start the AuRa Engine execute:

  systemctl start aura-lqs
  systemctl start aura-engine

and on system boot run following:

  systemctl enable aura-lqs
  systemctl enable aura-engine

The first service starts the LiquidSoap Engine, while the latter boots the actual AuRa Engine.

Logging

You can access the service logs using one of:

    journalctl -u aura-lqs
    journalctl -u aura-engine

Resources