Installation#

Malgré tous nos efforts, un un automate de diffusion reste plus complexe qu'un lecteur MP3. Vous devrez prendre le temps de faire des réglages et fournir du contenu. Nous vous recommandons de lire cette page une fois avant d'ouvrir un terminal.

⚠️ Radiotomate est encore en version bêta. Il peut rester des bugs et il manque certaines fonctionnalités que nous aimerions avoir dans une vraie « V1 ». Mais il est déjà assez stable et les versions à venir pourront mettre à jour les installations de la version bêta, donc vous pouvez déjà l'essayer.

Prérequis#

  • Vous avez déjà utilisé Linux et sa ligne de commande.
  • Nous ne publions actuellement des conteneurs que pour l'architecture amd64 (processeurs Intel/AMD).
  • L'installeur automatique suppose être sur une installation toute neuve de Debian ou Ubuntu. Si vous souhaitez utiliser une autre distribution, c'est possible si Podman est déjà installé (au moins Podman v4.4, donc Debian 12/bookworm est trop ancienne).
  • De la musique et des jingles - au moins un de chaque ! Sinon Radiotomate se plaindra constamment dans ses journaux qu'il n'a rien à jouer.
  • Les besoins en espace disque dépendent de la qualité moyenne (et de la durée) de la musique et des épisodes que vous diffuserez, mais aussi de la fréquence à laquelle vous souhaitez nettoyer les sons déjà diffusés. Les conteneurs de Radiotomate utilisent un peu plus de 2 Go. Il vous faut donc quelques Go pour tester ; pour une utilisation en production, entre 100 Go et 1 To devraient être confortables.

Avant de commencer une installation pérenne, nous vous conseillons de lire entièrement cette page, mais aussi la section maintenance car elle pourrait influer votre configuration finale.

Nous vous conseillons également de copier-coller chaque commande et action effectuée, dans un fichier que vous conserverez avec votre sauvegarde pour faciliter votre prochaine installation.

Installation#

Téléchargez l'installeur dans votre dossier personnel :

wget https://radiotomate.org/install.sh

Rendez-le exécutable :

chmod +x install.sh
  • Si vous souhaitez uniquement diffuser vers Icecast, exécutez LANGUAGE=fr ./install.sh
  • Si vous avez besoin de sortir au moins vers une carte son, exécutez USE_PULSEAUDIO=yes LANGUAGE=fr ./install.sh
  • Si vous en avez la curiosité, vous pouvez l'ouvrir avec un éditeur de texte. Toutes les options sont listées et commentées au début du fichier.

Le script vous posera quelques questions de manière interactive. Une fois terminé, vous aurez un automate radio fonctionnel, qui a seulement besoin de savoir où le son doit sortir. Pour cette dernière étape, vous avez besoin d'un éditeur de texte, pour modifier le fichier radiotomate_data/radiotomate.yaml. Trouvez le bloc suivant :

    outputs:
        #- driver: pulseaudio
        #  # empty(null) will let pulseaudio choose the default device.
        #  device:

        #- driver: icecast
        #  encoder: vorbisvbr
        #  quality: 0.3
        #  host: "127.0.0.1"
        #  port: 9876
        #  mount: "radio.ogg"
        #  password: "secret"

Les lignes qui commencent par un # sont des commentaires (ignorés par l'application), donc ces blocs sont des exemples et par défaut outputs est vide. Supprimez quelques # selon les sorties que vous souhaitez.

Si vous souhaitez uniquement sortir vers une carte son, utilisez :

outputs:
    - driver: pulseaudio

Si vous souhaitez uniquement sortir vers Icecast, utilisez :

outputs:
    - driver: icecast
    encoder: vorbisvbr
    quality: 0.3
    host: "192.168.0.123"
    port: 9876
    mount: "radio.ogg"
    password: "Icecast's input password"

Si le serveur Icecast est sur la même machine, définissez host à host.containers.internal. localhost ou 127.0.0.1 ne fonctionneront pas car nous exécutons Radiotomate dans des conteneurs. Vous trouverez tous les détails sur ce fichier de configuration dans la section qui lui est consacrée.

Une fois terminé, sauvegardez ce fichier et redémarrez Radiotomate :

systemctl --user restart radiotomate

Au démarrage, Radiotomate joue un son de corne de brume (expliqué ici), mais à ce stade il n'a rien d'autre à jouer : fournissez-lui de la musique en copiant des fichiers musicaux dans le dossier radiotomate_data/MusicDropbox. En moins d'une minute ces fichiers devraient être déplacés vers radiotomate_data/Music et commencer à jouer.

Vous pouvez maintenant accéder à l'interface de Radiotomate sur http://127.0.0.1:6811/. Connectez-vous en tant qu'admin avec le mot de passe défini lors de l'installation. Commencez par créer une cartouche de jingles contenant au moins un son.

Vous pouvez aussi ajouter, modifier ou supprimer des pistes pour l'AutoDJ dans l'onglet "Musique".

Si la radio ne démarre pas, lisez la section sur la maintenance.

Accès depuis Internet#

L'interface est accessible sur le port 6811, mais il n'est pas sécurisé (le s dans HTTPS) et devrait être bloqué par votre pare-feu. Notez que les ports ouverts dans les conteneurs sont ouverts à toutes les adresses IP. Si vous souhaitez accéder à l'application via Internet, vous devez configurer un serveur Web pour servir de proxy vers le port 6811. Vous voudrez probablement aussi faire un proxy du port 6800, utilisé par Radiotomate pour les flux en direct.

bientôt sur vos écrans : comment configurer Caddy comme proxy Radiotomate et Icecast.

Ensuite#

En cas de problème#

L'installateur enregistre tout dans le fichier radiotomate_install.log, joignez-le si vous avez besoin d'aide.

Désinstallation#

Si vous souhaitiez seulement tester Radiotomate (merci !) vous pouvez revenir à l'état initial en exécutant les commandes suivantes :

rm ~/.config/containers/systemd/radiotomate*
podman pod rm -f radiotomate
podman image prune -a
rm -rf radiotomate_data