YouTube Music Desktop App
Incluída no Macro DeckControle o YouTube Music Desktop App pelo seu deck: reprodução, volume, avaliações e o que está tocando.
Dois widgets Reprodutor de música tocando uma faixa, um no estilo Capa completa e outro no estilo Capa pequena, ambos com o nome e o logotipo do YouTube Music Desktop App no cabeçalho
- Reproduzir, pausar, pular, mudar a posição, aleatório, repetição e volume
- Marque gostei, não gostei ou limpe a avaliação da faixa atual
- Inicie um vídeo ou playlist a partir de um link ou de um ID
- Atualizações ao vivo pelo Companion Server do app
- Widget Reprodutor de música e variáveis para faixa, artista e progresso
A integração YouTube Music Desktop App conecta o Macro Deck ao YouTube Music Desktop App (YTMDesktop), o app de desktop para o YouTube Music. Ela usa o Companion Server do app, que vem embutido a partir da versão 2.0.6. Você permite o Macro Deck uma vez no app e, a partir daí, ele se conecta sozinho sempre que o app estiver aberto.
O que dá para fazer
- Reproduza, pause, pule, mude a posição, ative ou desative a reprodução aleatória, defina o modo de repetição e mude o volume.
- Silencie ou reative o som do app.
- Marque gostei ou não gostei na faixa atual, limpe a avaliação ou alterne gostei e não gostei.
- Inicie uma faixa da fila atual ou de uma das suas playlists, ou escolha uma ao pressionar o botão.
- Inicie um vídeo ou uma playlist específica a partir de um link do YouTube Music, de um link youtu.be, de um ID de vídeo ou de um ID de playlist.
- Mostre o que está tocando no widget Reprodutor de música, com a capa, o progresso e botões de reproduzir e pular.
- Reaja com um fluxo quando uma faixa recebe gostei, não gostei ou tem a avaliação limpa.
Alguns exemplos de uso:
- Um botão Toggle Play/Pause que mostra se a música está tocando ou pausada.
- Um botão de gostei com Avaliar faixa no modo Alternar gostei, com o rótulo vinculado a
ytmdesktop_like_status. - Um botão com Reproduzir vídeo ou URL que inicia a sua playlist de concentração pelo link do YouTube Music.
- Um controle deslizante vinculado a
ytmdesktop_volumeque acompanha o volume do app e o muda enquanto você arrasta.
Como funciona
O Macro Deck mantém uma conexão ao vivo com o Companion Server, então as mudanças feitas no app aparecem no deck na hora. Quando o app é fechado, o Macro Deck tenta de novo após 5 segundos e espera mais a cada tentativa malsucedida, até um minuto. A variável ytmdesktop_is_connected mostra se o app está acessível. Se o acesso for removido no app, o problema O YouTube Music Desktop App rejeitou a autorização na página da integração pede para você executar a configuração de novo. Por padrão, o Macro Deck procura o app no mesmo computador. Em Configuração avançada na configuração, é possível informar o endereço de outro computador. É possível configurar um YouTube Music Desktop App.
O que é necessário
- YouTube Music Desktop App 2.0.6 ou mais recente. A versão 1 não tem Companion Server.
- Companion Server ativado no app em Settings > Integrations.
- Companion Authorization ativado enquanto você configura o Macro Deck.
Configuração
Passo 1: Instale o YouTube Music Desktop App
Instale o YouTube Music Desktop App 2.0.6 ou mais recente e abra-o. A caixa de diálogo de configuração do Macro Deck tem um link para a página de versões do app.
Passo 2: Ative o Companion Server
No YouTube Music Desktop App, vá para Settings > Integrations. Ative Companion Server e Companion Authorization. O app desativa a autorização sozinho depois que você permite o Macro Deck.
Passo 3: Comece a configuração no Macro Deck
No Macro Deck, clique em Integrações na barra lateral e depois em YouTube Music Desktop App. Na aba Visão geral, clique em Configurar na seção Configuração. Ativar a chave no canto superior direito abre a mesma caixa de diálogo, e a integração fica ativada assim que a configuração é concluída. A caixa de diálogo Ative o Companion Server não tem campos para preencher. Se o app rodar em outro computador, ative Configuração avançada e informe o Endereço dele. Deixe a Porta em
9863. Clique em Continuar.Passo 4: Permita o Macro Deck no app
A caixa de diálogo agora mostra Permitir o Macro Deck com um Código de autorização. Clique em Continuar: uma janela de aprovação abre no YouTube Music Desktop App com o Macro Deck e um código. Confira se os códigos são iguais e clique em Allow em até 30 segundos. Quando a caixa de diálogo no Macro Deck mostrar Configuração concluída., clique em Concluído.
Passo 5: Adicione uma ação a um botão
Na página Deck, clique no botão que você quer usar. O deck precisa estar desbloqueado: se o botão no canto superior direito mostra Bloquear, ele está desbloqueado. O editor abre com Toque curto selecionado. Clique em + Adicionar ação, selecione YouTube Music Desktop App à esquerda da caixa de diálogo Adicionar ação e escolha uma ação como Toggle Play/Pause ou Avaliar faixa. Depois clique em Salvar.
Passo 6: Pressione o botão
Comece a tocar uma música no YouTube Music Desktop App e pressione o botão no seu deck. A reprodução pausa ou é retomada.
Ações17
Coloque estas ações em um botão ou execute-as a partir de um fluxo.
- Play
- Retoma a reprodução.
- Pause
- Pausa a reprodução.
- Toggle Play/Pause
- Alterna entre reproduzir e pausar e mostra o estado da reprodução no botão.
- Next Track
- Pula para a próxima faixa.
- Previous Track
- Volta para a faixa anterior.
- Refresh State
- Lê na hora o estado atual da reprodução.
- Set Volume
- Define o volume do app, de 0 a 100%.
- Volume Up
- Aumenta o volume em 10%.
- Volume Down
- Diminui o volume em 10%.
- Seek
- Vai para uma posição da faixa atual, em segundos.
- Toggle Shuffle
- Ativa, desativa ou alterna a reprodução aleatória e mostra se ela está ativada.
- Set Repeat Mode
- Define a repetição como Off, Repeat Track ou Repeat Album/Playlist.
- Play Track
- Toca uma faixa da fila atual, ou pede para escolher uma quando a ação é executada.
- Play Playlist
- Toca uma das suas playlists, ou pede para escolher uma quando a ação é executada.
- Avaliar faixa
- Marca gostei ou não gostei na faixa atual ou limpa a avaliação, ou alterna gostei e não gostei.
- Silenciar
- Silencia, reativa ou alterna o silenciamento do app.
- Reproduzir vídeo ou URL
- Inicia um vídeo ou uma playlist a partir de um link do YouTube Music, de um link youtu.be, de um ID de vídeo ou de um ID de playlist.
Gatilhos8
Um botão ou fluxo pode reagir a estes eventos.
- Avaliação alterada
- A faixa atual recebeu gostei ou não gostei, ou teve a avaliação limpa, opcionalmente só para uma avaliação.
- Faixa alterada
- Outra faixa começou a tocar, com título, artista e álbum (em Reprodutor de música).
- Reprodução iniciada
- A reprodução começou ou foi retomada (em Reprodutor de música).
- Reprodução pausada
- A reprodução foi pausada (em Reprodutor de música).
- Reprodução parada
- A reprodução parou (em Reprodutor de música).
- Volume alterado
- O volume mudou, com o valor novo e o anterior (em Reprodutor de música).
- Reprodutor conectado
- O app ficou acessível (em Reprodutor de música).
- Reprodutor desconectado
- O app não está mais acessível (em Reprodutor de música).
Variáveis21
Mostre estes valores em botões e widgets ou use-os em condições.
ytmdesktop_is_connected- Se o Macro Deck está conectado ao app.
ytmdesktop_current_track_name- O título da faixa atual.
ytmdesktop_current_artist- O artista da faixa atual.
ytmdesktop_current_album- O álbum da faixa atual.
ytmdesktop_album_art_url- O endereço da capa atual no Macro Deck.
ytmdesktop_playback_state- O estado da reprodução:
playing,pausedoustopped. ytmdesktop_is_playing- Se a música está tocando agora.
ytmdesktop_current_position- Quanto da faixa já tocou, em segundos. Também é possível defini-la para ir a outra posição.
ytmdesktop_track_duration- A duração da faixa atual em segundos.
ytmdesktop_progress_percentage- Quanto da faixa já tocou, em porcentagem.
ytmdesktop_volume- O volume do app em porcentagem. Também é possível defini-lo, por exemplo com um controle deslizante.
ytmdesktop_is_muted- Se o app está silenciado.
ytmdesktop_like_status- A avaliação da faixa atual:
like,dislikeouindifferent. ytmdesktop_is_liked- Se a faixa atual recebeu gostei.
ytmdesktop_shuffle_enabled- Se a reprodução aleatória está ativada.
ytmdesktop_repeat_mode- O modo de repetição:
off,trackoucontext. ytmdesktop_is_live- Se o item atual é uma transmissão ao vivo.
ytmdesktop_media_type- O tipo do item atual:
audio,video,uploadedoupodcast. ytmdesktop_ad_playing- Se um anúncio está tocando agora.
ytmdesktop_video_id- O ID do YouTube da faixa atual.
ytmdesktop_device_name- O nome mostrado como origem da reprodução.
Widgets1
Adicione estes widgets ao seu deck pelo seletor de widgets.
- Reprodutor de música
- Mostra a faixa, o artista e a capa do que o YouTube Music Desktop App está tocando, com progresso e botões de reproduzir, pausar e pular.
Perguntas frequentes
Funciona com o YouTube Music no navegador?
Não. Esta integração só se comunica com o YouTube Music Desktop App. Para o YouTube Music em uma aba do navegador, use a integração WebNowPlaying com a extensão de navegador dela.
O Macro Deck pode controlar o app em outro computador?
Sim. Durante a configuração, ative Configuração avançada e informe o Endereço do computador em que o YouTube Music Desktop App está rodando.
A configuração diz que não conseguiu alcançar o app. O que fazer?
Confira se o YouTube Music Desktop App está aberto, se é a versão 2.0.6 ou mais recente e se Companion Server está ativado em Settings > Integrations. Depois clique em Continuar de novo.
Por que a configuração pede para ativar o Companion Authorization de novo?
O app só aceita novas solicitações de autorização enquanto Companion Authorization está ativado, e o desativa sozinho depois que você permite um app. Ative-o, clique em Continuar e clique em Allow em até 30 segundos.
O que acontece quando eu fecho o app?
A variável ytmdesktop_is_connected fica false, o widget Reprodutor de música mostra que o YouTube Music não está aberto, e as ações falham com a mensagem de que o app não está conectado. Quando você abre o app de novo, o Macro Deck se reconecta sozinho em até um minuto.
Mais em Música e áudio
Spotify
Incluída no Macro DeckControle a reprodução do Spotify, curta músicas, gerencie playlists e mostre no deck o que está tocando.
WebNowPlaying
Incluída no Macro DeckControle músicas e vídeos que tocam no navegador e mostre o que está tocando, pela extensão WebNowPlaying.
Jellyfin
Incluída no Macro DeckControle apps e TVs com Jellyfin pelo seu deck, mostre o que está tocando e reaja quando a reprodução começa ou para.
SoundPad
Incluída no Macro DeckToque sons da sua lista do SoundPad, controle gravações e mostre no deck o som que está tocando.
Voicemeeter
Incluída no Macro DeckControle pelo seu deck o ganho, o silenciamento, o roteamento e os botões de macro do Voicemeeter, Banana ou Potato.