Mobile MA

Perguntas frequentes e solução de problemas

Perguntas gerais

O Mobile MA é o app oficial do Music Assistant?
Não. O Mobile MA é um projeto independente de Sven Hanold e não é afiliado ao projeto Music Assistant nem à Open Home Foundation; não é desenvolvido, endossado nem revisado por eles. O app usa a interface aberta do seu próprio servidor Music Assistant. O app oficial e todas as informações sobre o projeto estão em music-assistant.io.
O que eu preciso para usar o Mobile MA?
Um servidor Music Assistant auto-hospedado (versão 2.9 ou posterior) que o seu iPhone consiga alcançar. O Mobile MA é um cliente independente — o servidor roda do seu lado, por exemplo, como um add-on do Home Assistant ou um contêiner Docker.
Por que o Mobile MA, se já existe um app oficial?
O app oficial do Music Assistant é open source, gratuito e feito para Android e iOS. O Mobile MA é um cliente independente e não oficial só para aparelhos Apple, disponível na App Store. A diferença: Apple Watch, Apple TV, Mac, widgets da tela de início e atalhos da Siri com cômodo de destino, que o app oficial ainda não inclui; CarPlay para cada player da casa, com fila incluída, e cenas multiroom salvas – duas áreas que o projeto exclui expressamente para o seu app. Além disso, perfis de conexão, configuração guiada com busca do servidor e um app em dez idiomas. As funções básicas são gratuitas; o resto é uma compra única, sem assinatura. Os dois apps usam o mesmo servidor e funcionam em paralelo. (Atualizado em: 30 de outubro de 2026)
O que é o Mobile MA Unlimited?
Uma compra única (sem assinatura) que libera todos os recursos premium — entre eles, CarPlay, Smart Playlists e transferência de fila. No primeiro toque em um recurso premium, você pode iniciar um período de teste gratuito de 7 dias – sem pagamento, sem renovação automática; depois você decide sobre a compra única.
O Mobile MA funciona com o CarPlay?
Sim — com o Mobile MA Unlimited, a biblioteca completa fica disponível no carro: álbuns, playlists, podcasts, rádio e favoritos, incluindo as capas dos álbuns.
Existe Mobile MA para Mac?
Sim — desde a versão 3.9 como app próprio na Mac App Store, com barra lateral, atalhos de teclado, widgets e um player na barra de menus. Requer macOS 26 ou posterior. Sua compra do Unlimited também vale no Mac; sem o Unlimited, você controla um player por lá.
Dados são enviados para o desenvolvedor?
Sua música, seu servidor e suas credenciais: não — o app só fala com o seu próprio servidor. A única exceção são estatísticas de uso anônimas (eventos sobre configuração, conexão, período de teste, compra e dicas exibidas, sem endereço IP ou ID do aparelho – a lista completa está na política de privacidade), que você pode desativar a qualquer momento em Ajustes, em “Privacidade”. Os detalhes estão na política de privacidade.

Solução de problemas

A música trava ou tem falhas
Aumente o buffer de reprodução em Ajustes — isso compensa áreas sem sinal e Wi-Fi instável. Um buffer maior vale a pena principalmente ao transmitir via dados móveis.
Quero acessar meu servidor quando estiver fora de casa
Configure o acesso remoto por WebRTC em Ajustes — assim você alcança seu Music Assistant também fora da rede local, sem liberação de porta ou VPN. Porém, há uma limitação com dados móveis, veja o próximo item.
O acesso remoto funciona no Wi-Fi, mas não nos dados móveis
Operadoras de celular costumam bloquear conexões WebRTC diretas. Para que a conexão aconteça mesmo assim, o servidor Music Assistant precisa de um relay TURN — e o Music Assistant só disponibiliza isso com uma assinatura do Home Assistant Cloud (Nabu Casa), porque é ali que ficam os custos do tráfego de dados repassado. Sem essa assinatura, o acesso remoto só funciona na sua própria rede, por VPN ou por meio de um servidor acessível de fora. Essa é uma característica do servidor, não do app — veja a resposta da equipe do Music Assistant.
Um player está faltando na lista
Primeiro, verifique se o player está ativo e disponível no próprio servidor Music Assistant. No app, o pull-to-refresh ajuda; depois de trocas de rede, o Mobile MA se reconecta automaticamente.
A reprodução local para ao trocar entre Wi-Fi e dados móveis
Isso foi corrigido desde a versão 2.0 — atualize o app para a versão mais recente.
O widget não atualiza
Verifique se a versão mais recente do app está instalada (muito mais confiável desde a 2.3) e se a atualização em segundo plano está permitida para o Mobile MA nos Ajustes do iOS.

Ir para o suporte →