Music Player

Музыкальный плеер для вашей личной библиотеки. Та коллекция FLAC, MP3 риппнутые с CD, скачанные подкасты, живые записи, которые вы накопили за годы. Всё в плеере, работающем на любом залогиненном устройстве — мобильный, планшет, ноутбук, Smart TV — с прямым стримингом с домашнего HDD, фоновым воспроизведением (экран выключен — продолжает играть) и настоящим спектральным визуализатором.

Думайте Spotify, но с вашими собственными файлами и без ежемесячной платы.

---

Особенности

🎵

Плейлисты

Создавайте и организуйте кастомные плейлисты с автосинхронизацией в облако.

📡

Сетевой стриминг

Слушайте музыку с домашнего HDD из любой точки мира.

📱

Фоновое воспроизведение

Продолжайте слушать с выключенным экраном на мобильном.

🌈

Визуализатор

Анимация в реальном времени частотного спектра.

---

Добавление музыки

📁 Через файловый менеджер

Найдите аудиофайл (.mp3, .wav, .ogg, .flac) в Файловом менеджере и дважды кликните. Music Player откроется автоматически и начнёт воспроизведение.

🔗 По URL

Вставьте прямой URL аудиофайла, доступного через интернет. Полезно для прямых ссылок с хостинга или CDN.

📂 Добавить целую папку

Импортируйте целую папку с множеством аудиофайлов в вашу библиотеку за один раз.

💾 С сетевого диска Сервер

Навигируйте по замапленным дискам сервера и добавляйте целые папки с музыкой с вашего HDD.

---

Стриминг с сетевого диска

🌟 Топовая функциональность! Слушайте музыку с домашнего HDD из любой точки мира, как персональный сервис стриминга типа Spotify — но с вашей коллекцией музыки.

Как это работает?

1. Ваши MP3-файлы находятся на HDD вашего компьютера или сервера
2. Эти файлы замаплены как тома в RoqueOS Server
3. Music Player получает доступ через HTTP-стриминг через сервер
4. Вы слушаете с любого устройства, подключённого к интернету

Шаг за шагом

1. Замапьте папку с музыкой в docker-compose.yml:

services:
  roqueos-server:
    volumes:
      - ./data:/app/data
      - /var/run/docker.sock:/var/run/docker.sock
      - /home/user/Music:/app/disks/Music # ← Ваш HDD с музыкой

2. Перезапустите сервер:

docker compose down && docker compose up -d

3. В RoqueOS откройте Music Player и добавьте сетевую папку:

• Кликните кнопку добавить папку
• Навигируйте к диску Music в сетевом селекторе
• Выберите нужную папку и подтвердите
• Вся музыка из папки будет импортирована в вашу библиотеку

4. Готово! Слушайте откуда угодно.

Если используете Cloudflare Tunnels для внешнего доступа, стриминг работает из любой точки мира с интернет-соединением.

---

Фоновое воспроизведение (Background Playback)

📱 Существенная функциональность для мобильного! Music Player продолжает играть даже когда вы блокируете экран мобильного или переключаетесь между приложениями.

Как это работает на мобильном?

RoqueOS использует Media Session API браузера, что позволяет:

• Выключенный экран — Музыка продолжает играть нормально
• Управление с экрана блокировки — Play, pause, следующая и предыдущая появляются в системном уведомлении
• Управление с наушников — Кнопки Bluetooth-наушников работают нормально
• Сменить приложение — Музыка не останавливается когда вы открываете другие приложения

Требования

• Использовать RoqueOS через установленную PWA или нативное приложение (iOS/Android)
• Браузер Chrome, Safari или Edge в свежей версии
• На iOS PWA должна быть установлена на главный экран чтобы фоновое воспроизведение работало

СОВЕТ

Для лучшего опыта стриминга на мобильном установите RoqueOS как PWA или скачайте нативное приложение из App Store или Microsoft Store.

---

Управление плейлистами

Создать плейлист

1. В области Плейлисты на боковой панели кликните + Новый Плейлист
2. Дайте плейлисту имя
3. Перетащите музыку из библиотеки в плейлист, или используйте контекстное меню музыки

Организовать

• Изменить порядок — Перетащите музыку внутри плейлиста чтобы изменить порядок
• Удалить — Кликните правой кнопкой на музыке и выберите "Удалить из плейлиста"
• Переименовать — Кликните на имя плейлиста чтобы редактировать
• Удалить — Удалите весь плейлист через контекстное меню

Синхронизация

Все плейлисты и музыкальная библиотека автоматически синхронизируются в вашем аккаунте. Если создадите плейлист на компьютере, он появится на мобильном в следующий раз когда откроете Music Player.

---

Аудио визуализатор

Music Player имеет визуализатор частотного спектра в реальном времени, который реагирует на играющую музыку. Анимация показывает низкие, средние и высокие частоты в цветных столбиках, танцующих по ритму.

ЗАМЕТКА О CROSS-ORIGIN

Визуализатор работает идеально с локальными файлами и одного источника. Для стримов сетевого диска в разных доменах (например, доступ к casa.roqueos.com когда приложение работает в localhost), визуализатор использует альтернативный режим пульсации из-за CORS-ограничений браузера — музыка продолжает играть нормально.

---

Медиа виджет на десктопе

Когда музыка играет, на панели задач RoqueOS появляется мини плеер, позволяющий быстрое управление без необходимости открывать окно Music Player:

• ⏯️ Play / Pause
• ⏭️ Следующий трек
• ⏮️ Предыдущий трек
• 🔊 Управление громкостью

---

Поддерживаемые форматы

Формат	Расширение	Поддержка
MP3	.mp3	✅ Все браузеры
WAV	.wav	✅ Все браузеры
OGG Vorbis	.ogg	✅ Chrome, Firefox, Edge
FLAC	.flac	✅ Chrome, Edge, Safari 14.1+
AAC	.aac, .m4a	✅ Все браузеры
WebM Audio	.webm	✅ Chrome, Firefox, Edge

---

Советы по использованию

БЫСТРЫЕ СОВЕТЫ

• Двойной клик на музыке в библиотеке чтобы воспроизвести немедленно
• Используйте контекстное меню (правый клик) чтобы добавлять музыку в плейлисты
• Плеер запоминает позицию и очередь воспроизведения при повторном открытии приложения
• Для лучшего качества удалённого стриминга используйте компактные форматы как MP3 или AAC
• С Cloudflare Tunnels стриминг работает глобально без открытия портов