Documentation

Heron Broadcaster est un automate de diffusion radio auto-hébergé pour Linux. Il diffuse de la musique jour et nuit vers vos serveurs Icecast, la choisit selon des catégories, des horloges et une grille de la semaine, et se pilote depuis une interface web.

Heron est en plein développement. Il diffuse de façon fiable, mais réglages et comportements peuvent encore changer d’une version à l’autre.

Pour commencer

InstallationLancer Heron avec Docker Compose et se connecter.

Premiers pasAjouter de la musique, prendre l’antenne, construire la programmation.

Mises à jourChoisir une version, la figer, mettre à jour.

Guides

BibliothèqueVotre dossier de musique, l’analyse, les nouveautés et la corbeille.

RotationCatégories, horloges, grille, séparation et restrictions.

DiffusionFondus, sonie, lecteur FX et dossier de secours.

SortiesProfils d’encodage et sorties Icecast.

Interface webLes pages, les rôles, les thèmes et les langues.

Référence

ConfigurationChaque variable d’environnement de la pile Compose.

APIAuthentification, jetons et principales routes.

SupervisionMétriques, tableau de bord Grafana, alertes et Sentry.

Comment Heron est construit

Heron, ce sont cinq services et une base MariaDB, lancés avec Docker Compose :

Service	Rôle
heron-web	L’interface web ; transmet /api à heron-api
heron-api	L’API HTTP et WebSocket, l’analyse de la bibliothèque, la file d’attente et la rotation
heron-librarian	Le dossier d’arrivée, la zone tampon, l’identification, les tags, le classement et la corbeille
heron-analyzer	L’analyse des titres
heron-engine	La diffusion en temps réel, les encodeurs et les sorties

Le moteur ne dépend jamais des autres : quand l’API ou la base de données est arrêtée, il continue de jouer ce qu’il a en file, puis son dossier de secours.

La documentation pour les développeurs (architecture, décisions, modèle de données, étapes) se trouve dans le dépôt, en anglais.