FLOZz Daily Mix : un générateur de playlist pour Nextcloud Music et Subsonic

Contraintes

Pour générer mes Daily Mix, je m'impose quelques contraintes. La principale est de n'utiliser que des données en provenance du cloud pour lequel les playlists sont générées ; il n'est pas question de dépendre d'autres APIs telles que Last.fm.

La seule exception à ceci sera pour la gestion des genres musicaux : il est nécessaire d'en avoir une liste complète, avec les relations entre chaque genre (par exemple le J-Rock descend de l'Alternative Rock qui lui-même descend du Rock). Ces données seront récupérées dans la base de données de MusicBrainz et intégrées à l'application (elles seront hardcodées et pas téléchargées dynamiquement).

Bref, en dehors de l'API Subsonic du cloud visé, logiciel doit se suffire à lui-même.

Pour ce qui est des dépendances (Python) de l'application on va là aussi aller à l'essentiel et en avoir le moins possible. Il n'y en a d'ailleurs aucune actuellement. 😁️

Constitution d'une playlist

Même si j'ai dit en introduction que les playlists totalement aléatoires ne me conviennent pas, on ne peut pas travailler sans un peu d'aléa. FLOZz Daily Mix en utilise donc (beaucoup) lors de la génération des différents mixes, mais pas n'importe comment.

Pour que les listes de lecture générées soient intéressantes, elles sont bâties sur un squelette qui nous permettra de sélectionner des musiques selon différents critères et de les placer de manière stratégique.

Voici un petit schéma de ce squelette :

Pour chaque type d'emplacement on va calculer un score à partir de différents critères qui dépendent de ce qu'on cherche à y placer, et on va mixer ce score avec des nombres aléatoires afin de sélectionner un pool de musiques éligibles à l'emplacement.

Les musiques seront ensuite tirées au sort à partir de ces pools lors du remplissage des playlists. L'aléatoire intervient donc deux fois : lors de la sélection des musiques, puis lors du remplissage des listes de lecture.

En plus de tout ça, quelques contraintes supplémentaires sont appliquées à la génération :

• On essaye autant que possible de ne pas avoir deux musiques du même artiste à la suite ; on refait d'ailleurs le tirage au sort de la musique jusqu'à trois fois pour éviter que cela ne se produise (mais des fois ça se produit quand même 🤷️).
• On ne met pas deux fois la même musique dans une même playlist. Il est toutefois possible qu'une chanson apparaisse plusieurs fois dans un mix si elle existe en plusieurs exemplaires dans le cloud (par exemple dans un Album, dans un Single et dans un Best of) car du point de vue du cloud il s'agit de trois titres différents.

Voyons à présent plus en détail les critères utilisés pour remplir les différents emplacements des listes de lecture.

Filtrage des titres

Pour chaque mix généré, les musiques peuvent être filtrées en fonction d'un certain nombre de critères. Pour le moment il y en a quatre de disponibles :

• La durée minimale de la piste (60 secondes par défaut). Ça permet d'éliminer la plupart des intros et des interludes.
• La durée maximale de la piste (600 secondes par défaut), pour éviter les musiques trop longues.
• Le filtrage du titre selon une expression régulière, qui permet d'éliminer des titres qui comportent certains mots. Par exemple l'expression "^.*(intro(duction)?|instrumental|acoustic).*$" permet d'écarter les intros ainsi que les versions instrumentales et les versions acoustiques.
• La note minimale de la piste (2 par défaut). Si la note de la piste est en dessous de cette valeur, elle sera écartée. Cependant il est important de rappeler qu'une piste non notée (note égale à 0) est considérée comme ayant une note de 3.

Ces filtres permettent déjà d'effectuer un premier tri des musiques, mais ils sont insuffisants. À terme je vais en rajouter d'autres, telle que le genre de la musique ou encore une fourchette de date de parution de l'album. Ça permettrait par exemple de créer des mixes contenant uniquement des morceaux Pop et Rock des années 80.

Comment utiliser FLOZz Daily Mix pour générer des playlists ?

FLOZz Daily Mix est un petit logiciel en ligne de commande écrit en Python. Il se configure via un fichier de configuration dans lequel on peut définir les informations d'accès au cloud et l'ensemble des mixes que l'on souhaite générer. L'idée étant de le lancer toutes les nuits avec une tâche cron pour qu'il régénère de nouvelles playlists chaque jour.

Si vous cherchez le code source, vous le trouverez sur GitHub :

• https://github.com/flozz/daily-mix

sudo apt install python3 python3-venv

python3 -m venv ./daily-mix.venv
#               ↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑
#     dossier dans lequel sera installée l'app

./daily-mix.venv/bin/pip install flozz-daily-mix

./daily-mix.venv/bin/flozz-daily-mix --help

[subsonic]
api_url = https://nextcloud.example.org/apps/music/subsonic
api_username = foobar
api_password = s3cr3tp4ssw0rd
api_legacy_authentication = true

[playlist:mix1]
name = FLOZz Mix 1
description = FLOzz Daily Mix
max_tracks = 60
min_track_duration = 60
max_track_duration = 600
ignore_tracks_matching = ^.*(intro(duction)?|instrumental|acoustic).*$
minimal_track_rating = 2

[playlist:topmix1]
name = FLOZz Top Mix
description = Best musics!
max_tracks = 60
minimal_track_rating = 4

Générer les mixes

Une fois la configuration écrite, vous pouvez générer vos mixes à l'aide de la commande suivante :

./daily-mix.venv/bin/flozz-daily-mix generate ma_config.conf

La commande va prendre un certain temps pour récupérer les données sur le cloud, puis elle va générer les playlists et enfin les créer (ou les mettre à jour) directement sur votre cloud musical.

Si vous souhaitez simplement voir ce que ça donne dans rien modifier sur votre cloud, c'est possible en rajoutant quelques options :

./daily-mix.venv/bin/flozz-daily-mix generate --dry-run --print-playlist ma_config.conf

• --dry-run permet d'éviter d'écrire quoi que ce soit dans le cloud,
• --print-playlist permet d'afficher le contenu des playlists générées dans le terminal, ce qui donnera un résultat similaire à celui-ci :

0 3 * * * nom_utilisateur /opt/daily-mix.venv/bin/flozz-daily-mix generate /etc/flozz-daily-mix.conf

Conclusion

Je n'ai pas pour habitude d'utiliser mon nom ou mon pseudo pour nommer mes projets, car je trouve que ça fait mégalo, mais dans le cas présent ça m'a semblé pertinent, car les playlists sont générées selon des critères qui me sont propres. Dit autrement, ça fonctionne avec ma bibliothèque musicale, avec la manière dont j'ai taggé mes musiques et le résultat me convient. Il est possible que ça convienne également à d'autres, c'est pour ça que je partage le logiciel, mais je ne garantis rien. 😄️

J'utilise FLOZz Daily Mix depuis quelques mois maintenant, en le faisant évoluer petit à petit, et j'en suis plutôt satisfait. Il y aura forcément quelques petits réglages à faire au niveau de la pondération des critères qui interviennent dans le calcul des différents scores, mais ça se fera avec le temps.

Pour le moment mon principal focus de développement va être l'ajout de la gestion des genres ; c'est une fonctionnalité importante pour pouvoir enfin générer des mixes thématiques. Comme je l'ai dit un peu plus tôt, ça va être un gros morceau, car il faut gérer les relations entre les différents genres. Par exemple si je veux une playlist « Metal », il ne faut pas que seuls les morceaux taggés « Metal » soient sélectionnés, mais aussi tous ceux taggés avec un sous-genre du Metal. Je vais également devoir refaire une passe sur l'ensemble de ma bibliothèque pour m'assurer que le genre de toutes les musiques est correctement défini.

Une fois les genres implémentés, je vais probablement rajouter quelques filtres simples comme ceux permettant de définir une année de parution minimale et maximale. Et avant de sortir la v1.0.0, je vais m'assurer de la compatibilité de l'application avec les autres clouds supportant l'API Open Subsonic, notamment en implémentant l'authentification par jeton.

Il me reste donc un peu de boulot sur ce projet, mais ça avance tranquillement. J'espère en tout cas que cette application pourra être utile à certains et que cet article vous aura intéressé.

À bientôt ! 😁️