Music Player

O Music Player do RoqueOS é um reprodutor de música completo que transforma seu desktop web em uma central de áudio pessoal. Com suporte a playlists, visualizador de espectro e streaming de disco de rede, ele funciona de forma similar a apps como Spotify e Apple Music — inclusive com reprodução em segundo plano quando a tela do celular está desligada.

---

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.

---

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