Script PAL pour SAM Broadcaster : créer une playlist variée par rotation automatique

SAM Broadcaster peut créer une playlist automatique sans que vous passiez votre journée devant la queue. Encore faut-il lui donner des règles claires.

Le principe est simple : vous rangez vos morceaux dans des catégories, vous configurez les règles de rotation, puis vous utilisez un script PAL pour alimenter automatiquement la file d’attente. Résultat : une programmation plus variée, moins de répétitions, et une radio qui ne donne pas l’impression de tourner sur trois MP3 fatigués.

Le problème : une playlist automatique trop répétitive

Quand SAM Broadcaster pioche simplement des morceaux au hasard, la programmation peut vite devenir bizarre. Le même artiste revient trop souvent. Deux morceaux du même album s’enchaînent. Un jingle repasse trois fois dans l’heure. Bref, l’algorithme fait de son mieux, mais il a besoin d’un programmateur adulte dans la pièce.

Pour éviter cela, SAM Broadcaster propose deux briques importantes :

• les catégories, qui organisent votre bibliothèque musicale ;
• les règles de rotation, qui limitent les répétitions d’artistes, d’albums, de titres et de morceaux.

Le script PAL vient ensuite orchestrer tout cela en ajoutant automatiquement les bons éléments dans la queue.

Préparer les catégories dans SAM Broadcaster

Avant d’écrire le moindre script, commencez par ranger votre bibliothèque. Dans SAM Broadcaster, ouvrez la fenêtre Playlist, puis créez des catégories cohérentes.

Exemple simple :

• Tracks pour le fonds musical principal ;
• Rock pour les titres rock ;
• Blues pour les titres blues ;
• Station IDs (All) pour les identifiants antenne ;
• Jingles pour les jingles courts ;
• Promos pour les annonces ou autopromos.

Le nom exact des catégories compte. Si le script appelle CAT['Rock'], SAM doit réellement trouver une catégorie nommée Rock. Une majuscule oubliée, un espace en trop, et le script partira cueillir des fraises.

Ajoutez ensuite vos fichiers dans les bonnes catégories depuis la fenêtre Playlist. Vous pouvez importer les morceaux depuis l’explorateur Windows, depuis la queue, ou depuis d’autres catégories existantes.

Configurer les règles de rotation

Ouvrez ensuite :

Config > Playlist rotation rules

Dans cette fenêtre, configurez les règles anti-répétition. SAM Broadcaster peut éviter de rejouer trop vite :

• le même album ;
• le même artiste ;
• le même titre ;
• le même morceau exact.

Pour une petite webradio, vous pouvez commencer avec des valeurs raisonnables, puis ajuster selon la taille de votre bibliothèque.

Règle	Valeur de départ possible	Pourquoi
Même artiste	60 à 120 minutes	Évite d’entendre le même artiste trop souvent.
Même album	60 à 180 minutes	Évite l’effet “album joué en bloc”.
Même titre	180 à 360 minutes	Évite les titres identiques ou reprises trop rapprochées.
Même morceau	360 minutes ou plus	Évite la répétition exacte d’un fichier.

Ces valeurs ne sont pas universelles. Si votre bibliothèque contient 150 titres, n’imposez pas des règles prévues pour 30 000 morceaux. SAM ne pourra pas toujours trouver un titre compatible.

Spacial rappelle justement que les règles doivent correspondre à la taille réelle de votre bibliothèque. Si vous définissez des séparations trop longues avec trop peu de titres, SAM Broadcaster risque de ne plus trouver de morceau valide.

Comprendre les méthodes de sélection

Dans un script PAL, chaque appel à une catégorie peut utiliser une méthode de sélection. Les plus utiles ici sont :

Méthode	Rôle	Usage recommandé
smRandom	Choisit un élément au hasard.	Jingles, Station IDs, petites catégories.
smLRP	Choisit l’élément le moins récemment joué.	Catégories musicales équilibrées.
smLemmingLogic	Utilise la logique interne de rotation de SAM.	Catégorie musicale principale.

La méthode smLRP, pour Least Recently Played, est très pratique pour éviter de rejouer toujours les mêmes fichiers. Spacial indique que smRandom sélectionne un titre aléatoire, tandis que smLRP choisit le titre qui n’a pas été joué depuis le plus longtemps.

EnforceRules ou NoRules ?

Chaque ajout dans la queue peut respecter ou ignorer les règles de rotation.

Option	Effet	Quand l’utiliser
EnforceRules	Respecte les règles anti-répétition.	Pour les morceaux musicaux.
NoRules	Ignore les règles anti-répétition.	Pour les jingles, IDs, promos courtes.

En général, utilisez EnforceRules pour la musique. Cela évite de rejouer trop vite le même artiste, le même album ou le même titre.

Pour les jingles et les identifiants antenne, NoRules peut être nécessaire, surtout si la catégorie contient peu de fichiers. Spacial précise que, lorsqu’une catégorie contient peu d’éléments, désactiver les règles de séparation peut éviter que SAM refuse de sélectionner un Station ID.

Cependant, n’abusez pas de NoRules. Un jingle répété toutes les cinq minutes lasse vite les auditeurs. Pour les contenus courts, combinez plutôt NoRules avec smLRP afin de faire tourner les fichiers disponibles proprement.

Script PAL simple pour créer une playlist variée

Voici une version modernisée du script original. Elle ajoute plusieurs catégories dans la queue, puis attend que la file redescende sous trois éléments avant de recommencer.

{ PAL script : playlist variée par rotation automatique }
{ Source : SkyMinds.net }

PAL.Loop := True;

while True do
begin
    { Musique principale }
    CAT['Tracks'].QueueBottom(smLemmingLogic, EnforceRules);

    { Variantes musicales }
    CAT['Rock'].QueueBottom(smLRP, EnforceRules);
    CAT['Blues'].QueueBottom(smLRP, EnforceRules);

    { Identifiant antenne }
    CAT['Station IDs (All)'].QueueBottom(smLRP, NoRules);

    { Attendre que la queue se vide un peu avant de la réalimenter }
    repeat
        PAL.WaitForPlayCount(1);
    until Queue.Count < 3;
end;Langage du code : PHP (php)

Ce script construit une rotation simple :

• un titre depuis Tracks ;
• un titre depuis Rock ;
• un titre depuis Blues ;
• un identifiant antenne depuis Station IDs (All).

Ensuite, il laisse SAM Broadcaster jouer les titres. Dès que la queue contient moins de trois éléments, il ajoute une nouvelle séquence.

Pourquoi attendre que la queue redescende ?

Il ne faut pas remplir la queue avec 200 titres d’avance. Cela fige trop longtemps la programmation. Si vous modifiez vos catégories, vos règles ou votre horloge, la queue reste pleine d’anciens choix.

La ligne suivante garde la file sous contrôle :

until Queue.Count < 3;Langage du code : CSS (css)

Vous pouvez ajuster cette valeur. Par exemple :

• Queue.Count < 2 pour une queue très courte ;
• Queue.Count < 3 pour un bon équilibre ;
• Queue.Count < 5 si vous voulez toujours plusieurs titres prêts.

Pour une station automatisée, trois titres d’avance restent souvent suffisants. Cela garde un peu de marge sans transformer la queue en congélateur musical.

Variante : quatre titres puis un Station ID

Si vous voulez une rotation plus classique, vous pouvez jouer quatre titres musicaux, puis un identifiant antenne. Spacial donne d’ailleurs ce type d’exemple dans sa documentation sur la rotation Clockwheel.

{ PAL script : 4 titres puis 1 Station ID }

PAL.Loop := True;

while True do
begin
    CAT['Tracks'].QueueBottom(smLRP, EnforceRules);
    CAT['Rock'].QueueBottom(smLRP, EnforceRules);
    CAT['Tracks'].QueueBottom(smLRP, EnforceRules);
    CAT['Blues'].QueueBottom(smLRP, EnforceRules);

    CAT['Station IDs (All)'].QueueBottom(smLRP, NoRules);

    repeat
        PAL.WaitForPlayCount(1);
    until Queue.Count < 3;
end;Langage du code : PHP (php)

Cette structure est simple à lire et facile à modifier. Pour ajouter une catégorie Pop, il suffit d’ajouter une ligne :

CAT['Pop'].QueueBottom(smLRP, EnforceRules);Langage du code : CSS (css)

Variante : rotation pondérée par style

Si votre radio diffuse surtout un style principal, vous pouvez le faire revenir plus souvent dans la rotation.

{ PAL script : rotation pondérée par style }

PAL.Loop := True;

while True do
begin
    CAT['Tracks'].QueueBottom(smLemmingLogic, EnforceRules);
    CAT['Rock'].QueueBottom(smLRP, EnforceRules);
    CAT['Tracks'].QueueBottom(smLemmingLogic, EnforceRules);
    CAT['Blues'].QueueBottom(smLRP, EnforceRules);
    CAT['Tracks'].QueueBottom(smLemmingLogic, EnforceRules);

    CAT['Station IDs (All)'].QueueBottom(smLRP, NoRules);

    repeat
        PAL.WaitForPlayCount(1);
    until Queue.Count < 3;
end;Langage du code : PHP (php)

Ici, la catégorie Tracks revient trois fois. Les catégories Rock et Blues servent à varier la couleur musicale sans prendre toute l’antenne.

Variante : rotation sans jingle

Si vous voulez uniquement une playlist musicale, sans identifiant antenne, retirez simplement la ligne qui ajoute Station IDs (All).

{ PAL script : rotation musicale simple }

PAL.Loop := True;

while True do
begin
    CAT['Tracks'].QueueBottom(smLemmingLogic, EnforceRules);
    CAT['Rock'].QueueBottom(smLRP, EnforceRules);
    CAT['Blues'].QueueBottom(smLRP, EnforceRules);
    CAT['Pop'].QueueBottom(smLRP, EnforceRules);

    repeat
        PAL.WaitForPlayCount(1);
    until Queue.Count < 3;
end;Langage du code : PHP (php)

C’est la meilleure base si vous voulez traiter les jingles dans un autre script dédié. Cela évite de mélanger la logique musicale avec les contraintes antenne.

Lancer le script PAL dans SAM Broadcaster

Pour utiliser le script :

1. ouvrez SAM Broadcaster ;
2. affichez la fenêtre PAL Scripts ;
3. créez un nouveau script ;
4. collez le code PAL ;
5. vérifiez que les catégories appelées existent ;
6. compilez le script ;
7. lancez-le ;
8. surveillez la queue pendant quelques minutes.

Si SAM affiche une erreur de compilation, vérifiez d’abord les apostrophes, les points-virgules et les noms de catégories. La plupart des erreurs viennent d’un nom de catégorie incorrect ou d’un caractère copié/collé de travers.

Vérifier que la rotation fonctionne correctement

Après le lancement, contrôlez trois choses :

• la queue se remplit automatiquement ;
• les catégories alternent comme prévu ;
• les artistes ne se répètent pas trop vite.

Ensuite, ouvrez l’historique de lecture et observez une heure complète de programmation. C’est le test le plus simple. Une rotation peut sembler parfaite sur le papier, puis devenir monotone au bout de trente minutes.

Dépannage : le script ne joue pas les bons titres

Si le script tourne mais ne joue pas les morceaux attendus, vérifiez ces points dans l’ordre :

• les catégories existent exactement avec les mêmes noms ;
• les catégories contiennent bien des fichiers actifs ;
• les morceaux ne sont pas désactivés ou indisponibles ;
• les métadonnées Artist, Title et Album sont renseignées ;
• les règles de rotation ne sont pas trop strictes ;
• la bibliothèque contient assez de titres pour respecter les séparations ;
• la queue n’est pas déjà remplie par une autre logique ou un autre script.

Si SAM ne trouve plus de titre compatible, assouplissez temporairement les règles de rotation. Ensuite, augmentez-les progressivement jusqu’à trouver le bon équilibre.

Dépannage : les Station IDs ne passent jamais

Si vos identifiants antenne ne passent jamais, la catégorie contient peut-être trop peu de fichiers pour respecter les règles de séparation.

Dans ce cas, utilisez :

CAT['Station IDs (All)'].QueueBottom(smLRP, NoRules);Langage du code : CSS (css)

La méthode smLRP évite de rejouer toujours le même fichier, tandis que NoRules empêche les règles musicales de bloquer toute la catégorie.

Dépannage : le même artiste revient trop souvent

Dans ce cas, le script n’est pas forcément le problème. Regardez plutôt les règles dans Config > Playlist rotation rules.

Augmentez progressivement la séparation du même artiste. Puis vérifiez que vos tags sont propres. Si certains fichiers ont Beatles, d’autres The Beatles, et d’autres beatles, SAM ne pourra pas appliquer les règles aussi proprement que prévu.

Avant d’accuser le logiciel, nettoyez donc les métadonnées. C’est moins spectaculaire, mais beaucoup plus efficace.

Bonnes pratiques pour une rotation propre

• Gardez des catégories simples et lisibles.
• Évitez les catégories avec seulement deux ou trois titres musicaux.
• Renseignez correctement les champs artiste, titre et album.
• Utilisez EnforceRules pour la musique.
• Utilisez NoRules seulement pour les contenus courts.
• Ne remplissez pas la queue trop longtemps à l’avance.
• Testez la rotation sur une heure réelle avant de la laisser tourner seule.
• Sauvegardez vos scripts PAL après chaque modification stable.

Rotation automatique ou Clockwheel natif ?

SAM Broadcaster propose déjà une logique de rotation Clockwheel dans l’interface. Pour beaucoup de radios, elle suffit. Vous pouvez créer une séquence de catégories directement depuis Playlist rotation rules, puis laisser SAM alimenter la queue.

Le script PAL devient intéressant quand vous voulez garder la main sur la structure, documenter votre rotation dans un fichier, ou combiner cette logique avec d’autres scripts.

En clair : utilisez le Clockwheel natif pour une programmation simple. Utilisez PAL quand vous voulez une automatisation plus précise et plus facile à versionner.

Articles connexes sur SAM Broadcaster

Pour aller plus loin sans mélanger les sujets, voici les guides complémentaires :

• SAM Broadcaster : création de scripts PAL
• SAM Broadcaster : jouer un style de musique donné pendant un créneau horaire
• SAM Broadcaster : jouer une pub ou un jingle toutes les 5 chansons
• SAM Broadcaster : jouer un bip horaire avec un script PAL
• Plugin Last.fm pour SAM Broadcaster sous Ubuntu

FAQ

Comment créer une playlist variée dans SAM Broadcaster ?

Créez d’abord des catégories musicales propres, configurez les règles de rotation dans Config > Playlist rotation rules, puis utilisez un script PAL pour ajouter automatiquement les catégories dans la queue.

Pourquoi SAM Broadcaster répète-t-il trop souvent le même artiste ?

Les règles de séparation sont peut-être trop faibles, vos métadonnées sont peut-être incohérentes, ou votre bibliothèque ne contient pas assez de titres. Vérifiez surtout les champs artiste, titre et album.

Quelle différence entre smRandom et smLRP ?

smRandom choisit un fichier au hasard. smLRP choisit le fichier qui n’a pas été joué depuis le plus longtemps. Pour une rotation équilibrée, smLRP donne souvent un meilleur résultat.

Quand utiliser NoRules dans un script PAL ?

Utilisez NoRules pour les contenus courts comme les Station IDs, les jingles ou les promos, surtout si la catégorie contient peu de fichiers. Pour la musique, préférez EnforceRules.

Faut-il utiliser PAL ou le Clockwheel natif de SAM Broadcaster ?

Le Clockwheel natif suffit pour une rotation simple. PAL devient plus utile si vous voulez documenter précisément la rotation, combiner plusieurs comportements, ou intégrer cette logique dans une automatisation plus large.

Sources

• Spacial — Introduction to Clockwheel Rotation
• Spacial — Clockwheel Rotation
• Spacial — Organizing and Scheduling Music
• Spacial — PAL Scripting Quick Start Guide

Report a typo