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.
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 Jellyfin no cabeçalho
- Controle a reprodução e o volume em apps, navegadores e TVs com Jellyfin
- Procure um filme, episódio, música ou álbum e inicie a reprodução
- Gatilhos quando a reprodução começa, pausa, é retomada ou para
- Widgets Reprodutor de música e Sessões do Jellyfin
- Conecte vários servidores, cada um com variáveis próprias
A integração Jellyfin conecta o Macro Deck a um ou mais servidores de mídia Jellyfin e trabalha com as sessões deles: os apps, navegadores e TVs com Jellyfin que estão conectados e reproduzindo. Ela não precisa de plugin no Jellyfin. O login é feito com uma chave de API, que permite ao Macro Deck ver e controlar todas as sessões do servidor, ou com nome de usuário e senha, o que o limita às sessões que essa conta pode controlar.
O que dá para fazer
- Reproduza, pause, pare, pule, vá para uma posição ou avance e retroceda alguns segundos.
- Defina o volume, silencie e reative o som e configure a reprodução aleatória e a repetição em um cliente.
- Procure no servidor um filme, episódio, música ou álbum e inicie em um dispositivo com Reproduzir mídia.
- Mostre uma mensagem com título em um cliente Jellyfin.
- Mostre o que está tocando no widget Reprodutor de música, ou a reprodução nos seus servidores no widget Sessões do Jellyfin.
- Inicie uma automação quando a reprodução começa, pausa, é retomada ou para, quando o item muda ou quando um cliente se conecta.
Alguns exemplos de uso:
- Um botão Toggle Play/Pause para a TV da sala, com Retroceder ao lado para repetir os últimos 10 segundos.
- Uma automação em Reprodução iniciada para a sua TV que diminui as luzes quando
{{ event.itemType }}éMovie, e outra em Reprodução parada que as aumenta de novo. - Um botão que mostra "O jantar está pronto" na TV com Mostrar mensagem.
Servidores e dispositivos
Cada servidor adicionado aparece de duas formas onde quer que se escolha um reprodutor. O nome do servidor acompanha a sessão que reproduziu algo por último. Servidor · Dispositivo, por exemplo Home · Living Room TV, sempre controla esse dispositivo e aparece como não conectado enquanto o dispositivo estiver desligado. O Macro Deck se lembra dos dispositivos por 30 dias depois da última vez que os viu.
O Macro Deck acompanha um servidor ao vivo pelo WebSocket dele no Jellyfin 10.11 e posteriores. Quando um servidor não envia atualizações ao vivo, o Macro Deck pede as sessões a cada dois segundos. Quando um servidor some, o Macro Deck continua tentando em segundo plano e avisa na página do Jellyfin em Integrações depois de algumas tentativas malsucedidas. Nem todo cliente Jellyfin aceita todos os comandos: um comando que o cliente não consegue executar falha com uma mensagem.
O que é necessário
- Um servidor Jellyfin que o computador com o Macro Deck consiga alcançar pela rede.
- Uma chave de API do painel do Jellyfin (recomendado), ou um nome de usuário e senha do Jellyfin.
- Jellyfin 10.11 ou posterior para atualizações ao vivo. Sem elas, o Macro Deck pede as sessões a cada dois segundos.
Configuração
Passo 1: Crie uma chave de API no Jellyfin
Abra o painel do Jellyfin e vá para Chaves de API. Crie uma nova chave e copie-a. Se preferir fazer login com uma conta de usuário, pule este passo.
Passo 2: Adicione uma configuração no Macro Deck
No Macro Deck, clique em Integrações na barra lateral e depois em Jellyfin. Na aba Visão geral, clique em Adicionar configuração 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.
Passo 3: Informe os dados do servidor
Na caixa de diálogo Conectar ao Jellyfin, preencha:
- Nome da configuração: um nome para este servidor, por exemplo
Home. Ele é usado nos nomes dos reprodutores e nas variáveis. - Endereço do servidor: o endereço com a porta e o caminho base, se houver, por exemplo
http://192.168.1.10:8096. - Entrar com: Chave de API ou Nome de usuário e senha, depois informe a Chave de API, ou o Nome de usuário e a Senha.
Clique em Continuar. O Macro Deck testa a conexão antes de salvar.
- Nome da configuração: um nome para este servidor, por exemplo
Passo 4: Confira a conexão
A nova configuração mostra Conectado na seção Configuração da página do Jellyfin. Repita os passos para cada servidor adicional.
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 Jellyfin à esquerda da caixa de diálogo Adicionar ação e escolha uma ação como Toggle Play/Pause. Escolha o servidor ou o dispositivo que ela controla e clique em Salvar.
Passo 6: Pressione o botão
Comece a reproduzir algo no cliente Jellyfin e pressione o botão no seu deck. A reprodução pausa ou é retomada nesse cliente.
Ações20
Coloque estas ações em um botão ou execute-as a partir de um fluxo.
- Play
- Retoma a reprodução no cliente.
- Pause
- Pausa a reprodução no cliente.
- Toggle Play/Pause
- Alterna entre reproduzir e pausar e mostra o estado da reprodução no botão.
- Parar
- Para a reprodução no cliente.
- Next Track
- Pula para o próximo item.
- Previous Track
- Volta para o item anterior.
- Refresh State
- Lê na hora o estado atual da reprodução.
- Seek
- Vai para uma posição do item atual, em segundos.
- Avançar
- Avança no item atual, 30 segundos por padrão.
- Retroceder
- Retrocede no item atual, 10 segundos por padrão.
- Set Volume
- Define o volume do cliente, de 0 a 100%.
- Volume Up
- Aumenta o volume em 10%.
- Volume Down
- Diminui o volume em 10%.
- Silenciar
- Silencia o cliente.
- Reativar som
- Liga de novo o som do cliente.
- Alternar silenciamento
- Silencia o cliente ou reativa o som dele.
- Toggle Shuffle
- Ativa, desativa ou alterna a reprodução aleatória.
- Set Repeat Mode
- Define a repetição como Off, Repeat Track ou Repeat Album/Playlist.
- Mostrar mensagem
- Mostra no cliente uma mensagem com título por alguns segundos.
- Reproduzir mídia
- Procura um filme, episódio, música ou álbum e o inicia no cliente, substituindo o que está tocando lá.
Gatilhos9
Um botão ou fluxo pode reagir a estes eventos.
- Reprodução iniciada
- Uma sessão começou a reproduzir algo.
- Reprodução pausada
- A reprodução foi pausada em uma sessão.
- Reprodução retomada
- A reprodução pausada continuou em uma sessão.
- Reprodução parada
- Uma sessão parou de reproduzir.
- Item em reprodução alterado
- Uma sessão passou para outro filme, episódio ou faixa.
- Sessão conectada
- Um cliente Jellyfin abriu uma sessão no servidor.
- Sessão desconectada
- O servidor encerrou a sessão de um cliente.
- Conectado
- O Macro Deck se conectou ao servidor.
- Desconectado
- O Macro Deck perdeu a conexão com o servidor.
Variáveis7
Mostre estes valores em botões e widgets ou use-os em condições.
jellyfin_active_sessions- Sessões reproduzindo ou pausadas em todos os servidores juntos.
jellyfin_<server>_is_connected,jellyfin_<server>_active_sessions- Se o Macro Deck alcança cada servidor e quantas sessões estão reproduzindo nele.
jellyfin_<server>_<device>_is_playing,jellyfin_<server>_<device>_is_paused,jellyfin_<server>_<device>_is_active- Se algo está tocando, pausado ou carregado no dispositivo. Gravar na variável de reprodução ou de pausa reproduz ou pausa.
jellyfin_<server>_<device>_title,jellyfin_<server>_<device>_series,jellyfin_<server>_<device>_album,jellyfin_<server>_<device>_media_type- O título, a série, o álbum (ou temporada) e o tipo de mídia do item em cada dispositivo.
jellyfin_<server>_<device>_position,jellyfin_<server>_<device>_duration,jellyfin_<server>_<device>_progress_percent- A posição e a duração em segundos e o progresso em porcentagem. Gravar na posição ou no progresso salta para esse ponto.
jellyfin_<server>_<device>_user,jellyfin_<server>_<device>_client,jellyfin_<server>_<device>_device,jellyfin_<server>_<device>_is_transcoding- O usuário, o cliente e o dispositivo de cada sessão, e se o servidor converte a mídia.
jellyfin_<server>_<device>_volume,jellyfin_<server>_<device>_is_muted- O volume e o estado de silenciamento de cada dispositivo, quando ele os informa. Gravar neles define o volume ou silencia.
Widgets2
Adicione estes widgets ao seu deck pelo seletor de widgets.
- Reprodutor de música
- Mostra o que está tocando em um servidor ou dispositivo, com capa, progresso e botões de reproduzir, pausar e pular. As linhas se adaptam a músicas, episódios e filmes.
- Sessões do Jellyfin
- Mostra o que está tocando em um ou em todos os seus servidores, com capa ou pôster, quem está reproduzindo, em qual dispositivo e em que ponto está.
Perguntas frequentes
Devo usar uma chave de API ou nome de usuário e senha?
Recomenda-se uma chave de API: assim o Macro Deck vê e controla todas as sessões do servidor. Com nome de usuário e senha, ele só vê as sessões que essa conta pode controlar. A senha é usada uma vez para o login e não é armazenada; o Macro Deck guarda só o token de acesso que o Jellyfin fornece.
Posso conectar mais de um servidor?
Sim. Adicione uma configuração por servidor. Cada uma tem variáveis próprias, com o nome da configuração, e mostra se está conectada.
Por que um comando falha na minha TV ou no navegador?
Nem todo cliente Jellyfin aceita todos os comandos. O Macro Deck só envia o que o cliente informa que consegue fazer, então um comando que ele não consegue executar falha com uma mensagem. Volume e silenciamento normalmente só funcionam nos apps do Jellyfin, não em uma aba do navegador.
O que acontece quando o servidor está offline?
O Macro Deck continua tentando em segundo plano e mostra o problema Servidor Jellyfin inacessível na página do Jellyfin em Integrações depois de algumas tentativas malsucedidas. As ações para esse servidor falham com uma mensagem até que ele volte.
Devo usar os gatilhos do Jellyfin ou os do Reprodutor de música?
Os gatilhos do Reprodutor de música, como Reprodução iniciada em Reprodutor de música, também disparam para o Jellyfin, uma vez para o servidor e uma vez para o dispositivo. Para automações, os gatilhos do Jellyfin são a melhor escolha: disparam uma vez por dispositivo e trazem o usuário e o tipo de mídia.
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.
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.
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.
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.