Music DJ : Spotify, YouTube et musique locale

Music DJ diffuse une musique d'arrière-plan assortie à ta scène. Ce guide explique comment connecter Spotify, YouTube ou tes propres fichiers audio, utiliser le lecteur de musique, et profiter de la musique en Game Mode et en Conversation.

Ce qu'est Music DJ

Music DJ est un agent téléchargeable facultatif. Un agent est un assistant qui tourne en arrière-plan d'un chat. Après chaque réponse, il peut lire l'ambiance de la scène et lancer une musique assortie.

Avant de commencer : ouvre Agents, sélectionne Agent Organizer (organisateur d'agents) et installe Music DJ. Il est désactivé après l'installation. Active-le pour un chat comme n'importe quel autre agent. Il fonctionne dans les chats Roleplay, en Game Mode via un interrupteur distinct (Music DJ en Game Mode), et en Conversation via la commande Music (musique) (La commande Music en Conversation).

Il puise sa musique à trois sources.

SourceCompte nécessaireCoûtIdéal pour
SpotifyTon propre compte Spotify, et Spotify Premium pour la lectureGratuit à configurer, Premium pour écouterDes morceaux réels et nommés, sur tes propres appareils
YouTubeUne clé API Google gratuiteGratuitÉcouter sans se connecter et sans Premium
CustomAucunGratuitTes propres fichiers audio

La source active apparaît sous la forme d'un petit Music Player (lecteur de musique) épinglé dans la barre supérieure. Sur téléphone et dans les fenêtres étroites, il devient un petit widget rond flottant que tu peux déplacer.

La configuration de Music DJ se fait à un seul endroit, partagé par toute l'application. Ouvre le panneau Agents à droite, puis Music DJ. Tu peux aussi cliquer sur l'icône d'engrenage du mini-lecteur (infobulle Music DJ setup).

Choisir une source de musique

Dans l'éditeur de Music DJ, le champ Music Player propose trois boutons : Spotify, YouTube et Custom. Une ligne en dessous indique ce qui est actif, par exemple "Visible player: Spotify. Saved provider: Spotify." Ce choix vaut pour toute l'application ; il n'est pas enregistré chat par chat.

Configurer Spotify

Spotify passe par ta propre application développeur Spotify, gratuite. Tu colles uniquement un Spotify Client ID. Il n'y a pas de client secret.

  1. Dans l'éditeur de Music DJ, repère Spotify Connection.
  2. Ouvre le Spotify Developer Dashboard via le lien affiché dans l'application.
  3. Crée une nouvelle application et sélectionne "Web API".
  4. Dans les Redirect URIs de l'application, ajoute l'adresse de redirection exacte que Marinara affiche à l'étape 3 de l'encadré de configuration intégré. Une adresse de redirection est l'adresse vers laquelle Spotify te renvoie après la connexion.
  5. Copie le Client ID et colle-le dans Spotify Client ID.
  6. Enregistre l'agent, puis clique sur Connect Spotify Account (connecter le compte Spotify).

Une fenêtre de connexion et d'autorisation Spotify s'ouvre. Après ton accord, elle affiche une courte page de réussite, puis se ferme. Marinara affiche une pastille verte Connected to Spotify. Disconnect (se déconnecter) supprime la connexion enregistrée.

Remarque : Spotify Premium (la formule payante) est nécessaire pour la lecture, la pause, le passage au morceau suivant et le volume. Un compte gratuit peut se connecter. Les jetons d'accès se renouvellent automatiquement.

Si ça n'a pas marché : sur une autre machine, la fenêtre de connexion peut échouer (voir ci-dessous). Sinon, vérifie que l'adresse de redirection correspond exactement.

Appareils Spotify

Spotify diffuse la musique par l'intermédiaire d'un appareil, comme ton téléphone, l'application Spotify de ton ordinateur ou un lecteur intégré.

Spotify sur une autre machine

Spotify n'accepte que les adresses de redirection sécurisées en https:// ou l'adresse de bouclage http://127.0.0.1 (le même ordinateur). Si Marinara tourne sur une autre machine en http simple, la fenêtre de connexion peut échouer. Deux solutions :

SPOTIFY_REDIRECT_URI=https://your-address/api/spotify/callback

Voir la Référence de configuration du serveur.

Choisir où Spotify puise les morceaux (Roleplay)

Quand Music DJ tourne dans un chat Roleplay, sa carte propose une liste Spotify source (source Spotify).

Configurer YouTube

Le mode YouTube demande une clé API YouTube Data, gratuite. Une clé API est un code secret qui permet à Marinara d'utiliser un service en ton nom. Aucune connexion à YouTube ni abonnement Premium n'est nécessaire.

  1. Dans l'éditeur de Music DJ, repère YouTube Connection.
  2. Ouvre la Google Cloud Console via le lien de l'application, puis crée ou choisis un projet.
  3. Active YouTube Data API v3.
  4. Va dans Credentials, puis Create credentials, puis API key.
  5. Colle la clé dans YouTube Data API Key.
  6. Clique sur Save Key (enregistrer la clé). Le bouton indique ensuite Update Key et une pastille verte "API key configured" apparaît. Remove (retirer) supprime la clé.

Laisse la clé sans restriction, ou restreins-la uniquement par API à YouTube Data API v3. Ne la restreins pas par référent HTTP. La recherche s'exécute sur le serveur : une restriction par référent la bloquerait. L'application indique que le quota gratuit (environ 100 recherches par jour) suffit largement pour un DJ personnel. Ce chiffre vient du texte de l'application et peut changer. Ta clé reste sur le serveur, chiffrée.

Utiliser tes propres fichiers de musique

Le mode Custom lit des fichiers audio depuis la machine qui fait tourner Marinara. Les formats pris en charge sont .mp3, .ogg, .wav, .flac, .m4a, .aac et .webm.

Dans l'éditeur de Music DJ, repère Custom Music Library (bibliothèque musicale personnalisée). Elle contient un seul interrupteur, Use Game Assets music folder (utiliser le dossier de musique des ressources de jeu).

Les configurations Roleplay et Game Mode affichent la même source. Si tu as choisi un dossier sur l'appareil serveur, les réglages Music DJ du chat affichent ce chemin et un bouton Choose Folder (choisir un dossier).

La lecture depuis un dossier hors de Game Assets demande un accès local au serveur. Depuis un autre appareil, sans identifiants de connexion ni secret d'administration, cette fonction peut être bloquée. Voir Accès à distance : connexion et liste d'autorisation d'IP.

Utiliser le lecteur de musique

Le Music Player est une pastille dans la barre supérieure sur ordinateur et un widget déplaçable sur mobile. Pour l'afficher ou le masquer, ouvre Settings → General → App Behavior (Paramètres → Général → Comportement de l'application) et active ou désactive Music Player. Il est activé par défaut. S'il est activé alors que Music DJ n'est pas installé, le lecteur affiche Download Music DJ Agent to configure et propose un bouton Agent Organizer.

Sur un profil neuf, la source de départ est YouTube. Change-la avec le bouton rond de changement de source sur le lecteur (infobulle "Switch to ... player"), avec les boutons Music Player de l'éditeur, ou dans les réglages Music DJ d'un chat.

Le lecteur affiche la pochette ou la miniature du morceau, son titre et l'artiste ou la chaîne. Les commandes dépendent de la source.

DJ Mari : le créateur de playlists par IA

Le bouton DJ du mini-lecteur Spotify ("DJ Mari composes a playlist for you!") compose une playlist thématique. DJ Mari demande à ton modèle d'IA connecté de la bâtir à partir de ton persona, du personnage que tu utilises le plus et de tes chats récents, tous chats confondus. Les morceaux trouvés sont ajoutés à une nouvelle playlist Spotify nommée "DJ Mari" suivi de la date du jour, et la lecture démarre.

DJ Mari a besoin de deux choses.

En cas de réussite, tu vois "DJ Mari playlist is ready" avec un bouton Open playlist (ouvrir la playlist).

Music DJ en Game Mode

Game Mode a sa propre musique d'arrière-plan, issue de Game Assets. Pour utiliser Music DJ à la place, active l'interrupteur Music DJ dans la configuration de la partie ("Use the Music DJ for this game instead of local music assets"). Il est désactivé par défaut. Tu retrouves alors les mêmes choix Spotify, YouTube et Custom, et les mêmes champs, qu'en Roleplay.

Avec Spotify, après chaque scène, le serveur dresse une courte liste de vrais morceaux candidats tirés de la source choisie, et l'IA en choisit un. Cela l'empêche d'inventer un morceau. Game Mode joue un seul morceau en boucle à la fois. Pour obtenir une nouvelle sélection pour la scène actuelle, ouvre Game controls (contrôles du jeu) et choisis Retry Music DJ (relancer Music DJ). Voir Les contrôles du jeu.

La commande Music en Conversation

En Conversation, tu ne peux pas ajouter Music DJ comme agent. Les personnages lancent plutôt des morceaux via la commande Music.

  1. Ouvre la section Commands (commandes) du chat et active l'interrupteur principal Commands.
  2. Active Music ("Let characters play songs through the active Music Player").

Un personnage peut alors nommer un morceau pour Spotify, ou décrire un titre pour YouTube, et Marinara le lance sur la source active. Cela fonctionne même si Music DJ n'est activé nulle part. Il suffit que Spotify soit connecté ou qu'une clé YouTube soit enregistrée. Si Spotify n'est pas connecté ou n'a pas l'autorisation de lecture, une commande de morceau Spotify ne fait rien et n'affiche aucune erreur.

Dépannage

Guides associés