Music Player

Reprodutor de música pra sua biblioteca pessoal. Aquela coleção de FLACs, MP3 ripados do CD, podcasts baixados, gravações ao vivo que você acumulou ao longo de anos. Tudo num player que funciona em qualquer dispositivo logado — celular, tablet, notebook, Smart TV — com streaming direto do HD de casa, background playback (tela desligada continua tocando) e visualizador de espectro real.

Pense Spotify, mas com seus próprios arquivos e sem mensalidade.

---

Destaques

🎵

Playlists

Crie e organize playlists personalizadas com sincronização automática na nuvem.

📡

Streaming de Rede

Ouça músicas do HD de casa, de qualquer lugar do mundo.

📱

Background Playback

Continue ouvindo com a tela desligada no celular.

🌈

Visualizador

Animação em tempo real do espectro de frequências.

---

Adicionando Músicas

📁 Pelo Gerenciador de Arquivos

Localize um arquivo de áudio (.mp3, .wav, .ogg, .flac) no Gerenciador de Arquivos e dê um duplo clique. O Music Player abrirá automaticamente e começará a reproduzir.

🔗 Por URL

Cole a URL direta de um arquivo de áudio acessível pela internet. Útil para links diretos de hospedagem ou CDNs.

📂 Adicionar Pasta Inteira

Importe uma pasta inteira contendo múltiplos arquivos de áudio de uma só vez para a sua biblioteca.

💾 Do Disco de Rede Servidor

Navegue pelos discos mapeados do servidor e adicione pastas inteiras de músicas do seu HD.

▶️ Baixar do YouTube Servidor

Cole o link de um vídeo do YouTube e o áudio é baixado no seu RoqueOS Server e salvo na pasta de música compartilhada — depois é só tocar (e dá pra usar no modo Praticar também).

• O botão "Baixar do YouTube" aparece na barra lateral (e no drawer mobile) do Music Player quando o servidor conectado tem a extração de mídia ativada (ENABLE_MEDIA_EXTRACT=true).
• A música é extraída em m4a (yt-dlp + ffmpeg no servidor) e aparece como uma faixa normal — tocável, adicionável a playlists e à pasta Compartilhados do Finder.
• Baixar o mesmo vídeo de novo reutiliza o arquivo já salvo (não baixa duas vezes).
• Opt-in: quem liga a flag no servidor assume os Termos de Uso do YouTube. Desligado por padrão.

---

Streaming de Disco de Rede

🌟 Funcionalidade destaque! Ouça as músicas do seu HD de casa de qualquer lugar do mundo, como um serviço de streaming pessoal tipo Spotify — mas com a sua coleção de músicas.

Como Funciona?

1. Seus arquivos MP3 estão no HD do seu computador ou servidor
2. Esses arquivos são mapeados como volumes no RoqueOS Server
3. O Music Player acessa via streaming HTTP pelo servidor
4. Você ouve de qualquer dispositivo conectado à internet

Passo a Passo

1. Mapeie a pasta de músicas no docker-compose.yml:

services:
  roqueos-server:
    volumes:
      - ./data:/app/data
      - /var/run/docker.sock:/var/run/docker.sock
      - /home/usuario/Musicas:/app/disks/Musicas # ← Seu HD de músicas

2. Reinicie o servidor:

docker compose down && docker compose up -d

3. No RoqueOS, abra o Music Player e adicione a pasta de rede:

• Clique no botão de adicionar pasta
• Navegue até o disco Musicas no seletor de rede
• Selecione a pasta desejada e confirme
• Todas as músicas da pasta serão importadas para sua biblioteca

4. Pronto! Ouça de qualquer lugar.

Se estiver usando Cloudflare Tunnels para acesso externo, o streaming funciona de qualquer lugar do mundo com conexão à internet.

---

Reprodução em Segundo Plano (Background Playback)

📱 Funcionalidade essencial para mobile! O Music Player continua tocando mesmo quando você bloqueia a tela do celular ou troca de app.

Como funciona no celular?

O RoqueOS utiliza a Media Session API do navegador, que permite:

• Tela desligada — A música continua tocando normalmente
• Controles na tela de bloqueio — Play, pause, próxima e anterior aparecem na notificação do sistema
• Controles no fone — Botões do fone de ouvido Bluetooth funcionam normalmente
• Trocar de app — A música não para quando você abre outros aplicativos

Requisitos

• Usar o RoqueOS via PWA instalada ou app nativo (iOS/Android)
• O navegador Chrome, Safari ou Edge em versão recente
• No iOS, a PWA deve estar instalada na tela inicial para background playback funcionar

DICA

Para a melhor experiência de streaming no celular, instale o RoqueOS como PWA ou baixe o app nativo na App Store ou Microsoft Store.

---

Gerenciamento de Playlists

Criar uma Playlist

1. Na área de Playlists no painel lateral, clique em + Nova Playlist
2. Dê um nome para a playlist
3. Arraste músicas da biblioteca para a playlist, ou use o menu de contexto da música

Organizar

• Reordenar — Arraste músicas dentro da playlist para mudar a ordem
• Remover — Clique com botão direito em uma música e selecione "Remover da playlist"
• Renomear — Clique no nome da playlist para editá-lo
• Deletar — Remova a playlist inteira pelo menu de contexto

Sincronização

Todas as playlists e a biblioteca de músicas são sincronizadas automaticamente na sua conta. Se você criar uma playlist no computador, ela aparecerá no celular na próxima vez que abrir o Music Player.

---

Visualizador de Áudio

O Music Player possui um visualizador de espectro de frequências em tempo real que reage à música tocando. A animação mostra as frequências graves, médias e agudas em barras coloridas que dançam conforme o ritmo.

NOTA SOBRE CROSS-ORIGIN

O visualizador funciona perfeitamente com arquivos locais e de mesma origem. Para streams de disco de rede em domínios diferentes (ex: acessando casa.roqueos.com enquanto o app roda em localhost), o visualizador usa um modo de pulso alternativo por restrições de CORS do navegador — a música continua tocando normalmente.

---

Widget de Mídia no Desktop

Quando uma música está tocando, um mini player aparece na barra de tarefas do RoqueOS, permitindo controle rápido sem precisar abrir a janela do Music Player:

• ⏯️ Play / Pause
• ⏭️ Próxima faixa
• ⏮️ Faixa anterior
• 🔊 Controle de volume

---

Formatos Suportados

Formato	Extensão	Suporte
MP3	.mp3	✅ Todos os navegadores
WAV	.wav	✅ Todos os navegadores
OGG Vorbis	.ogg	✅ Chrome, Firefox, Edge
FLAC	.flac	✅ Chrome, Edge, Safari 14.1+
AAC	.aac, .m4a	✅ Todos os navegadores
WebM Audio	.webm	✅ Chrome, Firefox, Edge

---

Dicas de Uso

DICAS RÁPIDAS

• Duplo clique em uma música na biblioteca para tocá-la imediatamente
• Use o menu de contexto (clique direito) para adicionar músicas a playlists
• O player lembra a posição e fila de reprodução ao reabrir o app
• Para melhor qualidade de streaming remoto, use formatos compactos como MP3 ou AAC
• Com Cloudflare Tunnels, o streaming funciona globalmente sem expor portas