Music Player

The Music Player turns your web desktop into a personal audio hub. With support for playlists, spectrum visualizer and network disk streaming, it works like Spotify and Apple Music — including background playback when your phone screen is off.

---

Highlights

🎵

Playlists

Create and organize custom playlists with automatic cloud sync.

📡

Network Streaming

Listen to music from your home HD, from anywhere in the world.

📱

Background Playback

Keep listening with the screen off on mobile.

🌈

Visualizer

Real-time frequency spectrum animation.

---

Adding Music

📁 From the File Manager

Find an audio file (.mp3, .wav, .ogg, .flac) in the File Manager and double-click it. The Music Player will open automatically and start playing.

🔗 By URL

Paste the direct URL of an audio file accessible over the internet.

📂 Add Entire Folder

Import a whole folder of audio files at once into your library.

💾 From Network Disk Server

Browse mapped disks from the server and add entire music folders from your HD.

---

Network Disk Streaming

🌟 Highlight feature! Listen to music from your home HD from anywhere in the world, like a personal streaming service — but with your own music collection.

How It Works

1. Your MP3 files are on your computer or server HD
2. Those files are mapped as volumes in RoqueOS Server
3. The Music Player streams via HTTP through the server
4. You listen from any internet-connected device

Step by Step

1. Map your music folder in docker-compose.yml:

services:
  roqueos-server:
    volumes:
      - ./data:/app/data
      - /var/run/docker.sock:/var/run/docker.sock
      - /home/user/Music:/app/disks/Music  # ← Your music HD

2. Restart the server:

docker compose down && docker compose up -d

3. In RoqueOS, open the Music Player and add the network folder:

• Click the add folder button
• Browse to the Music disk in the network selector
• Select the desired folder and confirm
• All songs will be imported to your library

4. Done! Listen from anywhere.

With Cloudflare Tunnels, streaming works globally.

---

Background Playback

📱 Essential mobile feature! The Music Player keeps playing even when you lock your phone screen or switch apps.

How it works on mobile

RoqueOS uses the browser's Media Session API, which enables:

• Screen off — Music keeps playing normally
• Lock screen controls — Play, pause, next and previous appear in system notification
• Headphone controls — Bluetooth headphone buttons work normally
• App switching — Music doesn't stop when you open other apps

Requirements

• Use RoqueOS via installed PWA or native app (iOS/Android)
• Chrome, Safari or Edge browser in recent version
• On iOS, the PWA must be installed on the home screen for background playback

TIP

For the best mobile streaming experience, install RoqueOS as a PWA or download the native app from the App Store or Microsoft Store.

---

Playlist Management

Create a Playlist

1. In the Playlists area in the sidebar, click + New Playlist
2. Name your playlist
3. Drag songs from the library to the playlist, or use the song's context menu

Organize

• Reorder — Drag songs within the playlist to change order
• Remove — Right-click a song and select "Remove from playlist"
• Rename — Click the playlist name to edit it
• Delete — Remove the entire playlist via context menu

Sync

All playlists and the music library are automatically synced to your account. A playlist created on your computer will appear on your phone next time you open the Music Player.

---

Audio Visualizer

The Music Player has a real-time frequency spectrum visualizer that reacts to the playing music with colorful bars that dance to the rhythm.

CROSS-ORIGIN NOTE

The visualizer works perfectly with local and same-origin files. For network disk streams on different domains, the visualizer uses an alternative pulse mode due to browser CORS restrictions — music keeps playing normally.

---

Desktop Media Widget

When music is playing, a mini player appears in the RoqueOS taskbar for quick control:

• ⏯️ Play / Pause
• ⏭️ Next track
• ⏮️ Previous track
• 🔊 Volume control

---

Supported Formats

Format	Extension	Support
MP3	.mp3	✅ All browsers
WAV	.wav	✅ All browsers
OGG Vorbis	.ogg	✅ Chrome, Firefox, Edge
FLAC	.flac	✅ Chrome, Edge, Safari 14.1+
AAC	.aac, .m4a	✅ All browsers
WebM Audio	.webm	✅ Chrome, Firefox, Edge

---

Tips

QUICK TIPS

• Double-click a song in the library to play it immediately
• Use the context menu (right-click) to add songs to playlists
• The player remembers position and queue when reopening the app
• For best remote streaming quality, use compact formats like MP3 or AAC
• With Cloudflare Tunnels, streaming works globally without exposing ports