Central de ajuda

Seu som, seu espaço. O 4uMusic organiza vídeos musicais do YouTube em uma biblioteca pessoal.

Comece com um play

1. Escolha uma faixa da seleção inicial ou busque por música e artista. Pressione Enter para buscar.
2. Use “Colar link” para adicionar uma URL de vídeo do YouTube, YouTube Music ou youtu.be. Esse recurso funciona sem chave da Data API.
3. O vídeo aparece no painel de reprodução. Se o navegador bloquear o início automático, toque em play no vídeo.
4. Use o coração para favoritar e “Mais opções” para adicionar à fila ou a uma playlist.

O player permanece com os controles oficiais. A reprodução pausa ao ocultar o vídeo ou a aba. O vídeo e os controles ficam fixos na tela; role apenas a lista de músicas. No celular, use os atalhos de navegação para abrir busca, favoritas, biblioteca e fila sem tirar o vídeo da tela.

Playlists que acompanham você

Crie e renomeie playlists na biblioteca. Reordene por arraste ou pelos botões de seta; use o menu da faixa para adicionar músicas. “Exportar” salva um arquivo JSON com sua organização, sem arquivos de áudio. “Importar” une o arquivo à biblioteca existente. Compartilhar cria um link com o nome e as músicas da playlist; qualquer pessoa com o link poderá ler esses dados.

Sem login, os dados ficam neste navegador. Limpar os dados do site remove a biblioteca local. Nas instalações com Google ativado, entrar na conta permite sincronizar favoritas, playlists, histórico recente, preferências de sugestão, fila e ponto de retomada. O login do 4uMusic não conecta a sessão do player do YouTube.

Busca, álbuns e disponibilidade

A busca usa metadados oficiais da YouTube Data API v3. “Playlists e álbuns” procura playlists publicadas no YouTube; “Artistas e canais” procura canais e abre uma página com vídeos daquele canal. As playlists relacionadas podem conter álbuns, mas não são um catálogo oficial de álbuns. A lista carrega as primeiras 50 faixas e permite carregar as páginas seguintes com “Carregar mais músicas”. Não existe garantia de disponibilidade de todo o catálogo do YouTube Music.

Vídeos privados, removidos, com restrições de região, idade ou incorporação podem não tocar. Use “Abrir no YouTube”, escolha outra versão no menu ou avance na fila. Anúncios e eventual reconhecimento de Premium são administrados pelo YouTube, conforme a sessão e os cookies. O app não detecta assinaturas nem garante reprodução sem anúncios.

Sequência automática sem repetir

Ao escolher uma música, o 4uMusic prepara as próximas pelo artista ou gênero da busca. Favoritas e playlists tocam suas faixas em ordem aleatória antes de continuar com semelhantes. Na fila, você pode mudar a ordem, desligar “Continuar com semelhantes” ou “Recomeçar sessão”. Faixas já iniciadas não entram novamente na sequência automática dessa sessão; clicar manualmente em uma faixa ou voltar à anterior ainda permite ouvi-la novamente.

O histórico da sessão fica nesta aba, inclusive após recarregar. Títulos reconhecidos como versões da mesma música também são filtrados, mas metadados diferentes podem impedir esse reconhecimento. As sugestões vêm da busca do YouTube, sem garantia de gênero exato. Elas são carregadas em lotes, respeitam a cota e podem parar por falta de resultados, internet, vídeos disponíveis ou autorização de reprodução do navegador. Não há download ou extração de áudio.

Continuar ouvindo e organizar a fila

Ao reabrir a mesma aba, “Continue ouvindo” recupera a faixa, a fila e a posição aproximada; com Google conectado, esses dados também acompanham sua conta em outro dispositivo. A reprodução só começa quando você toca em Continuar. No menu da faixa, “Tocar a seguir” coloca a música imediatamente após a atual. A fila mostra qual será a próxima. Use o Temporizador para parar em 15, 30 ou 60 minutos ou ao fim da música.

A busca local mostra músicas da sua biblioteca enquanto você digita, além de pesquisas recentes. Nas favoritas e playlists, é possível filtrar, ordenar, selecionar várias faixas e desfazer uma remoção. As sugestões consideram as favoritas e músicas ouvidas recentemente; no início você pode escolher entre músicas mais parecidas, descoberta e variedade de artistas. “Não recomendar esta música” retira uma faixa das próximas sugestões.

Orientação do celular

O PWA solicita orientação vertical quando o navegador e o sistema permitem. Na aba comum, o navegador pode continuar girando; o app aguarda o layout estabilizar antes de verificar a visibilidade do vídeo. A preferência de orientação não é suportada em todos os dispositivos.

Manter a tela ligada

Toque no botão de sol “Manter tela ligada”, abaixo do vídeo. A opção evita o bloqueio automático enquanto a música toca e o app permanece visível. Ao pausar, terminar a fila ou sair da tela do app, a proteção é liberada. Sua preferência fica salva neste navegador; toque novamente para desativar.

O indicador “Tela ligada · ativa” confirma que o navegador aceitou a solicitação. Alguns aparelhos podem recusar ou liberar a proteção por economia de bateria. Se aparecer “bloqueada”, verifique esse ajuste e desative/ative a opção para tentar novamente. Navegadores sem suporte exibem “indisponível”. Isso não impede o bloqueio manual nem permite tocar com a tela apagada ou em outro aplicativo.

Instalar no celular e no computador

Abra o menu lateral e toque em “Instalar”. Quando o navegador disponibilizar a instalação, o app abre a confirmação oficial. Se ela não estiver disponível, o 4uMusic mostra as instruções do seu navegador: no Android ou computador, use o menu “Instalar aplicativo” ou “Adicionar à tela inicial”; no Safari do iPhone/iPad, use Compartilhar → Adicionar à Tela de Início. Ao abrir como PWA, o menu indica “Instalado”. O ícone verde 4uMusic identifica o aplicativo na tela inicial. A interface pode abrir offline após a primeira visita; busca, capas, login e reprodução precisam de internet. O app não baixa músicas e não oferece áudio em segundo plano.

Configuração para administradores

O pacote PHP contém a versão para servidor próprio. Publique apenas a pasta public/ como raiz web. Mantenha a chave e o banco fora dela, com acesso restrito ao usuário do PHP.

1. Ative YouTube Data API v3 no projeto Google Cloud.
2. Em APIs e serviços → Credenciais, abra uma chave dedicada ao 4uMusic. Em restrições de aplicativos, escolha Endereços IP e adicione o IP de saída do servidor; para a VPS de Fabiano, confirme 137.131.249.105. Restrinja a API a YouTube Data API v3. Não use restrição por referenciador HTTP para chamadas do backend.
3. Configure YOUTUBE_API_KEY no ambiente do PHP-FPM ou em um arquivo PHP fora da raiz pública. Use FOURUMUSIC_CONFIG para indicar o caminho desse arquivo. Há um modelo em private/config.example.php.
4. Para Google, habilite a origem HTTPS exata no cliente OAuth do tipo Web, configure GOOGLE_AUTH_ENABLED=true, GOOGLE_CLIENT_ID e APP_ORIGIN. O fluxo utiliza Google Identity Services e valida assinatura, destinatário, validade e nonce no backend.
5. Confira as cotas no Google Cloud. O backend PHP usa cache de uma hora, limite por IP e um teto local configurável de buscas por dia. Os limites locais não substituem as cotas do Google.

Uma chave com restrições de IP da VPS não funcionará na prévia hospedada em outro servidor. Não remova as restrições para contornar isso; instale o backend no servidor autorizado. A chave que passou pelo chat deve ser substituída na instalação final, inserindo a nova diretamente na configuração privada.

Abrir Credenciais no Google Cloud · Proteção de chaves