Spotify
Incluse avec Macro DeckPilotez la lecture Spotify, likez des titres, gérez vos playlists et affichez ce qui est en lecture sur votre deck.
Deux widgets Lecteur de musique qui jouent un morceau, l'un en style Pochette pleine et l'autre en style Petite pochette, tous deux avec le nom et le logo de Spotify dans l'en-tête
- Lecture, pause, titre suivant, position, lecture aléatoire, répétition et volume
- Lancez un titre ou une playlist, ou choisissez-en un au moment d'appuyer sur le bouton
- Likez des titres et ajoutez le titre en cours à une playlist
- Transférez la lecture vers un autre appareil Spotify
- Widget Lecteur de musique et variables pour le titre, l'artiste et la progression
L'intégration Spotify relie Macro Deck à votre compte Spotify via la Spotify Web API. Elle pilote la lecture partout où Spotify joue pour ce compte : l'application de bureau, votre téléphone, une enceinte ou tout autre appareil Spotify Connect. Spotify n'a pas besoin de tourner sur l'ordinateur qui exécute Macro Deck.
Pour vous connecter, vous créez votre propre petite application dans le Spotify Developer Dashboard et saisissez son ID client et sa Clé secrète client dans Macro Deck. Macro Deck ouvre ensuite la connexion Spotify, et vous autorisez l'accès une fois. Piloter la lecture via la Web API nécessite Spotify Premium ; c'est une règle de Spotify, pas de Macro Deck.
Ce que vous pouvez faire
- Lancer, mettre en pause, passer, changer de position, activer ou désactiver la lecture aléatoire, définir le mode de répétition et modifier le volume.
- Lancer un titre ou une playlist précis. Laissez le choix vide, et Macro Deck vous demande d'en choisir un quand vous appuyez sur le bouton.
- Lancer la lecture sur un appareil précis, ou transférer la lecture vers un autre appareil en la laissant en cours ou en pause.
- Ajouter le titre en cours à vos Titres likés ou l'en retirer, et l'ajouter à une playlist ou l'en retirer.
- Afficher ce qui est en lecture dans le widget Lecteur de musique, avec la pochette, la progression et des boutons lecture et passer.
- Utiliser des variables comme
spotify_current_track_namedans les libellés des boutons, et lier un curseur àspotify_volumeouspotify_current_position.
Quelques exemples de configuration :
- Un bouton Toggle Play/Pause qui indique si la musique est en lecture ou en pause.
- Un bouton cœur avec Basculer le titre aimé qui indique si le titre en cours fait partie de vos Titres likés.
- Un bouton qui transfère la lecture de votre ordinateur vers l'enceinte du salon avec Transfer Playback.
- Un curseur lié à
spotify_volumequi suit le volume et le modifie pendant que vous le faites glisser.
Fonctionnement
Macro Deck demande l'état de lecture à Spotify environ toutes les 3 secondes pendant la lecture, toutes les 5 secondes en pause et toutes les 10 secondes quand rien ne joue. Les changements faits dans l'application Spotify apparaissent dans ce délai. Les jetons d'accès sont renouvelés en arrière-plan : vous ne vous reconnectez donc que si Spotify révoque l'accès. Quand Spotify limite le nombre de requêtes ou ne répond pas, Macro Deck fait une pause, conserve le dernier état connu et affiche un problème sur la page Spotify sous Intégrations jusqu'à pouvoir reprendre. Vous pouvez connecter un seul compte Spotify.
Ce qu'il vous faut
- Un compte Spotify Premium. Spotify ne laisse que les comptes Premium piloter la lecture via sa Web API.
- Votre propre application dans le Spotify Developer Dashboard, pour son Client ID et son Client Secret.
- Un navigateur web sur l'ordinateur qui exécute Macro Deck, pour la connexion Spotify.
- Spotify ouvert sur au moins un appareil, pour qu'il y ait quelque chose à piloter.
Configuration
Étape 1: Créez une application dans le Spotify Developer Dashboard
Ouvrez le Spotify Developer Dashboard sur developer.spotify.com/dashboard, connectez-vous et créez une nouvelle application. N'importe quel nom et n'importe quelle description conviennent.
Étape 2: Lancez la configuration dans Macro Deck
Dans Macro Deck, cliquez sur Intégrations dans la barre latérale, puis sur Spotify. Dans l'onglet Aperçu, cliquez sur Configurer dans la section Configuration. Activer l'interrupteur en haut à droite ouvre la même boîte de dialogue, et l'intégration est activée une fois la configuration terminée. La boîte de dialogue Connecter Spotify affiche une URI de redirection avec un bouton de copie.
Étape 3: Ajoutez l'URI de redirection à votre application Spotify
Dans les réglages de votre application Spotify, ajoutez l'URI de redirection affichée par Macro Deck, exactement telle quelle, et enregistrez.
Étape 4: Saisissez l'ID client et la clé secrète client
Copiez le Client ID et le Client Secret de votre application Spotify et collez-les dans les champs ID client et Clé secrète client de Macro Deck. Cliquez ensuite sur Continuer.
Étape 5: Autorisez l'accès dans votre navigateur
Macro Deck ouvre la connexion Spotify dans votre navigateur et la boîte de dialogue affiche En attente d'autorisation…. Connectez-vous avec votre compte Premium et autorisez l'accès, puis revenez dans Macro Deck. La configuration se poursuit d'elle-même et prend le nom de votre compte Spotify, par exemple Spotify (Alex). Quand la boîte de dialogue affiche Configuration terminée., cliquez sur Terminé.
Étape 6: Ajoutez une action à un bouton
Sur la page Deck, cliquez sur le bouton que vous voulez utiliser. Le deck doit être déverrouillé : c'est le cas lorsque le bouton en haut à droite indique Verrouiller. L'éditeur s'ouvre avec Appui court sélectionné. Cliquez sur + Ajouter une action, sélectionnez Spotify à gauche de la boîte de dialogue Ajouter une action et choisissez une action comme Toggle Play/Pause. Cliquez ensuite sur Enregistrer.
Étape 7: Appuyez sur le bouton
Lancez quelque chose dans Spotify sur n'importe quel appareil, puis appuyez sur le bouton de votre deck. La lecture se met en pause ou reprend.
Actions18
Placez-les sur un bouton ou exécutez-les depuis un flux.
- Play
- Reprend la lecture.
- Pause
- Met la lecture en pause.
- Toggle Play/Pause
- Alterne entre lecture et pause, et affiche l'état de lecture sur le bouton.
- Next Track
- Passe au titre suivant.
- Previous Track
- Revient au titre précédent.
- Refresh State
- Demande immédiatement à Spotify l'état de lecture actuel.
- Set Volume
- Règle le volume de l'appareil qui joue, de 0 à 100 %.
- Volume Up
- Augmente le volume de 10 %.
- Volume Down
- Baisse le volume de 10 %.
- Seek
- Va à une position du titre en cours, en secondes.
- Toggle Shuffle
- Active, désactive ou bascule la lecture aléatoire, et indique si elle est activée.
- Set Repeat Mode
- Règle la répétition sur Off, Repeat Track ou Repeat Album/Playlist.
- Play Track
- Lance un titre que vous cherchez ou choisissez dans vos Titres likés, ou vous demande d'en choisir un à l'exécution de l'action.
- Play Playlist
- Lance l'une de vos playlists ou une playlist que vous cherchez, ou vous demande d'en choisir une à l'exécution de l'action.
- Play on Device
- Lance la lecture sur un appareil Spotify précis, ou vous demande d'en choisir un à l'exécution de l'action.
- Transfer Playback
- Transfère la lecture vers un autre appareil en la laissant en cours ou en pause.
- Basculer le titre aimé
- Ajoute le titre ou l'épisode en cours à vos Titres likés ou l'en retire, et indique s'il est liké.
- Ajouter ou retirer d'une playlist
- Ajoute le titre ou l'épisode en cours à une playlist ou l'en retire, et indique s'il fait partie de cette playlist.
Déclencheurs8
Un bouton ou un flux peut réagir à ces événements.
- Piste changée
- Un autre titre a commencé à jouer, avec son titre, son artiste et son album (sous Music Player).
- Lecture démarrée
- La lecture a démarré ou repris (sous Music Player).
- Lecture en pause
- La lecture a été mise en pause (sous Music Player).
- Lecture arrêtée
- La lecture s'est arrêtée (sous Music Player).
- Appareil de lecture changé
- La lecture est passée sur un autre appareil (sous Music Player).
- Volume changé
- Le volume a changé, avec la nouvelle et l'ancienne valeur (sous Music Player).
- Lecteur connecté
- Spotify est devenu joignable (sous Music Player).
- Lecteur déconnecté
- Spotify n'est plus joignable (sous Music Player).
Variables19
Affichez ces valeurs sur des boutons et des widgets, ou utilisez-les dans des conditions.
spotify_current_track_name- Le titre du morceau en cours de lecture.
spotify_current_artist- Les artistes du titre en cours, séparés par des virgules.
spotify_current_album- L'album du titre en cours.
spotify_playback_state- L'état de lecture :
playing,pausedoustopped. spotify_is_playing- Indique si de la musique joue en ce moment.
spotify_volume- Le volume en pourcentage. Vous pouvez aussi le modifier, par exemple avec un curseur.
spotify_track_duration- La durée du titre en cours en secondes.
spotify_current_position- La progression du titre en secondes. Vous pouvez aussi la modifier pour vous déplacer dans le titre.
spotify_progress_percentage- La progression du titre en pourcentage.
spotify_album_art_url- L'adresse de la pochette en cours dans Macro Deck.
spotify_device_name- Le nom de l'appareil qui joue.
spotify_device_type- Le type de l'appareil qui joue, par exemple un ordinateur ou une enceinte.
spotify_shuffle_enabled- Indique si la lecture aléatoire est activée.
spotify_repeat_mode- Le mode de répétition :
off,trackoucontext. spotify_is_connected- Indique si Macro Deck joint Spotify et dispose d'une session utilisable.
spotify_current_track_url- Le lien Spotify du titre en cours.
spotify_current_track_is_liked- Indique si le titre en cours fait partie de vos Titres likés.
spotify_top_track,spotify_top_artist- Votre titre et votre artiste les plus écoutés.
spotify_top_tracks,spotify_top_artists- Vos titres et artistes les plus écoutés sous forme de liste.
Widgets1
Ajoutez-les à votre deck depuis le sélecteur de widgets.
- Lecteur de musique
- Affiche le titre, les artistes et la pochette de ce que joue Spotify, avec la progression et des boutons lecture, pause et passer.
Questions fréquentes
Pourquoi ai-je besoin de Spotify Premium ?
Spotify ne laisse que les comptes Premium piloter la lecture via sa Web API. Avec un compte gratuit, Spotify refuse les commandes, et Macro Deck affiche le problème Spotify Premium requis sur la page Spotify sous Intégrations. C'est une limite de Spotify, pas de Macro Deck.
Pourquoi dois-je créer ma propre application Spotify ?
Macro Deck communique avec Spotify grâce à l'ID client et à la clé secrète client d'une application qui vous appartient. Spotify compte les requêtes par application : votre deck ne partage donc pas sa limite avec d'autres utilisateurs. Créer l'application est gratuit et prend une minute dans le Spotify Developer Dashboard.
Spotify doit-il tourner sur le même ordinateur que Macro Deck ?
Non. Macro Deck pilote votre compte via Internet : il pilote donc Spotify sur tout appareil qui joue pour ce compte, comme votre téléphone ou une enceinte Spotify Connect. Avec Play on Device et Transfer Playback, vous choisissez l'appareil.
Puis-je connecter plusieurs comptes Spotify ?
Non. L'intégration prend en charge une seule configuration. Reconfigurer la remplace par un autre compte, et vos boutons et widgets continuent de fonctionner.
Macro Deck indique que Spotify limite ses requêtes. Que faire ?
Spotify cesse de répondre quand trop de requêtes sont faites avec les identifiants de votre application. Macro Deck met ses requêtes en pause et vous indique quand il reprend. La limite compte chaque application qui utilise le même ID client : fermer les autres applications qui l'utilisent aide généralement.
Où mes identifiants Spotify sont-ils stockés ?
La clé secrète client et les jetons fournis par Spotify sont stockés chiffrés sur l'ordinateur qui exécute Macro Deck. Ils ne sont envoyés qu'à Spotify. Votre mot de passe Spotify n'est jamais saisi dans Macro Deck ; vous vous connectez sur le site de Spotify.
Plus dans Musique et audio
YouTube Music Desktop App
Incluse avec Macro DeckPilotez YouTube Music Desktop App depuis votre deck : lecture, volume, notes et ce qui est en lecture.
WebNowPlaying
Incluse avec Macro DeckPilotez la musique et les vidéos lues dans votre navigateur et affichez ce qui est en lecture, grâce à l'extension WebNowPlaying.
Jellyfin
Incluse avec Macro DeckPilotez les applications et téléviseurs Jellyfin depuis votre deck, affichez ce qui est en lecture et réagissez au début ou à la fin de la lecture.
SoundPad
Incluse avec Macro DeckJouez des sons de votre liste SoundPad, pilotez les enregistrements et affichez le son en cours sur votre deck.
Voicemeeter
Incluse avec Macro DeckPilotez le gain, la sourdine, le routage et les boutons macro de Voicemeeter, Banana ou Potato depuis votre deck.