YouTube Music Desktop App
Incluse avec Macro DeckPilotez YouTube Music Desktop App depuis votre deck : lecture, volume, notes et ce qui est en lecture.
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 YouTube Music Desktop App dans l'en-tête
- Lecture, pause, passer, position, lecture aléatoire, répétition et volume
- Mettez un j'aime ou un je n'aime pas au morceau en cours, ou retirez sa note
- Lancez une vidéo ou une playlist depuis un lien ou un identifiant
- Mises à jour en direct via le Companion Server de l'application
- Widget Lecteur de musique et variables pour le morceau, l'artiste et la progression
L'intégration YouTube Music Desktop App relie Macro Deck à YouTube Music Desktop App (YTMDesktop), l'application de bureau pour YouTube Music. Elle utilise le Companion Server de l'application, intégré à partir de la version 2.0.6. Vous autorisez Macro Deck une fois dans l'application, puis il s'y connecte tout seul dès qu'elle tourne.
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.
- Couper ou rétablir le son de l'application.
- Mettre un j'aime ou un je n'aime pas au morceau en cours, retirer sa note, ou activer et désactiver un j'aime ou un je n'aime pas.
- Lancer un morceau de la file d'attente actuelle ou de l'une de vos playlists, ou en choisir un au moment d'appuyer sur le bouton.
- Lancer une vidéo ou une playlist précise depuis un lien YouTube Music, un lien youtu.be, un identifiant de vidéo ou un identifiant de playlist.
- Afficher ce qui est en lecture dans le widget Lecteur de musique, avec la pochette, la progression et des boutons lecture et passer.
- Réagir avec un flux quand un morceau reçoit un j'aime, un je n'aime pas ou que sa note est retirée.
Quelques exemples de configuration :
- Un bouton Toggle Play/Pause qui indique si la musique est en lecture ou en pause.
- Un bouton j'aime avec Noter le morceau en mode Basculer Aimer, dont le libellé est lié à
ytmdesktop_like_status. - Un bouton avec Lire une vidéo ou une URL qui lance votre playlist de concentration depuis son lien YouTube Music.
- Un curseur lié à
ytmdesktop_volumequi suit le volume de l'application et le modifie pendant que vous le faites glisser.
Fonctionnement
Macro Deck garde une connexion en direct avec le Companion Server : les changements faits dans l'application apparaissent donc immédiatement sur votre deck. Quand l'application se ferme, Macro Deck réessaie au bout de 5 secondes et attend plus longtemps après chaque échec, jusqu'à une minute. La variable ytmdesktop_is_connected indique si l'application est joignable. Si l'accès est retiré dans l'application, le problème YouTube Music Desktop App a rejeté l'autorisation sur la page de l'intégration vous demande de relancer la configuration. Par défaut, Macro Deck cherche l'application sur le même ordinateur. Sous Configuration avancée, lors de la configuration, vous pouvez saisir l'adresse d'un autre ordinateur. Vous ne pouvez configurer qu'une seule instance de YouTube Music Desktop App.
Ce qu'il vous faut
- YouTube Music Desktop App 2.0.6 ou plus récent. La version 1 n'a pas de Companion Server.
- Le Companion Server activé dans l'application sous Settings > Integrations.
- Companion Authorization activé pendant la configuration de Macro Deck.
Configuration
Étape 1: Installez YouTube Music Desktop App
Installez YouTube Music Desktop App 2.0.6 ou plus récent et lancez-le. La boîte de dialogue de configuration de Macro Deck renvoie vers la page des versions de l'application.
Étape 2: Activez le Companion Server
Dans YouTube Music Desktop App, allez dans Settings > Integrations. Activez Companion Server et Companion Authorization. L'application désactive d'elle-même l'autorisation une fois que vous avez autorisé Macro Deck.
Étape 3: Lancez la configuration dans Macro Deck
Dans Macro Deck, cliquez sur Intégrations dans la barre latérale, puis sur YouTube Music Desktop App. 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 Activer le Companion Server n'a aucun champ à remplir. Si l'application tourne sur un autre ordinateur, activez Configuration avancée et saisissez son Adresse. Laissez le Port sur
9863. Cliquez sur Continuer.Étape 4: Autorisez Macro Deck dans l'application
La boîte de dialogue affiche maintenant Autoriser Macro Deck avec un Code d'autorisation. Cliquez sur Continuer : une fenêtre d'approbation s'ouvre dans YouTube Music Desktop App avec Macro Deck et un code. Vérifiez que les codes correspondent et cliquez sur Allow dans les 30 secondes. Quand la boîte de dialogue de Macro Deck affiche Configuration terminée., cliquez sur Terminé.
Étape 5: 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 YouTube Music Desktop App à gauche de la boîte de dialogue Ajouter une action et choisissez une action comme Toggle Play/Pause ou Noter le morceau. Cliquez ensuite sur Enregistrer.
Étape 6: Appuyez sur le bouton
Lancez un morceau dans YouTube Music Desktop App et appuyez sur le bouton de votre deck. La lecture se met en pause ou reprend.
Actions17
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 morceau suivant.
- Previous Track
- Revient au morceau précédent.
- Refresh State
- Lit immédiatement l'état de lecture actuel.
- Set Volume
- Règle le volume de l'application, de 0 à 100 %.
- Volume Up
- Augmente le volume de 10 %.
- Volume Down
- Baisse le volume de 10 %.
- Seek
- Va à une position du morceau 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 morceau de la file d'attente actuelle, ou vous demande d'en choisir un à l'exécution de l'action.
- Play Playlist
- Lance l'une de vos playlists, ou vous demande d'en choisir une à l'exécution de l'action.
- Noter le morceau
- Met un j'aime ou un je n'aime pas au morceau en cours ou retire sa note, ou active et désactive un j'aime ou un je n'aime pas.
- Muet
- Coupe, rétablit ou bascule le son de l'application.
- Lire une vidéo ou une URL
- Lance une vidéo ou une playlist depuis un lien YouTube Music, un lien youtu.be, un identifiant de vidéo ou un identifiant de playlist.
Déclencheurs8
Un bouton ou un flux peut réagir à ces événements.
- Note modifiée
- Le morceau en cours a reçu un j'aime, un je n'aime pas ou sa note a été retirée, éventuellement pour une seule note.
- Piste changée
- Un autre morceau 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).
- Volume changé
- Le volume a changé, avec la nouvelle et l'ancienne valeur (sous Music Player).
- Lecteur connecté
- L'application est devenue joignable (sous Music Player).
- Lecteur déconnecté
- L'application n'est plus joignable (sous Music Player).
Variables21
Affichez ces valeurs sur des boutons et des widgets, ou utilisez-les dans des conditions.
ytmdesktop_is_connected- Indique si Macro Deck est connecté à l'application.
ytmdesktop_current_track_name- Le titre du morceau en cours.
ytmdesktop_current_artist- L'artiste du morceau en cours.
ytmdesktop_current_album- L'album du morceau en cours.
ytmdesktop_album_art_url- L'adresse de la pochette en cours dans Macro Deck.
ytmdesktop_playback_state- L'état de lecture :
playing,pausedoustopped. ytmdesktop_is_playing- Indique si de la musique joue en ce moment.
ytmdesktop_current_position- La progression du morceau en secondes. Vous pouvez aussi la modifier pour vous déplacer dans le morceau.
ytmdesktop_track_duration- La durée du morceau en cours en secondes.
ytmdesktop_progress_percentage- La progression du morceau en pourcentage.
ytmdesktop_volume- Le volume de l'application en pourcentage. Vous pouvez aussi le modifier, par exemple avec un curseur.
ytmdesktop_is_muted- Indique si le son de l'application est coupé.
ytmdesktop_like_status- La note du morceau en cours :
like,dislikeouindifferent. ytmdesktop_is_liked- Indique si le morceau en cours a reçu un j'aime.
ytmdesktop_shuffle_enabled- Indique si la lecture aléatoire est activée.
ytmdesktop_repeat_mode- Le mode de répétition :
off,trackoucontext. ytmdesktop_is_live- Indique si l'élément en cours est un direct.
ytmdesktop_media_type- Le type de l'élément en cours :
audio,video,uploadedoupodcast. ytmdesktop_ad_playing- Indique si une publicité est en cours de lecture.
ytmdesktop_video_id- L'identifiant YouTube du morceau en cours.
ytmdesktop_device_name- Le nom affiché comme source de la lecture.
Widgets1
Ajoutez-les à votre deck depuis le sélecteur de widgets.
- Lecteur de musique
- Affiche le morceau, l'artiste et la pochette de ce que joue YouTube Music Desktop App, avec la progression et des boutons lecture, pause et passer.
Questions fréquentes
Cela fonctionne-t-il avec YouTube Music dans un navigateur ?
Non. Cette intégration ne communique qu'avec YouTube Music Desktop App. Pour YouTube Music dans un onglet de navigateur, utilisez l'intégration WebNowPlaying avec son extension de navigateur.
Macro Deck peut-il piloter l'application sur un autre ordinateur ?
Oui. Lors de la configuration, activez Configuration avancée et saisissez l'Adresse de l'ordinateur qui exécute YouTube Music Desktop App.
La configuration indique qu'elle n'a pas pu joindre l'application. Que faire ?
Vérifiez que YouTube Music Desktop App est lancé, qu'il s'agit de la version 2.0.6 ou plus récente, et que Companion Server est activé sous Settings > Integrations. Appuyez ensuite de nouveau sur Continuer.
Pourquoi la configuration me demande-t-elle de réactiver Companion Authorization ?
L'application n'accepte de nouvelles demandes d'autorisation que tant que Companion Authorization est activé, et le désactive d'elle-même une fois que vous avez autorisé une application. Activez-le, appuyez sur Continuer et cliquez sur Allow dans les 30 secondes.
Que se passe-t-il quand je ferme l'application ?
La variable ytmdesktop_is_connected vaut false, le widget Lecteur de musique indique que YouTube Music n'est pas lancé, et les actions échouent avec le message indiquant que l'application n'est pas connectée. Quand vous relancez l'application, Macro Deck se reconnecte tout seul en moins d'une minute.
Plus dans Musique et audio
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.
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.