SoundVaultЧто такое SoundVault
Это музыкальный сервис, который работает на твоём сервере. Ты сохраняешь файлы, организуешь альбомы и выдаёшь доступ к коллекции. На компьютере музыка открывается в браузере, на телефоне и планшете — в Android-приложении.
Для собственной библиотеки не нужна подписка SoundVault. Сервер должен быть включён и доступен устройствам; скачанная в Android музыка доступна и без сети.
От файлов к библиотеке
- Положи музыку в общую папку
public/или свою папкуusers/логин/внутри библиотеки. - Разложи альбомы по папкам. Поддерживаются MP3, FLAC, WAV, CUE-листы и плейлисты M3U.
- Добавь обложки из тегов или файлы
cover.jpg,folder.png,album.webp. Поддерживаются также JPEG и PNG; регистр имени не важен. - Запусти сканирование: сервер прочитает теги и обновит каталог.
Локальные файлы передаются без серверного перекодирования. Поддержка формата и итоговый вывод звука зависят от клиента и устройства.
Клиенты и повседневные возможности
| Возможность | Как пользоваться |
|---|---|
| Библиотека и поиск | Папки, фильтры, сортировка и поиск по коллекции. |
| Плейлисты и избранное | Собирай подборки и возвращайся к любимым записям. |
| История | Находи недавно прослушанные треки. |
| Android | Воспроизведение в фоне, загрузки для офлайна и Android Auto. |
| Web UI | Управление коллекцией и прослушивание в браузере компьютера. Обзор интерфейса. |
Доступ для друзей
Администратор создаёт пользователей и назначает права на папки. Пользователь видит свою музыку, публичную библиотеку и альбомы, которыми с ним поделились. Никнейм нужен, чтобы выбрать получателя доступа.
Временная ссылка на трек действует 72 часа и открывается без учётной записи. Доступ к альбому конкретному пользователю сохраняется до отзыва. Гость может слушать публичную музыку в веб-интерфейсе; вход гостя в Android не поддерживается.
Федерация: музыка с другого сервера
Два SoundVault могут обмениваться доступными коллекциями. Музыка соседнего сервера появляется рядом с локальными альбомами и воспроизводится через твой сервер. Копия всей удалённой библиотеки для этого не создаётся.
- На обоих серверах настрой HTTPS, внешний адрес и отдельный ключ федерации.
- В панели администратора открой «Узлы». Один администратор создаёт приглашение, другой принимает его.
- Сверьте отпечатки ключей по независимому каналу и подтвердите связь с обеих сторон.
- Выдай узлу доступ к выбранным публичным папкам и включи показ контента соседа. Пользователи также могут делиться альбомами с пользователями соседнего сервера.
Связь не открывает личные папки автоматически. Права проверяются при обращениях, доступ можно отозвать. Для прослушивания сосед должен быть в сети. В текущем API удалённые треки не добавляются в локальные плейлисты и избранное.
Настройка федерацииОблачная музыка
В проекте реализовано подключение Яндекс.Музыки. Учётная запись подключается через «Облачные сервисы», после чего в веб-интерфейсе доступны разделы библиотеки и поиск Яндекса. Доступ к контенту зависит от учётной записи и подписки сервиса; условия собственной библиотеки на облако не распространяются.
Администратор должен настроить ключ шифрования. Интеграция использует неофициальный API и может требовать обновления при изменениях на стороне Яндекса. Набор возможностей зависит от версии сервера и клиента.
Где хранятся данные
Файлы, база библиотеки и история локального прослушивания находятся на твоём сервере. Поиск обложек, подключённые облачные сервисы и федерация обращаются к соответствующим внешним источникам. Администратор отвечает за права доступа и резервные копии.