Music: музыкальный сервис в Lampa

Модуль Music добавляет в Lampa музыкальный каталог, поиск, плейлисты, импорт из Spotify, Apple Music и SoundCloud, синхронизированные тексты и серверный relay аудиопотоков.

Modules/Music/manifest.json содержит "enable": false. Для включения используйте пользовательскую копию модуля с изменённым манифестом. Не изменяйте файлы внутри контейнера: они пропадут после обновления.

Возможности

Каталог и discovery

MusicBrainz используется как база метаданных; Apple Music, Spotify, SoundCloud и YouTube Music формируют полки и чарты.

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

YouTube, Sefon, SoundCloud и опционально Z3Fm подбирают аудио; клиент получает только relay URL /music/stream.

Плейлисты

Локальные плейлисты и импорт публичных Spotify, Apple Music и SoundCloud ссылок хранятся в SQLite.

Тексты и радио

LRC-тексты, ручной сдвиг тайминга, радио от трека и автоподборка очереди.

Включение

Подготовьте пользовательскую копию

Скопируйте Modules/Music в runtime-каталог mods/Music и установите "enable": true в mods/Music/manifest.json.

Разрешите загрузку

Убедитесь, что Music отсутствует в BaseModule.SkipModules и попадает в LoadModules.

Подключите плагин

Добавьте http://HOST:9118/music.js в Lampa или зарегистрируйте его через LampaWeb.customPlugins.

Проверьте API

curl -fsS http://127.0.0.1:9118/music/providers
curl -fsS http://127.0.0.1:9118/music/home

Базовая конфигурация

{
  "Music": {
    "useproxy": false,
    "useproxystream": false,
    "applemusic_country": "ru",
    "spotify_discovery_enabled": true,
    "spotify_country": "ua",
    "soundcloud_country": "UK",
    "z3fm_enabled": false,
    "z3fm_audio_enabled": false
  }
}

Параметр	По умолчанию	Назначение
`default_metadata_provider`	`musicbrainz`	Канонический каталог
`default_audio_provider`	`youtubeaudio`	Основной audio resolver
`useproxy`	`false`	Прокси для API и discovery
`useproxystream`	`false`	Прокси upstream-аудио
`spotify_discovery_enabled`	`true`	Полки Spotify
`soundcloud_enabled`	`true`	Discovery и audio SoundCloud
`z3fm_enabled`	`false`	Z3Fm; требует Playwright
`client_debug_enabled`	`false`	Приём трассировок на `/music/clientlog`

Хранение и безопасность

Пользовательские данные хранятся в database/music/Music.sql.
Метаданные, картинки и stream tickets относятся к временному кешу.
Внешние CDN-ссылки не передаются клиенту напрямую.
Не публикуйте OAuth credentials или proxy passwords в репозитории.

Полный список маршрутов: Music API.

Начало работы

Конфигурация

Архитектура

Модули

Провайдеры

Развёртывание

Обслуживание

Music: музыкальный сервис в Lampa

Возможности

Каталог и discovery

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

Плейлисты

Тексты и радио

Включение

Базовая конфигурация

Хранение и безопасность

​Возможности

Каталог и discovery

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

Плейлисты

Тексты и радио

​Включение

​Базовая конфигурация

​Хранение и безопасность

Возможности

Включение

Базовая конфигурация

Хранение и безопасность