pyLIRAS Quick Start (Intermediate Users)

0. Assumptions

• Debian/Ubuntu-based system
• Comfortable with CLI and editing config files
• Optional: database on separate host

1. PostgreSQL — Install & Configure

Install

sudo apt update
sudo apt install postgresql

Create Database & User

sudo -u postgres psql

CREATE DATABASE pyliras;
CREATE USER pyliras WITH PASSWORD 'strong_password';
GRANT ALL PRIVILEGES ON DATABASE pyliras TO pyliras;
ALTER DATABASE pyliras OWNER TO pyliras;
\q

Enable Remote Access

sudo nano /etc/postgresql/*/main/postgresql.conf

listen_addresses = '*'

sudo nano /etc/postgresql/*/main/pg_hba.conf

host    pyliras     pyliras     192.168.1.0/24     scram-sha-256

sudo systemctl restart postgresql

Test Connection

psql -U pyliras -h <db_ip> -d pyliras

2. opam — Install & Setup

sudo apt install opam
opam init --disable-sandboxing
eval $(opam env)

echo 'eval $(opam env)' >> ~/.bashrc
source ~/.bashrc

Log out and log back in OR Reboot to get bashrc changes

3. Liquidsoap — Install

opam switch create liquidsoap-stable 5.1.1
eval $(opam env)

opam install liquidsoap ffmpeg ssl tls-liquidsoap ctypes-foreign bjack

VERIFY INSTALLATION:

liquidsoap --version

4. pyLIRAS — Install

sudo dpkg -i pyliras-broadcaster_*.deb
sudo apt --fix-broken install

Install Location:

/opt/pyliras-broadcaster

5. First Run

/opt/pyliras-broadcaster/pyliras

Database Settings:

• Host: <db_ip>
• Port: 5432
• Database: pyliras
• User: pyliras
• Password: your_password
• SSL Mode: require

Install Database Schema

Admin Username and Password are the same previously entered above

6. Minimal Setup

• Configuration > Station Settings
• Create Categories (Music, Station_ID)
• Import tracks
• Configure Audio Processing
• Configure Encoders
• Enable AutoDJ (queue size: 2–5 songs)

7. Start Engine

• Start Liquidsoap via GUI
• Enable AutoDJ

Optional: Requests API

tar -xvzf pyliras-requests-*.tar.gz
cd pyliras-requests-*
sudo ./install.sh

DATABASE_URL=postgresql://pyliras:password@host:5432/pyliras

Common Gotchas

System Flow

pyLIRAS (GUI)
    ↓
PostgreSQL (Database)
    ↓
Liquidsoap (Engine)
    ↓
Stream Output