Рекомендации по расширенной настройке

Navidrome: Группируйте альбомы независимо от даты выпуска.

Navidrome 0.64.2 также по умолчанию группирует альбомы по дате выпуска. Если теги даты в разных форматах файлов интерпретируются как год записи или выпуска, один и тот же альбом может появляться более одного раза.

Чтобы игнорировать даты выпуска при группировке альбомов, установите следующее правило в Navidrome. Замените существующее правило, а не добавляйте дубликат ключа TOML. При добавлении нового правила разместите его на верхнем уровне перед разделами таблицы.

PID.Album = "musicbrainz_albumid|albumartistid,album,albumversion"

Идентификатор альбома MusicBrainz, исполнитель альбома, название альбома и версия альбома по-прежнему определяют группировку. Это правило распространяется на всю библиотеку. Релизы, отличающиеся только датой, могут быть объединены. Никаких изменений в тегах медиафайлов не требуется.

Navidrome, затем перезапустите. Измененное правило альбома запускает полное сканирование. Затем перезагрузите представление альбома в клиентах. Переменная среды ND_PID_ALBUM имеет приоритет над файлом конфигурации и может нуждаться в соответствующей корректировке.

Источник: Navidrome: настраиваемые идентификаторы альбомов и треков..

Navidrome: приоритет встроенных обложек

Если треки разных альбомов находятся в одной папке, общий Folder.jpg может заменять все их обложки. Этот порядок отдаёт приоритет доступной встроенной обложке; при её отсутствии остальные источники остаются запасными.

В navidrome.toml замените существующее значение или добавьте параметр на верхнем уровне перед разделами таблиц. Не дублируйте ключ.

CoverArtPriority = "embedded, cover.*, folder.*, front.*, external"

Затем перезапустите Navidrome. Один лишь перезапуск не пересчитывает сохранённые обложки. В Navidrome 0.64.2 нужные альбомы можно заново обработать по отдельности официальной командой artwork:

navidrome -c /pfad/navidrome.toml artwork refresh al ALBUM_ID_1 ALBUM_ID_2

Замените пример пути и идентификаторы альбомов. Выполняйте команду от того же пользователя службы, в том же рабочем каталоге и с той же конфигурацией, средой и базой данных, что и Navidrome. Изменять медиафайлы или теги и удалять базу данных не требуется.

Затем повторно синхронизируйте библиотеку клиента, например Amperfy, чтобы получить новые идентификаторы обложек. Переустанавливать приложение или полностью очищать кеш обложек не требуется.

Ampache и LMS: вход с помощью API-ключа.

Ampache 7, Ampache 8 и LMS для входа в систему требуется ключ API. Создайте ключ для своей учетной записи на сервере и используйте его при подключении в MusicServer Connect. Держите это в тайне.

Ampache 7.10.2: импорт названий без исполнителей названий.

Симптом и причина

Файлы без исполнителя трека могут быть пропущены при импорте каталога. Исправление базы данных ниже позволяет их импортировать. Для входа в Ampache требуется ключ API; видеть Войдите с помощью API-ключа.

Область применения

Это исправление применимо к Ampache 7.10.2 с MariaDB и определением столбца, показанным ниже. Для других версий сначала проверьте, применима ли та же причина.

Что изменилось

Только song.artist в выбранной базе данных Ampache изменяется, чтобы разрешить NULL. Его тип данных, значение по умолчанию 0 и существующие индексы сохраняются. Исходный код Ampache и музыкальные файлы не изменились. Имена исполнителей не придумываются, а теги файлов не заменяются. Другие базы данных и глобальные настройки MariaDB не затрагиваются.

Общее исправление базы данных

Требования

Запустите эти команды на сервере MariaDB, внутри его контейнера, где это возможно. Учетной записи базы данных необходим доступ на чтение для проверки и разрешение ALTER для песни. В примере используется локальный логин root. Для другой учетной записи базы данных используйте существующую конфигурацию безопасного клиента; не вводите пароль в команду.

Сначала определите фактическое имя базы данных, указанное как database_name в конфигурации Ampache. Используйте собственное имя базы данных в каждой команде.

AMPACHE_DB='DEIN_AMPACHE_DATENBANKNAME'
mariadb --database="$AMPACHE_DB" -e \
  "SHOW COLUMNS FROM song LIKE 'artist';"

Для подтвержденной проблемы выходные данные показывают Type=int(11) unsigned, Null=NO и Default=0. Если Null=YES, коррекция уже применена. Не изменяйте другое определение, не проверив его.

Рекомендуется: прилагаемый скрипт Скачать ampache7-null-artist.sh на сервере базы данных. Он проверяет столбец, принимает только ожидаемый беззнаковый тип INT и не вносит дальнейших изменений, если NULL уже разрешен. Неожиданная схема заставляет его остановиться без изменений.

sh /pfad/zum/ampache7-null-artist.sh "$AMPACHE_DB"

Конкретное SQL-ядро исправления для подтвержденного выше определения:

ALTER TABLE song
  MODIFY COLUMN artist INT(11) UNSIGNED NULL DEFAULT 0;

Импортируйте недостающие файлы и проверьте результат

После изменения схемы импортируйте недостающие файлы. Используйте собственный путь к приложению установки, имя каталога и учетную запись службы. Версия PHP должна соответствовать версии Ampache.

AMPACHE_APP='/pfad/zur/ampache-installation'
AMPACHE_CATALOG='DEIN_KATALOGNAME'
runuser -u www-data -- php "$AMPACHE_APP/bin/cli" \
  run:updateCatalog "$AMPACHE_CATALOG" -a

mariadb --database="$AMPACHE_DB" -e \
  "SELECT COUNT(*) AS Titel FROM song;
   SELECT id, title, artist, enabled FROM song
   WHERE artist IS NULL;"

-a добавляет новые медиафайлы. Он не требует очистки каталога, импорта плейлистов или повторного сканирования существующих тегов файлов. Ampache может затем обновить внутренние сопоставления и счетчики.

Затем обновите плагин, откройте все заголовки и проверьте ранее отсутствующие заголовки. Тогда названия выше Все названия → отметить все → найти в базе данных → добавить в базу данных в базу данных поиска VirtualDJ. См. Поиск в узлах дерева.

Эксплуатация и последующие обновления

Это корректировка локальной схемы базы данных, а не официально подтвержденная общая миграция Ampache. После обновления базы данных Ampache снова проверьте song.artist и импорт файлов без исполнителей треков: миграция может изменить определение. Скрипт можно проверять неоднократно.

Чтобы восстановить NOT NULL, сначала необходимо тщательно обработать существующие записи NULL; слепой сброс столбца не является подходящим откатом. Отмеченное исправление сохраняет отсутствующих исполнителей треков как недостающую информацию.

Gonic 0.22.0: по одному альбому в каждой музыкальной папке.

Симптом и причина

Gonic требует отдельную папку для каждого альбома. Храните файлы альбома вместе; не смешивайте разные альбомы в одной папке. Общая папка для несвязанных одиноких людей не соответствует этому требованию. Затем Gonic может применить метаданные альбома первого файла, включая исполнителя альбома, ко всем остальным файлам в этой папке.

Рекомендуемая структура папок

Для отдельных треков тоже создайте по подпапке на альбом, например «Einzeltitel/Alter Ego - Betty Ford (Bonus Remixes Version)» / «Einzeltitel/Homie Isback - Cherrymoon». Обе версии Cherrymoon могут находиться в одной папке, если принадлежат одному альбому. Разные издания храните отдельно. Размещайте музыкальные файлы в подпапках настроенного музыкального пути: Gonic 0.22.0 пропускает файлы непосредственно в корневой папке.

Если несколько серверов совместно используют библиотеку, вы можете создать отдельное представление папок для Gonic, используя символические ссылки. Там же дайте каждому альбому отдельную папку. Настройте пути к музыке, чтобы каждая дорожка индексировалась только один раз. Учетной записи службы Gonic необходим доступ как к ссылкам, так и к их целям.

Проверьте после изменения

Полностью пересканируйте Gonic, затем обновите список треков плагина. Проверьте итоговые данные, группировку альбомов, узлы исполнителей и воспроизведение. Изменения в путях импорта могут привести к созданию новых идентификаторов серверов, поэтому впоследствии проверьте существующие избранные файлы, плейлисты и настройки VirtualDJ. При необходимости зарегистрируйте треки еще раз. Добавить в базу поиска VirtualDJ. Вновь добавленные отдельные треки также должны быть представлены в соответствующей структуре папок альбома.

Предоставлять пользователю плейлисты на основе файлов

Gonic читает плейлисты из настроенных playlists-path и подпапку, названную в честь числового идентификатора пользователя. Поместите туда файлы M3U/M3U8 с путями к носителям, разрешенными для Gonic. Обычное сканирование музыки не импортирует автоматически списки воспроизведения из других папок библиотеки. Наша установка создает производные представления без изменения общих оригиналов. Обновите эти представления после изменения источников.

Gonic проектная документация

Gerbera 3.3.0-77: BPM, Key, UTF-8 и Inotify

Добавьте следующие сопоставления для BPM и ключа. Музыкальные файлы должны содержать соответствующие теги BPM и KEY или INITIALKEY. Сохраните существующие сопоставления, такие как PERFORMER.

Для установки на основе XML добавьте записи в разделах импорт → параметры библиотеки → id3 → метаданные и ffmpeg → метаданные. Gerbera помечает группу XML с идентификатором 3 как taglib Library Options в своем веб-интерфейсе. Установите для charset значение UTF-8 в обеих библиотеках; сохраните или установите для filesystem-charset, metadata-charset и playlist-charset значение UTF-8. Сохраните и перезапустите Gerbera. Дополнительные сопоставления тегов вступают в силу при повторном импорте файлов; обычное повторное сканирование может пропустить неизмененные файлы. При новой установке настройте эти параметры перед импортом музыки.

MP4, M4A и M4V: отдайте предпочтение более точному тегу BPM.

Доступно в сборке Git 3.3.0-77: Расширение BPM Gerbera-PR #3993 был объединен и включен в официальный образ. Более высокая точность не является обязательной и должна быть включена с помощью prefer_highest_bpm_accuracy="yes" быть включенным. Без этого атрибута остается no значение по умолчанию.

Атрибут MP4 tmpo содержит целое число. Кроме того, дополнительный тег iTunes BPM может содержать более точное значение. В существующем элементе XML import → library-options → id3 можно ли включить его предпочтение; сохраните существующие сопоставления тегов:

<id3 prefer_highest_bpm_accuracy="yes" prefer_ambigous_bpm_value="bpm_tag">
  <metadata>
    <add-data tag="BPM" key="upnp:beatsPerMinute" />
  </metadata>
</id3>

Если отсутствует prefer_highest_bpm_accuracy или если он установлен на no, предыдущее поведение сохраняется. Для yes Gerbera читает tmpo и дополнительный тег BPM отдельно. Если расстояние меньше 1 BPM, принимается значение тега, например 123,5 вместо этого 123. Если значения отличаются как минимум на 1 BPM, выбор определяется prefer_ambigous_bpm_value: tmpo предпочитает целое число, bpm_tag дополнительный тег. Если второй атрибут отсутствует, bpm_tag. Обозначение атрибута является явным prefer_ambigous_bpm_value.

Для этого выбора действительны только конечные положительные числа; используйте десятичную точку в теге файла. Если действителен только один источник, он используется. Значения полупериода или двойного тайма не корректируются автоматически. Остальные теги, жанры, ключ и обложки читаются как и раньше. Перезапустите Gerbera после изменения конфигурации и повторно импортируйте затронутые файлы; обычное повторное сканирование может пропустить неизмененные файлы.

AIFF: BPM, ключ и чтение нескольких жанров

Если в файлах AIFF отсутствует BPM или ключ, несмотря на существующие теги ID3, в файлах Gerbera Конфигурация → Эксперт → Импорт → Сопоставления → Mimetype-Contenttype сопоставление распознанного типа MIME с типом контента aiff дополнение. Для audio/x-aiff и audio/aiff каждый aiff войти. Это позволяет Gerbera использовать соответствующий считыватель TagLib; сопоставления BPM/клавиш из приведенной выше таблицы по-прежнему необходимы.

В конфигурации XML следующие строки в существующем разделе import → mappings → mimetype-contenttype со следующими дополнениями, сохраняя существующие сопоставления:

<treat mimetype="audio/x-aiff" as="aiff" />
<treat mimetype="audio/aiff" as="aiff" />

Перезапустите Gerbera или его контейнер и снова импортируйте затронутые файлы. Обычное повторное сканирование может пропустить неизмененные файлы; никаких переименований или изменений временных меток не требуется.

OGV: принять теги из аудио- и видеодорожек.

С помощью OGV название, исполнитель, альбом, жанр, BPM и ключ могут находиться на отдельных аудио- и видеодорожках. Активировать в Gerberas Конфиг → Эксперт → Library Options → ffmpeg Library Options вариант streams-enabled. Это доступно в конфигурации XML. import → library-options → ffmpegэлемент, атрибут streams-enabled="yes" положить; Сохраните существующие атрибуты и назначения тегов.

Перезапустите Gerbera или его контейнер, затем повторно импортируйте существующие файлы OGV. Сопоставления BPM/клавиш в таблице выше по-прежнему необходимы. Если анализ метаданных потока не включен, эти значения могут отсутствовать, несмотря на правильно сохраненные теги файлов.

WebM и WMV: используйте несколько жанров с помощью подходящего читателя

Начиная с сборки Git 3.3.0-62, а также в текущей 3.3.0-77 может читать теги нескольких жанров из WebM и WMV. Обновления сохраняют существующую конфигурацию, поэтому сопоставления читателей, добавленные в новую сборку, могут по-прежнему отсутствовать. В Конфигурация → Эксперт → Импорт → Сопоставления → Mimetype-Contenttype Добавьте следующие сопоставления или в существующий раздел XML. import → mappings → mimetype-contenttype введите:

<treat mimetype="video/webm" as="mkv" />
<treat mimetype="video/x-ms-wmv" as="asf" />

Сохраните существующие сопоставления и настройки BPM/ключей, перезапустите Gerbera и повторно импортируйте затронутые файлы. Это меняет тип используемого средства чтения метаданных, а не возвращаемый тип MIME видео. Файлы не нуждаются в преобразовании или переименовании. Основой является Сопоставления по умолчанию исходной версии Gerbera.

Автоматически обнаруживать изменения файлов и атрибутов

Inotify обнаруживает события файловой системы. inotify-attrib="yes" дополнительно отслеживает изменения атрибутов, включая временные метки, измененные при прикосновении. Для установки Linux расширьте существующий раздел автосканирования в /etc/gerbera/config.xml, сохранив при этом путь к музыке:

<autoscan use-inotify="yes" inotify-attrib="yes">
  <directory location="/srv/music" mode="inotify" recursive="yes" hidden-files="no" />
</autoscan>

Тогда воспользуйтесь сервисом Linux systemctl restart gerbera перезапустить.

Inotify в официальном контейнере Gerbera

Официальный образ уже включает Inotify для смонтированной папки с музыкой, но дополнительный мониторинг атрибутов изначально отключен. Используйте Inotify и отслеживайте изменения атрибутов Inotify. Изменения атрибутов отображаются в разделе «Конфигурация Gerbera» → «Эксперт» → «Импорт», но их нельзя редактировать в этом представлении на отмеченном изображении. Настройки хранятся в /var/run/gerbera/autoscan.xml..

1. На QNAP откройте gerbera-qnap в Container Station и запустите его терминал или консоль. На Synology выберите gerbera-synology в диспетчере контейнеров, откройте его терминал и запустите /bin/sh.. Выполните следующую команду внутри контейнера.
2. Вставьте следующий блок. Он завершает атрибут и показывает файл сканирования; Музыкальный путь и существующие настройки сохраняются.

test -f /var/run/gerbera/autoscan.xml &&
sed -i -e 's/inotify-attrib="no"/inotify-attrib="yes"/g' \
  -e '/<autoscan/ { /inotify-attrib=/! s/<autoscan/<autoscan inotify-attrib="yes"/; }' \
  /var/run/gerbera/autoscan.xml &&
cat /var/run/gerbera/autoscan.xml

В выводе должно отображаться автосканирование с помощью inotify-attrib="yes". Перезапустите контейнер, затем убедитесь, что в конфигурации Gerbera выбран параметр «Мониторинг изменений атрибутов Inotify». Если autoscan.xml отсутствует, сначала определите фактически используемый файл конфигурации. Эта команда применима к официальной сборке, указанной в руководствах по NAS.

Отдельные теги жанра не требуют дополнительной настройки. MusicServer Connect использует все поля жанра, предоставляемые UPnP. Начиная с версии 1.5, комбинированные жанры, разделенные точкой с запятой или косой чертой, также присваиваются отдельным представлениям жанров. Теги сервера и файла остаются неизменными.

Источники: Gerbera автосканирование и мониторинг атрибутов, Начальная настройка официального образа контейнера.

Gerbera 3.3.0-77: чистые названия заголовков в результатах поиска

Gerbera по умолчанию объединяет M_ARTIST и M_TITLE для названий треков в результатах поиска UPnP. MusicServer Connect импортирует через этот интерфейс, поэтому в столбце заголовка появляется «Speedy J — Electric Deluxe», хотя тег файла TITLE содержит только «Electric Deluxe».

В разделе «Сервер → upnp» настройте результат поиска на использование только M_TITLE. extend="no" заменяет список по умолчанию вместо добавления записей:

<search-item-result extend="no">
  <add-data tag="M_TITLE" />
</search-item-result>

Скрипт конфигурации gerbera-suchtitel.py устанавливает эту опцию в существующей конфигурации XML. Путь по умолчанию — /etc/gerbera/config.xml; другой путь может быть указан в качестве аргумента. Существующие пространства имен, комментарии и другие настройки сохраняются. Если структура сервера неоднозначна, сценарий останавливается перед записью.

Альтернативно, в веб-интерфейсе Gerbera по адресу Конфигурация → Сервер → UPnP → Результат поиска запись M_ARTIST удалить и только M_TITLE чтобы сохранить его. Проверьте настройки, уже сохраненные в веб-интерфейсе, поскольку они могут переопределять значения XML. Этот параметр также применим к Gerbera 3.3. Художник остается доступным в виде отдельного поля метаданных.

Перезапустите Gerbera и перезагрузите соединение плагина. Этот параметр изменяет названия треков в результатах поиска; никаких изменений плагинов или музыкальных файлов не требуется. Проверьте также отображение треков, уже сохраненных в VirtualDJ. Опциональное определение исполнителя FRITZ!Box не зависит от этой настройки.

Gerbera: просмотр и импорт плейлистов

Почему один и тот же плейлист появляется несколько раз

Gerbera может отображать один и тот же список воспроизведения в обоих списках воспроизведения → Все списки воспроизведения и списках воспроизведения → Каталоги. Это не означает, что файл списка воспроизведения существует более одного раза.

MusicServer Connect объединяет идентичные представления списков воспроизведения. Если их содержимое различается или запрос неполный, несколько представлений могут оставаться видимыми.

Проверьте неполный импорт плейлистов

1. Проверьте записи плейлиста. Относительные пути относятся к их папке.
2. Убедитесь, что все указанные музыкальные файлы существуют и доступны для чтения сервисной учетной записью Gerbera.
3. Прочтите плейлист еще раз после изменений. Если импорт не завершен, перезапустите службу Gerbera и дождитесь сканирования.
4. Затем обновите вид в плагине и проверьте плейлист.

Чтобы автоматически обнаруживать изменения во временных метках файлов, используйте Мониторинг атрибутов Inotify активировать.

Устаревшие ссылки на плейлисты и набор символов M3U.

После изменения медиафайлов, на которые ссылается плейлист, проверьте его содержимое снова. Обычное повторное сканирование может не изменить существующие представления плейлистов. Затем обновите библиотеку в MusicServer Connect. Идентификаторы каталога могут измениться.

Чтобы использовать одни и те же файлы плейлиста с MinimServer, мы сохраняем M3U с Windows-1252 и M3U8 с UTF-8. Стандартный импортер Gerbera в тестируемой сборке 3.3.0-77 неправильно разрешил путь умлаута Windows-1252-M3U. Загрузите проверенное расширение импорта M3U и сохраните его в настроенном каталоге пользовательских сценариев. Он обнаруживает действительный UTF-8 в строках M3U и в противном случае использует Windows-1252. Плейлисты M3U8, PLS и XML продолжают использовать стандартный импортер. Сохраните существующие пользовательские сценарии.

В существующей конфигурации Gerbera под import/scripting/import-function имя функции списка воспроизведения из importPlaylist на mscImportPlaylist измениться. Под import/scripting/script-folder/custom Настроенный каталог должен содержать загруженный файл и постоянно храниться для установки контейнера. На тестовом стенде уступает /var/run/gerbera/custom-js. Затем перезапустите Gerbera и снова импортируйте записи плейлиста. Расширению требуется импортер JavaScript.

MiniDLNA / ReadyMedia 1.3.3: расширения файлов плейлиста.

MiniDLNA 1.3.3 распознает плейлисты с расширением .m3u и .pls. Файлы с расширением .m3u8 не читаются.

Рекомендация: переименуйте M3U, если это возможно.

Если никакая другая конфигурация приложения или сервера не зависит от текущего имени файла M3U8, измените расширение с .m3u8 на .m3u. Это самое простое решение для MiniDLNA. Сохраняйте содержимое, кодировку UTF-8 и местоположение без изменений, чтобы относительные музыкальные пути продолжали работать. Обновите все ссылки на имя файла списка воспроизведения. Затем попросите MiniDLNA снова импортировать список воспроизведения и обновить плагин.

Альтернатива: сохранить общий источник M3U8.

Если другим серверам нужен файл M3U8, создайте дополнительный файл M3U для MiniDLNA. Если он находится в другой папке, измените относительные пути к музыке или используйте абсолютные пути.

Скрипт установки minidlna-playlist-view.py проверяет источник и место назначения, создает производный M3U и добавляет media_dir=A,/media3 к существующей конфигурации MiniDLNA. Он не меняет источник M3U8 или существующие записи media_dir. При конфликте назначения он останавливается. Перезагрузите MiniDLNA и обновите плагин. После изменения исходного списка воспроизведения запустите сценарий и снова перезапустите MiniDLNA, чтобы сохранить актуальное производное представление. Наблюдатель изменений не установлен.

Разрешения кеширования при перестроении

Если MiniDLNA не может очистить свой кэш при перестроении, проверьте права записи в кэше и его подкаталогах.

Для других установок сначала определите фактическую учетную запись службы и настроенный путь к кэшу. После восстановления библиотеки обновите плагин. При необходимости заново зарегистрировать полный список треков с помощью «Поиск в БД → Добавить в базу».

Делитесь аудио и видео

Поделиться с media_dir=A,/srv/music ограничивается звуком. Для обоих типов носителей откройте существующую строку media_dir=AV,/srv/music изменить, получить дополнительные разрешения и перезапустить службу. Ограничения кодека и метаданных остаются независимыми от этого.

Serviio 2.5: освободить необходимые представления

Чтобы были доступны исполнители альбомов и исходный порядок альбомов, отобразите необходимые категории в консоли Serviio.

Порядок треков

Для исходного порядка треков откройте один альбом. Выбранная сортировка столбцов в VirtualDJ может изменить видимый порядок.

В консоли Serviio в разделе «Презентация» → «Аудио» для параметра «Музыка», «Альбомы», «Заголовки» и «Плейлисты» установите значение «Отображать категорию». В других категориях аудио можно использовать «Только отображать контент». Просмотр альбома должен быть доступен для дополнительного запроса. Никаких изменений музыкальных файлов не требуется.

Различные сохраненные исполнители альбомов

Если метаданные альбома или исполнителя Serviio отличаются от тегов файла, перечитайте метаданные на сервере, а затем обновите плагин.

Если существует несколько тегов жанра, принимается только первый.

Если файл имеет несколько тегов жанра, используется только первый. Остальные жанры отсутствуют в возвращенных метаданных и дереве жанров. Это ограничение совместимости не относится только к одному формату файла.

Также читайте видео

Под Библиотека → Общие папки отредактируйте существующую папку библиотеки и в дополнение к Аудио также Видео чтобы включить его. Сохраните долю и Принудительное обновление выполнить. Списки воспроизведения смешанных файлов предоставляются Serviio в отдельных представлениях аудио и видео.

Twonky Сервер 8.5.2: получение полного трека и альбома

Обнаружив структуру Twonky, MusicServer Connect использует полные собственные представления треков и альбомов. В наших проверках глобальный поиск по серверу пропустил семь доступных треков под W и Y. Автоматический резервный вариант также извлекает эти треки и сохраняет порядок альбомов. Никаких дополнительных настроек плагина не требуется. Неполные или противоречивые собственные страницы по-прежнему отклоняются.

Последующая проверка охватывала медиафайлы 149 (аудио 139, десять видео) и все предлагаемые представления без ошибок поиска. Отсутствует поддержка ASX/XSPF, форматы и метаданные остаются ограничениями сервера. Twonky может потребовать новый логин поставщика после перезапуска; уведомление о входе в систему не является музыкальным каталогом.

Universal Media Server 15.8.2: сервис Linux и отображение альбомов.

Для службы Linux установите среду UTF-8, чтобы можно было обрабатывать музыкальные пути, содержащие умлауты и другие символы Юникода.

С systemctl edit DIENSTNAME.service Настройте следующее дополнение для собственной службы UMS. После этого systemctl daemon-reload Запустите, перезапустите эту службу и дождитесь сканирования библиотеки.

[Service]
Environment=LANG=C.UTF-8
Environment=LC_ALL=C.UTF-8

Языковой стандарт C.UTF-8 должен быть доступен в системе. Установка только Java file.encoding не заменяет локаль, используемую для имен файлов. Команда Java, запущенная из интерактивной оболочки, может использовать настройки, отличные от настроек работающей службы.

Прямой доступ к папке с музыкой на Linux позволяет избежать ограничений Windows на имена файлов, например имена, содержащие вопросительный знак.

Исполнители альбомов и поиск по базе данных

Для получения полной информации об исполнителе альбома в UMS.conf активируйте встроенный поиск по базе данных и перезапустите UMS:

search_lucene_use_engine = false

Эта настройка заменяет полнотекстовый поиск Lucene встроенным поиском по базе данных.

Исходный порядок альбомов

Для исходного порядка треков откройте один альбом. Выбранная сортировка столбцов в VirtualDJ может изменить видимый порядок.

UMS объединяет несколько тегов жанра в один текст, разделенный знаком «/». MusicServer Connect создает из него отдельные узлы жанра; трек появляется в каждом из перечисленных жанров. Работа с несколькими жанрами.

Файлы ASX и неполный поиск по каталогу

UMS 15.8.2 может считать файлы списка воспроизведения ASX папками видео, не возвращая соответствующие объекты. Аудиопоиск также может объявлять больше совпадений, чем возвращает, и может исключать OGG из поиска аудиоклассов. MusicServer Connect обнаруживает эти несоответствия и дополняет каталог реальными папками с файлами. Проверенная коллекция аудио- и десяти видеофайлов 141 отображается полностью, с сохранением существующих аудиоидентификаторов и метаданных. Никаких дополнительных настроек не требуется.

Плагин обнаруживает реальные подпапки независимо от неполного поиска SQL. Ранее проверенные страницы поиска используются только для сопоставления псевдонимов. Он сравнивает два полных реестра файлов перед их принятием и снова проверяет наличие изменений в состоянии поиска. Он не пересекает комбинации виртуальных фильтров. Если будущая версия UMS предоставит полные результаты поиска с правильными медиа-классами, плагин автоматически снова использует этот прямой поиск. Исходные файлы библиотеки остаются без изменений.

Этот резервный вариант не восстанавливает отсутствующие метаданные сервера или записи списков воспроизведения: ASX, WPL и XSPF по-прежнему отсутствуют в представлениях списков воспроизведения. UMS исключила первый трек из старых списков M3U/PLS, проверенных здесь. Однако три списка смешанного формата содержат все шесть позиций, включая повторяющиеся аудио- и видеозаписи.

Преобразование и потоковая передача аудио WAV

UMS может перекодировать звук в бит 16 WAV в зависимости от профиля клиента. При последующей проверке четыре семпла содержали полный звук, хотя неограниченные длины WAV не прошли строгую проверку файла. Нормальное декодирование и сравнение после нормализации на бит 16 прошли успешно. Это не доказывает сохранение исходного битового разрешения 24. Запросы очень маленького диапазона могут вернуть пустое значение во время преобразования; нормальные загрузки и запросы 64 KiB работали.

Скрыть лишнюю папку перекодирования

show_transcode_folder = false скрывает виртуальную папку для альтернативных настроек транскодирования. Само перекодирование и сохраненные медиа-теги сохраняются. Сама по себе эта опция отображения не устраняет несогласованное количество страниц UPnP.

MinimServer: BPM/Обновление ключа и библиотеки.

Чтение BPM и ключа из музыкальных файлов

Для предоставления дополнительных тегов вам потребуется полная или пробная лицензия MinimServer. Музыкальные файлы должны содержать теги BPM и KEY или INITIALKEY.

1. На странице конфигурации MinimServer откройте «Свойства».
2. Под itemTags имена BPM,KEY,INITIALKEY дополнение. Сохранять существующие записи; теги должны соответствовать вашим собственным музыкальным файлам. KEY и INITIALKEY рассмотрим: поле MP3 TKEY рассматривается MinimServer как INITIALKEY читается.
3. Сохраните изменения и выполните запрошенный перезапуск сервера.
4. Запустите повторное сканирование в разделе «Состояние». Затем обновите библиотеку в MusicServer Connect.

Дополнительная информация: MinimServer: дополнительные метаданные и Объем лицензии. Advanced Mode WiiM — это функция приложения WiiM; требование полной лицензии здесь касается дополнительных метаданных сервера.

Значения, уже сохраненные в VirtualDJ, могут остаться после изменения. Чтобы перечитать встроенные теги BPM/key, выберите затронутые треки и выберите «Прочитать BPM и ключ из музыкального файла» в контекстном меню. Для свежего аудиоанализа используйте «Анализ BPM и тегов»; если выбрано несколько дорожек, это действие находится в разделе «Пакет».

Перечитать после изменений

Повторно просканируйте MinimServer после изменения музыкальных файлов, тегов или времени модификации. Откройте страницу конфигурации, выберите вкладку «Состояние» и нажмите «Повторное сканирование». Обновляйте статус, пока не появится сообщение «Выполняется», затем обновите MusicServer Connect. Перезапуск только MinimServer обычно не вызывает повторное сканирование.

Устаревший индекс сервера может возвращать заполнители «Измененный или удаленный элемент» без метаданных дорожки или аудиофайлов. Эти заполнители все еще могут быть включены в отчетную сумму. Затем плагин показывает меньше пригодных для использования треков, хотя исполнители альбомов и альбомы остаются известными из существующих серверных контейнеров.

См. Страница конфигурации MinimServer и повторное сканирование а также официальный веб-API для автоматического повторного сканирования.

Объедините один альбом из нескольких папок

Если треки из одного альбома находятся в нескольких папках, MinimServer может доставить несколько альбомов с одинаковым названием. Настройка в разделе «Свойства» mergeFolderAlbums на true до указанного значения, сохраните и перезапустите MinimServer. Название альбома и исполнитель альбома должны совпадать. Этот параметр применяется ко всей библиотеке, а также может объединять другие соответствующие альбомы из нескольких папок. Медиа-файлы не изменяются.

В нашей проверке это объединение «MSC Format Tests 1.3» из подпапок Audio и Video в один альбом с треками 13, распознанными MinimServer. Раньше в обе группы входило одиннадцать и два трека. Затем откройте сервер в WiiM Home и … → Пересканировать музыкальный сервер чтобы обновить собственный индекс приложения. Ярлык может отличаться в зависимости от языка приложения. После этого WiiM Home отобразил в нашей проверке только одну копию примера альбома.

См. MinimServer: альбомы и папки и WiiM Home: снова прочитать медиатеку..

M3U/M3U8: набор символов и отсутствующие записи.

MinimServer ожидает .m3u с Windows-1252 или ISO-8859-1 и .m3u8 с кодировкой UTF-8. Файл UTF-8 с расширением .m3u поэтому может пропускать дорожки, пути которых содержат символы с диакритическими знаками. Используйте M3U8 для путей в Юникоде. Если также необходим M3U, сохраните отдельную копию в соответствующей кодировке. Не заменяйте символы, которые эта кодировка не может представить.

В проверенной коллекции повторное сканирование исправило устаревшую ссылку «Бетти Форд», ранее возвращавшуюся как «Измененный или удаленный элемент», без пригодного для использования звука. Правильная кодировка Windows-1252 дополнительного Sven Väth M3U также восстановила ссылку на акцентированный путь на «W.I.R.» Оба списка затем предоставили все четыре трека в исходном порядке, без полной перестройки каталога. В списках смешанного формата содержалось пять из шести позиций, включая повторы; MKV остался исключенным, поскольку формат не поддерживается.

После повторного сканирования обновите библиотеку в плагине. Источник: MinimServer: форматы плейлистов и наборы символов..

JRiver: импортировать плейлисты и разрешить доступ для чтения.

Импортируйте плейлисты в библиотеку JRiver. Если автоматический импорт музыки пропускает список воспроизведения, импортируйте его отдельно, а затем обновите представление плагина.

Для записи через интерфейс веб-сервиса JRiver необходимо включить аутентификацию. Анонимный доступ на чтение должен оставаться разрешенным: MusicServer Connect использует его для различения обычных и умных плейлистов. Доступ на чтение не дает разрешения на редактирование плейлиста.

В плагине вы можете показать или скрыть умные плейлисты. Скрытое содержимое смарт-плейлиста не запрашивается при построении дерева; они загружаются, когда вы их показываете. Пустые списки и списки без звуковых дорожек не отображаются в качестве музыкальных плейлистов.

Synology: настроить медиасервер по умолчанию.

Стандартный сервер Synology поддерживает WiiM Home Advanced Mode. Для MusicServer Connect также достаточно, если VirtualDJ вычисляет BPM и сам ключ. Для сохраненных значений BPM/key вы можете использовать Gerbera в контейнере . Оба сервера могут читать одни и те же музыкальные файлы.

Установите медиасервер в Центре пакетов и скопируйте свою музыкальную библиотеку в общую папку музыки. Пул носителей и том уже должны существовать.

• Общие настройки: язык меню DMA по желанию, стиль меню DMA Простой стиль; Оставьте интервал отчетов SSDP значением по умолчанию.
• Настройки поиска: установите для формата отображения музыки значение «Только заголовок»; разрешите дополнительные файлы обложек с помощью параметра «Изображение обложки для аудио/видео файлов» и сохраните имена файлов по умолчанию.
• Совместимость с DMA: оставьте транскодирование звука и пользовательские типы MIME отключенными. Разрешите доступ к нужным устройствам.
• После копирования безопасно извлеките USB-накопитель. Папки с альбомами, отдельными треками и плейлистами расположены прямо под музыкой.

Медиасервер Synology объединяет несколько тегов жанра в одно значение, разделенное знаком «;». MusicServer Connect создает отдельные узлы жанров, поэтому каждый трек отображается в каждом указанном жанре. Работа с несколькими жанрами.

Сохраняйте плейлисты с расширением .m3u. В File Station переименуйте файл .m3u8 в разделе «Музыка/Списки воспроизведения» в .m3u, сохранив содержимое UTF-8 и относительные пути. Если M3U8 нужен другим серверам, создайте отдельную копию M3U.

FRITZ!Box: аудиоформаты и исполнители треков

Настройте медиасервер

Подключите USB-накопитель, содержащий музыкальную библиотеку. В интерфейсе FRITZ!Box включите Медиа-сервер в разделе «Домашняя сеть» → «Медиа-сервер», выберите USB-накопитель в качестве источника мультимедиа и примените. Создайте или обновите индекс файлов в разделе «Домашняя сеть» → «USB/Хранилище» или «Хранилище» (NAS) и дождитесь индексации. Затем выберите медиасервер FRITZ!Box в MusicServer Connect.

Аудиоформаты и метаданные

FRITZ!Box может передавать потоковое аудио многих форматов, но читает только некоторые из их тегов. Без поддержки тегов исполнитель альбома, альбом и жанр отсутствуют в дереве библиотеки. Если включено определение исполнителя трека, MusicServer Connect может определить исполнителя по именам в шаблоне «Исполнитель — Имя трека». Файлы остаются доступными через «Все треки», папки и поддерживаемые списки воспроизведения.

Для MP3/WMA в документации поставщика указаны название, исполнитель, альбом, жанр и номер трека, а также ID3 v2.3 или более ранняя версия. Поэтому артист альбома, BPM и ключ не подтверждаются как поддерживаемые поля. VirtualDJ или плеер должен поддерживать аудиоформат для воспроизведения.

Рекомендация: используйте исполнителей треков

Для библиотек с FLAC или других форматов без оценки тегов, даже если они смешаны с MP3, представление Исполнитель трека если имена файлов соответствуют шаблону «Художник — Название Название» соответствовать. Для этого в контекстном меню исходника MusicServer Connect сначала «Определить исполнителя по именам файлов» включи. Затем выберите «Показать исполнителей» и «Переключиться на титул исполнителей», если этот вид еще не активен.

Это обнаружение отключено по умолчанию для новых подключений к серверу и сохраняется для каждого подключения. Чтобы отключить его, выберите «Отключить определение исполнителя треков по именам файлов» в том же меню. Оставьте его отключенным, если имена ваших файлов не следуют за «Исполнитель — Имя трека»: плагин не может определить, является ли текст перед дефисом исполнителем или частью названия.

Когда обнаружение включено, исполнитель отсутствует и имя соответствует шаблону, MusicServer Connect разделяется на первый знак «-». Например, «1st Bass - Slam Me Down» становится исполнителем «1st Bass» и названием «Slam Me Down». Дальнейшие дефисы остаются в заголовке; существующие метаданные исполнителя имеют приоритет. Если этот параметр отключен, это разделение не выполняется, и заголовок, предоставленный сервером, для этой цели остается неизменным. Обнаружение ремиксов — это отдельная настройка.

При переключении MusicServer Connect также обновляет отображение сохраненных заголовков, если название и исполнитель по-прежнему соответствуют одному из двух вариантов, сгенерированных плагином. Другие правки, внесенные вручную, сохраняются. Этот переключатель не изменяет значения BPM, ключа, ремикса или анализа.

Это обнаружение заполняет поле исполнителя и представление исполнителя трека. Он не заменяет теги альбома, исполнителя альбома или жанра. Если ваша библиотека содержит только MP3, WMA или ASF, можно использовать теги, предоставленные сервером, и представление трек-исполнителя не требуется в качестве запасного варианта. Представление «Альбом-исполнитель» полезно только в том случае, если сервер действительно предоставляет необходимую информацию.

Для форматов, теги которых не считываются, FRITZ!Box также не может предоставить сохраненные значения BPM/key. VirtualDJ может рассчитать их самостоятельно. Для полной навигации по библиотеке на основе тегов используйте музыкальный сервер, поддерживающий метаданные для ваших форматов.

Плейлисты

Используйте M3U или PLS. WPL распознается, но может пропускать дорожки, поэтому выберите M3U или PLS для получения надежных полных списков. M3U8, ASX и XSPF не распознаются как списки воспроизведения. Сохраняйте содержимое UTF-8 и действительные относительные пути к музыке. MusicServer Connect удаляет расширение файла и добавленное имя папки из отображаемого имени списка воспроизведения.

Документация производителя: Аудиоформаты, чтение тегов и форматы плейлистов, Сортировка и тегирование версий а также Настройте медиасервер и создайте индекс файлов..

QNAP: запустить стандартный медиасервер и Gerbera параллельно.

Стандартное дополнение QNAP для потоковой передачи мультимедиа поддерживает WiiM Home Advanced Mode. Для MusicServer Connect также достаточно, если VirtualDJ вычисляет BPM и допустимы ключевой и неправильный порядок списка воспроизведения. Для сохраненных значений BPM/key, отдельных жанров и правильного порядка списка воспроизведения вы можете использовать Gerbera с контейнерной станцией быть дополнены.

Установите мультимедийную консоль и надстройку потоковой передачи мультимедиа в Центре приложений. Поместите папки с музыкой в ​​папку Public/music. В «Мультимедийной консоли» → «Управление контентом» выберите «Дополнение Media Streaming» и добавьте «Общедоступный/музыка» в качестве источника контента.

• Индексирование: включить мультимедийную информацию; Нормальный приоритет. Для библиотеки UTF-8 выберите UTF-8, если предлагается, в противном случае оставьте значение по умолчанию.
• Откройте настройки надстройки Media Streaming отдельно. Выберите свою собственную учетную запись пользователя NAS и соответствующий сетевой интерфейс; используйте порт по умолчанию 8200.
• В разделе DLNA Media Renderer разрешите доступ нужному ПК или клиенту.
• В разделе «Настройки просмотра» установите для параметра «Стиль меню по умолчанию» значение «Все категории». В разделе «DLNA Media Renderer» также выберите «Все категории» и свой собственный профиль пользователя для клиента. Примените оба изменения.
• Остановите и запустите надстройку потоковой передачи мультимедиа в Центре приложений. Затем еще раз проверьте разблокировку устройства и при необходимости настройте ее заново.
• Списки воспроизведения доступны как M3U, PLS или WPL; M3U8 не поддерживается. Используйте UTF-8 и допустимые относительные пути. Порядок треков остается неправильным во всех трех форматах.

Имена файлов, содержащие вопросительный знак, могут вызвать проблемы при копировании через Windows/SMB. Скопируйте затронутые файлы непосредственно с USB-накопителя в соответствующую папку с музыкой с помощью QNAP File Station.

Для порядка альбомов храните музыку каждого альбома в одной папке. Для нескольких дисков используйте подпапки, такие как CD 1 и CD 2, с положительными уникальными номерами дорожек. QNAP использует только первый жанр. Порядок плейлистов остается неправильным для M3U, PLS и WPL; переключение между ними не решает эту проблему.

Добавьте Gerbera для MusicServer Connect

Продолжайте использовать существующую библиотеку в разделе Public/music и Gerbera после следуя пошаговым инструкциям . Затем подключитесь к URL-адресу устройства Gerbera в плагине и проверьте треки, теги и порядок. Оставьте надстройку Media Streaming работающей для WiiM Home Advanced Mode или других устройств, выбрав там стандартный сервер QNAP. Используйте Gerbera в MusicServer Connect для BPM/key и исправьте порядок списка воспроизведения. Если WiiM Home также нужны надежные плейлисты с одного и того же сервера, MinimServer является подходящим общим решением. Оба сервиса читают одни и те же музыкальные файлы.

Продавец отмечает: Формат M3U, UTF-8 и относительные пути а также Совместное использование устройств вручную в надстройке потоковой передачи мультимедиа.

QNAP: Шаг за шагом настройте Gerbera с коррекцией WavPack.

Gerbera — это дополнительное программное обеспечение медиа-сервера для вашего QNAP. Ключевым преимуществом MusicServer Connect является доступ к значениям, уже хранящимся в ваших музыкальных файлах: BPM и метаданные музыкальных клавиш: встроенный UPnP-медиасервер QNAP не передаёт эти сведения. Следующие шаги настраивают необходимые сопоставления метаданных.

Поддержка плейлистов также может говорить в пользу Gerbera: Описанный здесь стандартный UPnP-сервер QNAP не отображает списки воспроизведения M3U8. Для признанных форматов M3U, PLS, ASX и WPL порядок дорожек не сохраняется. Поэтому переименование M3U8 в M3U не меняет порядок. Gerbera — альтернатива, если вам нужен M3U8 или точный порядок воспроизведения.

Когда вам не нужен Gerbera? Если в ваших файлах нет сохраненных значений BPM/key и порядок плейлистов неважен, Gerbera для этих целей не нужен. VirtualDJ может рассчитывать BPM и музыкальную тональность, анализируя файлы без музыкального сервера. Вы можете сохранить встроенный медиасервер QNAP и позволить VirtualDJ их вычислять.

Собственный медиа-сервер QNAP может продолжать работать вместе с Gerbera, например, для WiiM Home Advanced Mode. Gerbera не поддерживает этот режим WiiM. Ваша музыка останется в существующей папке; Gerbera получает доступ только для чтения. Это руководство также позволяет автоматически обнаруживать новые и измененные файлы.

Рекомендуемая версия: В этом руководстве используется официальная сборка Gerbera Git. 3.3.0-77 из исходной версии 245e723. Образ Docker устанавливается с помощью тега и контрольной суммы SHA-256; он содержит исправления, уже примененные к WavPack и повторяющиеся названия плейлистов а также несколько жанров в WebM/WMV и более высокая точность BPM. В случае обновления с существующей конфигурацией это тоже Добавить сопоставления читателей. Согласно 3.3.0, это статус разработки, а не новая стабильная версия.

Gerbera 3.3.0 неверен во время импорта WavPack: Неизмененный образ 3.3.0 можно прочитать при чтении из .wvфайлы. В используемой здесь сборке затронутая память выделяется в куче. WavPack остается полностью работоспособным; дополнительный сценарий исправления не требуется. Используйте полную ссылку на изображение, показанную выше.

1. Подготовьте папки, пользователей и файлы

1. Войдите в QTS, используя активную учетную запись администратора, пароль которой вы знаете. Встроенный аккаунт admin для этого не обязательно активировать; достаточно другой авторизованной учетной записи администратора.
2. Установить в Центр приложений приложение Контейнерная станция. Откройте его и завершите первоначальную настройку. Мультимедийная консоль и надстройка потоковой передачи мультимедиа не требуются для Gerbera.
3. Создать под Панель управления → Разрешения → Пользователи → Создать. пользователь gerbera . Этому пользователю не нужны права администратора. Предоставьте ему доступ для чтения к музыкальному ресурсу, включая его папки и файлы. Продолжайте использовать свою учетную запись администратора для SSH.
4. В примерах используется папка с музыкой Public/music, на NAS /share/Public/music. Для другого общего ресурса используйте свой фактический путь. Ваша существующая музыка может остаться там. Удалите недопустимые символы Windows, например ? из названий файлов и при необходимости откорректируйте ссылки на плейлисты; теги заголовков могут по-прежнему содержать эти символы.
5. Создать в Файловая станция под Public папка gerbera-qnap и его пустая подпапка empty .
6. Загрузите Создать файл как compose.yaml . Загрузите его непосредственно через File Station на Public/gerbera-qnap рядом с папкой empty. Имя файла должно compose.yaml без доп. .txt.

2. Включите SSH и получите доступ root.

1. Открыть в QTS Панель управления → Сеть и файловые службы → Telnet/SSH..
2. Включить Разрешить SSH-соединение, покиньте порт в 22 и нажмите Применить. Если Изменить права доступа предлагается, разрешите доступ к этой учетной записи администратора. Если брандмауэр NAS активен, порт SSH вашего компьютера должен быть разрешен в локальной сети.
3. Откройте терминал на Windows-PC или PowerShell на терминале Mac. Замените в следующей команде DEIN_QTS_KONTO через учетную запись администратора и NAS_IP с IP-адресом QNAP.

ssh DEIN_QTS_KONTO@NAS_IP

При первом установлении соединения проверьте отображаемый адрес назначения и подтвердите запрос, нажав yes. Введите пароль своей учетной записи QTS. При вводе не отображаются символы и звездочки. Используйте, если используется другой порт SSH. ssh -p PORTNUMMER DEIN_QTS_KONTO@NAS_IP.

Затем переключитесь на root-права:

sudo -i
id

Если вы снова попросите свой пароль, используйте тот же пароль из вашей зарегистрированной учетной записи QTS. Специальный пароль root не требуется. Выход id должен uid=0 включено; на QNAP можно найти соответствующее имя пользователя admin . Если появится меню управления, выйдите из него, используя опцию «Оболочка» или «Выход». Оставьте терминал открытым во время установки: все следующие команды терминала выполняются на QNAP.

Определите идентификаторы пользователя, созданного для доступа к музыке:

id gerbera

Если вывод показывает uid=1001(gerbera) gid=100(everyone) есть UID 1001 и GID 100. Запишите свои собственные номера для файла компоновки.

3. Настроить файл создания

Откройте скачанный compose.yaml с помощью текстового редактора замените значения примера на UID и GID через цифры из шага 2 и перезагрузите сохраненный файл Public/gerbera-qnap высокий. Сопоставление музыки изначально указывает на пустую папку. Существующая музыка импортируется только после настройки метаданных.

services:
  gerbera:
    image: gerbera/gerbera:sha-245e723@sha256:b4463e92ee6cc0c6338b91d822904cb894dd66480e4eed60930fad1b69378e09
    container_name: gerbera-qnap
    network_mode: host
    restart: unless-stopped
    environment:
      # Beispielwerte: durch UID und GID aus "id gerbera" ersetzen.
      UID: "1001"
      GID: "100"
    command:
      - gerbera
      - --interface
      - eth0
      - --port
      - "49494"
      - --config
      - /var/run/gerbera/config.xml
    volumes:
      - gerbera-data:/var/run/gerbera
      # Zuerst den leeren Ordner verwenden; in Schritt 7 auf /share/Public/music aendern.
      - /share/Public/gerbera-qnap/empty:/mnt/content:ro

volumes:
  gerbera-data:

Официальное изображение выбирает соответствующий вариант ARM64 или AMD64 для поддерживаемых моделей NAS. Шаблон не содержит фиксированного IP-адреса NAS. --interface eth0 использует адрес этого сетевого интерфейса. Для устройств с несколькими портами, виртуальными коммутаторами или объединением портов замените eth0 через интерфейс, фактически используемый для домашней сети. network_mode: host включает обнаружение UPnP в сети NAS.

/mnt/content:ro остается неизменным как путь к контейнеру и позволяет только читать музыку. Объем gerbera-data сохраняет настройки и базу данных навсегда. restart: unless-stopped запускает контейнер снова после перезапуска NAS, если он не был остановлен вручную заранее.

4. Запустить приложение с пустой библиотекой

1. Открыть Контейнерная станция → Приложения → Создать. Используйте имя gerbera-qnap.
2. Добавьте полный контент вашего индивидуального compose.yaml в поле YAML. Оставьте отступы пробелами и нажмите Подтвердить.
3. Создайте и запустите приложение. Первая загрузка изображения может занять некоторое время. Подождите, пока gerbera-qnap отображается как активный.
4. Открыть http://NAS_IP:49494/ в вашем браузере. Отсутствующий URL-адрес веб-сайта в Container Station не препятствует прямому доступу. На этом этапе библиотека Gerbera намеренно пуста.

5. Настройте BPM, отображение ключа и названия.

Открыть в Gerbera Конфигурация и выберите в Список моды вид Эксперт. Под Library Options → taglib Library Options → метаданные и под ffmpeg Library Options → Метаданные следующие отображения. Сохраните другие существующие линии.

1. Под Сервер → Имя имя Gerbera QNAP а. Таким образом, сервер позже можно будет отличить от других музыкальных серверов.
2. Для AIFF ниже Импорт → Сопоставления → Mimetype-ContentType два задания audio/x-aiff → aiff и audio/aiff → aiff дополнение. Без этих присвоений BPM, ключевые и другие жанры могут отсутствовать, несмотря на существующие теги. Конфигурация AIFF.
3. Для OGV ниже ffmpeg Library Options вариант streams-enabled Активируйте, чтобы теги считывались с аудио и видео дорожек. Конфигурация OGV.
4. Установите поле для taglib и ffmpeg. charset на UTF-8. Также filesystem-charset, metadata-charset и playlist-charset должен UTF-8 использовать.
5. Под UPnP → Название элемента результата очистить поле с помощью M_ARTIST и получить M_TITLE. Это обеспечивает простое название дорожки.
6. Под WavPack Library Options остается Включено включен.
7. Нажмите на Сохранить конфигурацию, перезапустите пустой контейнер в Container Station и после повторного открытия конфигурации проверьте, что значения сохранены.

BPM и Key уже должны быть сохранены в музыкальных файлах; Gerbera не вычисляет эти значения. Для MP4/M4A/M4V в существующем id3элемент prefer_highest_bpm_accuracy="yes" и prefer_ambigous_bpm_value="bpm_tag" согласно Настройка точности BPM до указанных значений. Без первого варианта предыдущее поведение сохраняется. Обычное повторное сканирование может пропускать файлы, которые уже были импортированы и не были изменены. Настройте эти параметры перед первым импортом музыки. Отдельные теги жанра не требуют дополнительной настройки.

6. Включить автоматические обновления

Gerbera уже автоматически отслеживает новые и измененные файлы. Добавьте обнаружение изменений атрибутов файла с помощью этого полного блока в открытом корневом терминале:

docker exec -i -u 0 gerbera-qnap /bin/sh <<'GERBERA'
set -eu
file=/var/run/gerbera/autoscan.xml
test -f "$file"
sed -i -e 's/inotify-attrib="no"/inotify-attrib="yes"/g' \
  -e '/<autoscan/ { /inotify-attrib=/! s/<autoscan/<autoscan inotify-attrib="yes"/; }' \
  "$file"
cat "$file"
GERBERA

В начале вывода раздела автосканирования необходимо inotify-attrib="yes" стоять. Этот параметр находится в постоянном томе данных и будет загружен при следующем запуске.

7. Смонтируйте папку с музыкой и запустите Gerbera.

1. Остановить проект или приложение gerbera-qnap на Контейнерной станции.
2. Открыть Public/gerbera-qnap/compose.yaml в Файловой станции. Заменяйте только пустое сопоставление папок настоящей музыкальной папкой, например:

- /share/Public/music:/mnt/content:ro

Сохраните файл на NAS, затем скопируйте весь следующий блок в открытый терминал root. Он применяет измененный файл Compose, повторно использует существующий том данных и запускает Gerbera. Если путь вашего проекта отличается, откорректируйте первую строку cd … дальше. Этот процесс также применим к файлам WavPack.

cd /share/Public/gerbera-qnap &&
PROJECT=$(docker inspect --format '{{index .Config.Labels "com.docker.compose.project"}}' gerbera-qnap) &&
case "$PROJECT" in ''|'<no value>') printf 'Compose-Projekt nicht gefunden.\n' >&2; false ;; *) true ;; esac &&
if docker compose version >/dev/null 2>&1; then
  docker compose -p "$PROJECT" -f compose.yaml create --force-recreate gerbera
elif command -v docker-compose >/dev/null 2>&1; then
  docker-compose -p "$PROJECT" -f compose.yaml create --force-recreate gerbera
else
  COMPOSE_BIN=
  for candidate in /share/*/.qpkg/container-station/bin/docker-compose; do
    if [ -x "$candidate" ]; then COMPOSE_BIN=$candidate; break; fi
  done
  if [ -n "$COMPOSE_BIN" ]; then
    "$COMPOSE_BIN" -p "$PROJECT" -f compose.yaml create --force-recreate gerbera
  else
    printf 'Docker Compose wurde nicht gefunden. Container Station pruefen.\n' >&2
    false
  fi
fi &&
docker start gerbera-qnap

Тогда открой его http://NAS_IP:49494/ и дождитесь загрузки библиотеки. Вы можете увидеть прогресс ниже Контейнерная станция → Контейнер → gerbera-qnap → Протокол. Продолжайте копировать в папку с музыкой только полностью подготовленные файлы. Для списков воспроизведения требуются действительные относительные пути к файлам и кодировка UTF-8.

8. Подключить MusicServer Connect

В MusicServer Connect выбираем сервер Gerbera QNAP. Используйте для ручного подключения http://NAS_IP:49494/description.xml. Проверьте инвентарь треков, сохраненные значения BPM/key и порядок ваших плейлистов.

Если у вас возникли проблемы с подключением, проверьте состояние контейнера, IP-адрес NAS, сетевой интерфейс и возможные конфликты портов. Для обнаружения UPnP необходимо UDP 1900, для веб-интерфейса и доступа к мультимедиа TCP 49494 быть доступным в локальной сети. В Permission denied управлять UID, GID и разрешениями на чтение пользователя Gerbera. Путь /content в протоколе Gerbera это нормально для официального образа.

Выйдите из терминала с помощью exit; после sudo -i обычно это требуется дважды. Если вам не нужен SSH, удалите его в QTS. Панель управления → Сеть и файловые службы → Telnet/SSH. флажок для Разрешить SSH-соединение и нажмите Применить.

9. Перезапуски и новые версии Gerbera

Для обычной перезагрузки выберите Контейнерная станция → Контейнер → gerbera-qnap → Перезапустить. Настройки и база данных остаются в указанном томе данных. gerbera-data получил. При пересборке контейнера используется неизмененный исполняемый файл из официального образа.

Переход с существующей установки 3.3.0

Используйте полную ссылку на изображение из этого руководства и сохраните настройки музыки, идентификаторы пользователей, названия проектов и объемы данных. Воссоздайте контейнер, как показано ниже. Простой перезапуск не устанавливает другой образ. Замена контейнера удаляет все предыдущие локальные двоичные исправления.

Обновите до стабильной версии позже

1. Выбирайте на официальная страница релиза Gerbera стабильная версия, включающая исправление WavPack ПР #3981 . Прочтите примечания к конфигурации и базе данных. Пока такой выпуск не доступен, версия Git, явно указанная здесь, является фиксированной промежуточной сборкой. Не используйте движущийся latest- или edgeтег.
2. Открыть Public/gerbera-qnap/compose.yaml. Замените это Полная стоимость после image: через gerbera/gerbera:NEUE_VERSION. Это также включает в себя удаление предыдущих @sha256:…ссылку, так как она принадлежит старому изображению. Заменить NEUE_VERSION с выбранным номером версии. Альтернативно используйте полную ссылку на изображение из обновленного руководства. Все остальные настройки оставьте без изменений.
3. При необходимости включите SSH, как описано выше, и войдите в корневой терминал. Загрузите выбранное изображение:

docker pull gerbera/gerbera:NEUE_VERSION

4. Остановите существующий проект или приложение в Container Station. Запустите полный командный блок Шаг 7 вне. Существующий том данных нельзя удалять.
5. Дождитесь запуска и завершения обновления базы данных. Проверьте версию, имя и протокол сервера, а также сохраненные настройки BPM/key. Подключите MusicServer Connect и проверьте несколько треков, файлов WavPack и плейлистов.

Руководства для продавцов: Контейнерная станция QNAP и изменения YAML, Включите SSH на QNAP, Создать пользователя QTS, официальный образ Docker Gerbera.

Synology: Шаг за шагом настройте Gerbera с коррекцией WavPack.

Gerbera — это дополнительное программное обеспечение медиа-сервера для вашего Synology. Ключевым преимуществом MusicServer Connect является доступ к значениям, уже хранящимся в ваших музыкальных файлах: BPM и метаданные музыкальных клавиш: встроенный UPnP-медиасервер Synology не передаёт эти сведения. Следующие шаги настраивают необходимые сопоставления метаданных.

Когда вам не нужен Gerbera? Если ваши музыкальные файлы не содержат сохраненных значений BPM/клавиш, для этой цели вам не нужен Gerbera. VirtualDJ может рассчитать BPM и музыкальную тональность, анализируя файлы без музыкального сервера. Вы можете продолжать использовать встроенный медиасервер Synology и позволить VirtualDJ их вычислить.

Собственный медиа-сервер Synology может продолжать работать вместе с Gerbera, например, для WiiM Home Advanced Mode. Gerbera не поддерживает этот режим WiiM. Ваша музыка останется в существующей папке; Gerbera получает доступ только для чтения. Это руководство также позволяет автоматически обнаруживать новые и измененные файлы.

Рекомендуемая версия: В этом руководстве используется официальная сборка Gerbera Git. 3.3.0-77 из исходной версии 245e723. Образ Docker устанавливается с помощью тега и контрольной суммы SHA-256; он содержит исправления, уже примененные к WavPack и повторяющиеся названия плейлистов а также несколько жанров в WebM/WMV и более высокая точность BPM. В случае обновления с существующей конфигурацией это тоже Добавить сопоставления читателей. Согласно 3.3.0, это статус разработки, а не новая стабильная версия.

Gerbera 3.3.0 неверен во время импорта WavPack: Неизмененный образ 3.3.0 можно прочитать при чтении из .wvфайлы. В используемой здесь сборке затронутая память выделяется в куче. WavPack остается полностью работоспособным; дополнительный сценарий исправления не требуется. Используйте полную ссылку на изображение, показанную выше.

1. NAS и подготовьте пользователей

1. Войдите в интерфейс DSM Synology с учетной записью, принадлежащей группе. администратор услышал. Это учетная запись, которой разрешено управлять пакетами и пользователями. Имя учетной записи не обязательно admin читать. Если ваша учетная запись не имеет этих прав, вам понадобится человек, который управляет NAS.
2. Откройте это Центр посылок и установить Менеджер контейнеров. Если этот пакет недоступен для вашей модели, данное руководство к ней не применимо. Чтобы отредактировать файл YAML, вы можете дополнительно установить пакет Synology. Текстовый редактор установить.
3. Открыть Панель управления → Пользователи и группы → Пользователи → Создать.. Создать пользователя gerbera дальше. Он не требует прав администратора. Назначьте свой собственный пароль; Вы продолжите использовать свою учетную запись администратора DSM для следующих команд терминала.
4. Открыть Панель управления → Общая папка, выберите папку с музыкой, например musicи выберите Редактировать → Разрешения. Отдать пользователю gerbera разрешение Только чтение. Доступ также должен распространяться на включенные музыкальные папки и файлы.

В примерах используется /volume1/music как папка с музыкой и /volume1/docker для файлов-контейнеров. Если эти папки находятся на другом томе, используйте их фактические пути NAS в соответствующих местах. Пути к контейнерам /mnt/content и /var/run/gerbera оставайся прежним.

2. Создавайте папки и копируйте файлы

1. Открыть Файловая станция. В общей папке создайте docker подпапка gerbera-synology . Если общая папка docker отсутствует, создайте его под Панель управления → Общая папка → Создать. .
2. Создайте еще одну подпапку с именем empty дальше. Эта папка остается пустой. Она служит временной папкой с музыкой, поэтому импорт начинается только после установки метаданных.
3. Загрузите Создать файл как compose.yaml к вашему компьютеру.
4. Загрузите файл, используя Файловая станция → Загрузить прямо в docker/gerbera-synology рядом с папкой empty. Имя файла должно быть точно compose.yaml без каких-либо дополнительных .txt быть прикрепленным.

Папка проекта содержит эти две записи:

gerbera-synology/
├── compose.yaml
└── empty/

3. Активируйте SSH, войдите в NAS и определите свои идентификаторы.

Вам понадобится терминальный доступ к NAS, чтобы найти идентификаторы пользователей и выполнить следующие команды Docker. Вы можете скопировать показанные здесь команды; знание программирования не требуется.

Проверьте учетную запись и пароль DSM

1. Открыть в DSM Панель управления → Пользователь и группа → Пользователь. Выделите учетную запись, которую вы хотите использовать для последующего входа через SSH, и нажмите Редактировать.
2. Аккаунт должен быть активирован: При необходимости снимите выделение Деактивировать эту учетную запись пользователя. После сохранения в списке пользователей должен отображаться статус Нормальный вместо этого Отключено показаны.
3. Под Группы пользователей аккаунт должен принадлежать администратор группа. Вам понадобится пароль этой учетной записи, чтобы войти в систему и позже переключиться на root. Если вы его не знаете, установите и подтвердите новый пароль в настройках учетной записи. Сохраните изменения.

Для этого вы можете использовать существующую учетную запись администратора DSM. Вам конкретно нужна встроенная учетная запись admin Чтобы использовать его, активируйте эту учетную запись, как описано, и назначьте известный пароль. Встроенный аккаунт admin не требует активации, если у вас есть еще одна активная учетная запись из группы administrators использовать. Пользователь, созданный на шаге 1. gerbera используется исключительно для доступа к музыке и не требует этих прав администратора.

Включите службу SSH на NAS.

1. В DSM откройте Панель управления и там Терминал и SNMP. Выберите вкладку Терминал.
2. Установите флажок для Включить службу SSH. Для этого руководства оставьте порт в 22 показаны.
3. Нажмите на Применить. Только тогда NAS будет принимать SSH-соединения. Если брандмауэр DSM активен, он должен разрешить порт SSH, установленный для вашего компьютера в локальной сети.

Войдите со своего компьютера и переключитесь на root.

1. IP-адрес NAS можно найти по адресу Панель управления → Сеть → Сетевой интерфейс. Открыть на ПК Windows Терминал или PowerShell; на Mac приложение Терминал.
2. Введите эту команду. Заменить DEIN_DSM_KONTO с вашей учетной записью администратора DSM и NAS_IP с вашим IP-адресом NAS. Не используйте вновь созданного пользователя gerbera.

ssh DEIN_DSM_KONTO@NAS_IP

Когда соединение устанавливается в первый раз, может появиться запрос на идентификацию NAS. Проверьте отображаемый адрес назначения и подтвердите соединение с помощью yes. Затем введите пароль для своей учетной записи DSM. При вводе пароля не отображаются символы или звездочки; это нормально. Если вы используете другой порт SSH, добавьте его при подключении. -p PORTNUMMER.

Затем переключитесь на права, необходимые для Docker, с помощью этой команды:

sudo -i

Если вас снова попросят ввести пароль, используйте тот же пароль вашей учетной записи DSM. Специальный пароль root не требуется. Подсказка обычно заканчивается #. Держите это окно терминала открытым во время установки. Все последующие команды терминала выполняются на NAS.

Для Connection refused Сначала проверьте, используете ли вы службу SSH. Применить включен и использует правильный IP-адрес и номер порта. Если пароль отклонен, проверьте имя учетной записи, пароль, статус Нормальный и членство в администратор. Руководство Synology по входу в систему SSH с правами root также описывает этот процесс.

Просмотр идентификаторов пользователей Gerbera:

id gerbera

Вывод, например uid=1030(gerbera) gid=100(users) означает: UID — это 1030, GID — это 100.. Обратите внимание на цифры из вашего собственного вывода: они идентифицируют пользователя и группу.

4. Настроить файл создания

В File Station откройте файл docker/gerbera-synology/compose.yaml с Текстовый редактор. Либо отредактируйте его на своем компьютере и загрузите снова. Для UID и GID введите только что записанные цифры; вам необходимо заменить значения примера ниже. При необходимости измените путь NAS к пустой папке проекта. Сохраните файл.

services:
  gerbera:
    image: gerbera/gerbera:sha-245e723@sha256:b4463e92ee6cc0c6338b91d822904cb894dd66480e4eed60930fad1b69378e09
    container_name: gerbera-synology
    network_mode: host
    restart: unless-stopped
    environment:
      # Beispielwerte: durch UID und GID aus "id gerbera" ersetzen.
      UID: "1026"
      GID: "100"
    command:
      - gerbera
      - --port
      - "49494"
      - --config
      - /var/run/gerbera/config.xml
    volumes:
      - gerbera-synology-data:/var/run/gerbera
      # Zuerst den leeren Ordner verwenden; in Schritt 8 auf /volume1/music aendern.
      - /volume1/docker/gerbera-synology/empty:/mnt/content:ro

volumes:
  gerbera-synology-data:

network_mode: host включает обнаружение в домашней сети без фиксированного IP-адреса в YAML. Конец :ro Gerbera позволяет только читать папку с музыкой. В объеме gerbera-synology-data Настройки и база данных сохраняются навсегда. restart: unless-stopped позволяет контейнеру NAS снова запуститься после перезапуска NAS, если вы заранее не остановили его вручную.

5. Запустите проект с пустой библиотекой

1. Открыть Диспетчер контейнеров → Проект → Создать. Используйте именно это имя проекта: gerbera-synology и подготовленная папка в качестве пути docker/gerbera-synology.
2. Выбирайте готовый compose.yaml как существующий файл Compose. Если в диалоговом окне есть редактор YAML, вы можете вставить туда контент.
3. Для Настройки веб-портала остается Настройка веб-портала через веб-станцию выключен. Нажмите на Далее и создайте и запустите проект. Первая загрузка изображения может занять некоторое время.
4. Под Контейнер → gerbera-synology должен быть статус Бег или Бег появиться.
5. Открыть в браузере http://NAS_IP:49494/, например http://192.168.1.10:49494/. Замените пример адреса на свой IP-адрес NAS. Вы видите поверхность Gerbera; музыкальная библиотека на данный момент намеренно пуста.

6. Настройте BPM, отображение ключа и названия.

Открыть в Gerbera Конфигурация и выберите вид Эксперт. Под Library Options → taglib Library Options → метаданные а также под ffmpeg Library Options → Метаданные добавьте следующие строки, сохранив другие существующие сопоставления.

1. Под Сервер → Имя имя Gerbera Synology а. Таким образом, сервер позже можно будет отличить от других музыкальных серверов.
2. Для AIFF ниже Импорт → Сопоставления → Mimetype-ContentType два задания audio/x-aiff → aiff и audio/aiff → aiff дополнение. Без этих присвоений BPM, ключевые и другие жанры могут отсутствовать, несмотря на существующие теги. Конфигурация AIFF.
3. Для OGV ниже ffmpeg Library Options вариант streams-enabled Активируйте, чтобы теги считывались с аудио и видео дорожек. Конфигурация OGV.
4. Установить поле charset для taglib и ffmpeg UTF-8. Также filesystem-charset, metadata-charset и playlist-charset должен UTF-8 использовать.
5. Под UPnP → Название элемента результата очистить поле с помощью M_ARTIST и получить M_TITLE. Чистое название заголовка передается как заголовок вместо «Исполнитель – Название».
6. Под WavPack Library Options остается Включено включен.
7. Нажмите на Сохранить конфигурацию, перезапустите контейнер в диспетчере контейнеров и убедитесь, что значения сохранены после повторного открытия конфигурации Gerbera.

BPM и Key уже должны быть сохранены в музыкальных файлах; эти настройки не рассчитывают значения. Для MP4/M4A/M4V в существующем id3элемент prefer_highest_bpm_accuracy="yes" и prefer_ambigous_bpm_value="bpm_tag" согласно Настройка точности BPM до указанных значений. Без первого варианта предыдущее поведение сохраняется. Затем снова импортируйте затронутые файлы.

7. Включить автоматические обновления

Gerbera уже автоматически отслеживает новые и измененные файлы. С помощью следующего блока вы можете добавить обнаружение изменений атрибутов файла. Скопируйте весь блок во все еще открытый терминал NAS:

docker exec -i -u 0 gerbera-synology /bin/sh <<'GERBERA'
set -eu
file=/var/run/gerbera/autoscan.xml
test -f "$file"
sed -i -e 's/inotify-attrib="no"/inotify-attrib="yes"/g' \
  -e '/<autoscan/ { /inotify-attrib=/! s/<autoscan/<autoscan inotify-attrib="yes"/; }' \
  "$file"
cat "$file"
GERBERA

В выводе должно быть начало раздела автосканирования inotify-attrib="yes" стоять. Файл находится в постоянном томе данных. Настройка будет загружена вместе с музыкальной папкой при последующем ее запуске.

8. Смонтируйте папку с музыкой и запустите Gerbera.

1. Остановить проект или приложение gerbera-synology в диспетчере контейнеров.
2. Открыть docker/gerbera-synology/compose.yaml в Файловой станции. Заменяйте только пустое сопоставление папок настоящей музыкальной папкой, например:

- /volume1/music:/mnt/content:ro

Сохраните файл на NAS, затем скопируйте весь следующий блок в открытый терминал root. Он применяет измененный файл Compose, повторно использует существующий том данных и запускает Gerbera. Если путь вашего проекта отличается, откорректируйте первую строку cd … дальше. Этот процесс также применим к файлам WavPack.

cd /volume1/docker/gerbera-synology &&
if docker compose version >/dev/null 2>&1; then
  docker compose -p gerbera-synology -f compose.yaml create --force-recreate gerbera
elif command -v docker-compose >/dev/null 2>&1; then
  docker-compose -p gerbera-synology -f compose.yaml create --force-recreate gerbera
elif [ -x /var/packages/ContainerManager/target/usr/bin/docker-compose ]; then
  /var/packages/ContainerManager/target/usr/bin/docker-compose \
    -p gerbera-synology -f compose.yaml create --force-recreate gerbera
else
  printf 'Docker Compose wurde nicht gefunden. Container Manager pruefen.\n' >&2
  false
fi &&
docker start gerbera-synology

Тогда открой его http://NAS_IP:49494/ и дождитесь загрузки библиотеки. Вы можете увидеть прогресс ниже Диспетчер контейнеров → Контейнер → gerbera-synology → Протокол. Продолжайте копировать в папку с музыкой только полностью подготовленные файлы. Для списков воспроизведения требуются действительные относительные пути к файлам и кодировка UTF-8.

9. Свяжитесь с MusicServer Connect

В MusicServer Connect выбираем сервер Gerbera Synology. Если необходим URL-адрес устройства, используйте http://NAS_IP:49494/description.xml. Проверьте свои песни, альбомы и плейлисты и откройте несколько песен с сохраненными BPM и значениями клавиш.

Если интерфейс недоступен или сервер не найден, сначала проверьте статус контейнера и IP-адрес NAS. Если брандмауэр DSM активирован TCP 49494 и для обнаружения UPnP UDP 1900 из вашей локальной сети. Если журнал сообщает Permission denied для папки с музыкой проверьте разрешение пользователя на чтение gerbera и UID и GID с шага 3. Путь /content в протоколе нормальное для официального изображения; это относится к встроенной музыкальной папке.

После этого выйдите из терминала с помощью exit уйти; после sudo -i обычно в два раза exit необходимо. Если вам не нужен SSH, откройте его в DSM. Панель управления → Терминал и SNMP → Терминал, снимите флажок Включить службу SSH и нажмите Применить.

10. Перезапуски и новые версии Gerbera

Для обычной перезагрузки выберите Диспетчер контейнеров → Контейнер → gerbera-synology → Перезапустить. Настройки и база данных остаются в указанном томе данных. gerbera-synology-data получил. При пересборке контейнера используется неизмененный исполняемый файл из официального образа.

Переход с существующей установки 3.3.0

Используйте полную ссылку на изображение из этого руководства и сохраните настройки музыки, идентификаторы пользователей, названия проектов и объемы данных. Воссоздайте контейнер, как показано ниже. Простой перезапуск не устанавливает другой образ. Замена контейнера удаляет все предыдущие локальные двоичные исправления.

Обновите до стабильной версии позже

1. Выбирайте на официальная страница релиза Gerbera стабильная версия, включающая исправление WavPack ПР #3981 . Прочтите примечания к конфигурации и базе данных. Пока такой выпуск не доступен, версия Git, явно указанная здесь, является фиксированной промежуточной сборкой. Не используйте движущийся latest- или edgeтег.
2. Открыть docker/gerbera-synology/compose.yaml. Замените это Полная стоимость после image: через gerbera/gerbera:NEUE_VERSION. Это также включает в себя удаление предыдущих @sha256:…ссылку, так как она принадлежит старому изображению. Заменить NEUE_VERSION с выбранным номером версии. Альтернативно используйте полную ссылку на изображение из обновленного руководства. Все остальные настройки оставьте без изменений.
3. При необходимости включите SSH, как описано выше, и войдите в корневой терминал. Загрузите выбранное изображение:

docker pull gerbera/gerbera:NEUE_VERSION

4. Остановите существующий проект или приложение в Container Manager. Запустите полный командный блок Шаг 8 вне. Существующий том данных нельзя удалять.
5. Дождитесь запуска и завершения обновления базы данных. Проверьте версию, имя и протокол сервера, а также сохраненные настройки BPM/key. Подключите MusicServer Connect и проверьте несколько треков, файлов WavPack и плейлистов.

Руководства для продавцов: Проекты менеджера контейнеров, Доступные модели NAS для Container Manager, SSH вход с правами администратора, Официальное изображение Gerbera.

WiiM Home: расширенная медиатека

WiiM Home Advanced Mode предоставляет собственную библиотеку с категориями альбомов, исполнителей и треков. Поддерживаемые серверы включают MinimServer, стандартный сервер Synology, стандартный сервер QNAP и Serviio. Gerbera в настоящее время обеспечивает просмотр папок в WiiM Home.

В Advanced Mode WiiM импортирует метаданные сервера в свой собственный индекс, затем создает единые представления альбомов, исполнителей, треков, плейлистов и жанров, а также собственный поиск. В Legacy Mode вместо этого отображается навигация сервера. Эти термины описывают режимы работы WiiM Home.

Рекомендация для обмена

Стандартные серверы Synology и QNAP поддерживают WiiM Home Advanced Mode, для которого не требуется BPM или ключевые метаданные. Неправильный порядок списка воспроизведения QNAP остается ограничением и в WiiM Home.

Если VirtualDJ вычисляет BPM и сам ключ, то для MusicServer Connect достаточно стандартного медиа-сервера Synology. То же самое относится и к QNAP, если его неправильный порядок в списке воспроизведения приемлем. В этих случаях дополнительная установка Gerbera не требуется.

Чтобы использовать сохраненные значения BPM/key или сохранить порядок списка воспроизведения QNAP в MusicServer Connect, вы можете добавить Gerbera с исправлением WavPack в Docker. В плагине выберите Gerbera и стандартный сервер в WiiM Home Advanced Mode. Оба могут читать одну и ту же музыкальную библиотеку. MinimServer остается односерверным решением, удовлетворяющим этим требованиям, а WiiM Home Advanced Mode; ему по-прежнему требуется дополнительная конфигурация BPM/key tag. Для запуска Gerbera на Synology требуется доступный диспетчер контейнеров.

Дополнительная информация: WiiM Home: Медиа-библиотека и поддерживаемые серверы..

Ampache 7/8: чтение видео и плейлистов файлов.

Музыкальный каталог не импортирует видео в Ampache. Для видеотеки дополнительный локальный каталог с типом медиа Видео и отсканируйте его. Пути к каталогам не должны перекрываться. Поэтому в нашей установке используется дополнительное представление каталога Linux, доступное только для чтения, указывающее на те же видеофайлы; файлы общей библиотеки остаются неизменными.

Явно импортируйте плейлисты на основе файлов. Официальная команда CLI: php bin/cli run:updateCatalog -i "Katalogname"; используйте версию PHP и учетную запись службы, соответствующие вашей установке. Одного повторного сканирования метаданных недостаточно. В нашем сравнении обе версии содержали аудиозаписи с повторами; видеозаписи отсутствовали в списках воспроизведения смешанных файлов.

Доставить MP3 без изменений

Если автоматическое преобразование MP3 разрешено, но конвертер не настроен, Ampache 8 может возвращать HTTP 500 при потоковой передаче. Для неизмененной поставки в существующей конфигурации, transcode_mp3 = "false" до указанного значения. Альтернативно настройте работающий транскодер. Когда преобразование MP3 отключено, в ходе наших проверок потоковая передача и загрузка проверялись побайтно.

LMS: Плейлисты с треками из одного альбома.

В настройках LMS под Разное вариант Пропускать плейлисты, содержащие треки из одного альбома. если вы хотите, чтобы эти плейлисты отображались. Затем перезагрузите библиотеку. Сравнение подтвердило, что повторяющиеся звуковые дорожки подаются в исходном порядке.

Asset UPnP: папки мультимедиа и плейлистов.

В веб-интерфейсе ресурса по адресу Папки → Медиа-папки добавьте папку библиотеки. Под Папки плейлистов каждую папку с файлами плейлиста указывайте отдельно; Подчиненные папки плейлистов туда не включаются автоматически. Они находятся на тестировании /srv/music/Playlists и /srv/music/Format-Test-1.3/Playlists.

Под Параметры → Настройки дисплея Отключите префиксы для номеров треков, исполнителей перед треками компиляции и исполнителей после названий плейлистов, если вы хотите, чтобы имена треков были простыми. Эти настройки изменяют отображение, а не музыкальные файлы. Поставщик активов использует встроенную ветку Плейлисты для списков воспроизведения файлов. Этот запрос не проходит рекурсивно по комбинациям динамических фильтров или интернет-радио. Отмеченную навигацию по умолчанию, включая динамический просмотр, можно сохранить. После этой корректировки представления каталога, исполнителя, альбома и жанра были проверены без ошибок поиска. Активы поставляют M3U, M3U8 и PLS; Названия треков PLS, возвращаемые сервером, могут содержать префикс исполнителя.

Руководство по активам

Jellyfin 12.2.0: DLNA и профиль клиента

Jellyfin требует официальную версию для MusicServer Connect Плагин DLNA. Установите его из официального каталога плагинов в администрировании сервера и перезапустите Jellyfin. DLNA 14.0.0.0 проверялся. В его настройках выберите учетную запись, библиотеки которой должны быть выставлены через DLNA. MusicServer Connect использует UPnP/DLNA независимо от входа в собственный веб-интерфейс Jellyfin.

Библиотеки и метаданные

Аудиофайлы как тип библиотеки Музыка, видео как Музыкальные клипы как библиотеки. Сделайте соответствующие папки мультимедиа и плейлистов доступными для чтения, а затем просканируйте обе библиотеки. Чтобы использовать только теги файлов, отключите внешние поставщики метаданных и изображений; также проверьте глобальные настройки исполнителя и альбома. Оставьте включенными встроенные заголовки и локальные изображения. Наша установка имеет доступ к общей музыкальной библиотеке только для чтения.

Профиль клиента для MusicServer Connect

Загрузите проверенный профиль клиента DLNA и как MusicServer Connect.xml Сохраните в папке профиля пользователя плагина DLNA. Это ниже для собственной установки Debian. /var/lib/jellyfin/plugins/configurations/dlna/user/; для других установок используйте фактический каталог данных Jellyfin. Служба Jellyfin должна иметь возможность читать файл. Перезапустите Jellyfin, затем обновите библиотеку плагинов.

Профиль идентифицирует MusicServer Connect по его пользовательскому агенту. Он предоставляет стабильные URL-адреса ресурсов и правильные типы мультимедиа для аудио M4A и видео OGV, обеспечивая доступность просмотров альбомов и видимость этих форматов в каталоге. Он хранится отдельно от поставляемых системных профилей.

Остальные ограничения

Все источники аудио и видео, а также представления плагина 195 были получены без ошибок при проверке с файлами 125. По DLNA Jellyfin не предоставляет ключ BPM/key и неправильно масштабирует битрейт. ASX/XSPF отсутствуют; M3U, M3U8, PLS и WPL теряют повторяющиеся треки. Некоторые старые списки M3U/M3U8 также неполны. Некоторые исполнители альбомов назначены неправильно, а в плоских музыкальных папках может отсутствовать собственный вид альбома. В WMA отсутствует второй жанр; в видео нет исполнителя, альбома и жанра. Профиль клиента не устраняет эти ограничения.

Официальная установка Linux · Официальная документация DLNA

WiiM Home, Mezzmo и Windows Media Player

На этих серверах Windows MusicServer Connect автоматически использует проверенные папки треков или файлов, чтобы избежать неправильных или очень медленных ответов глобального поиска. Никаких дополнительных настроек плагина не требуется. Затем поиск плагина выполняется по импортированному каталогу.

Ответы UPnP могут занять до 30 секунд или 60 секунд для Windows Media Player. Запросы остаются подлежащими отмене. Недействительные или изменяющиеся страницы по-прежнему отклоняются; более длительное ожидание не может предоставить недостающие файлы или метаданные.

WiiM Home Media Server 0.2.10.5

Музыкальные серверы и VirtualDJ могут работать на одном ПК Windows, включая несколько серверов одновременно. Список серверов сочетает в себе обычное обнаружение UPnP с дополнительной проверкой поддерживаемых локальных серверов. Он определяет фактически открытые порты и проверяет описания устройств UPnP. Различные идентификаторы устройств остаются отдельными; несколько конечных точек для одного сервера не создают повторяющихся записей. Права администратора не требуются.

Обычное обнаружение Windows UPnP не обнаружило WiiM Home на том же ПК в нашей проверке, хотя описание его устройства было доступно. Дополнительное открытие плагина находит его как WiiM Home: LaptopAcer — на другом ПК вместо этого используйте его имя. В диалоге подключения нажмите Искать еще раз и выберите сервер WiiM. Для этого соединения UPnP не требуется имя пользователя или пароль. WiiM Home, Mezzmo и Windows Media Player были проверены одновременно.

Для более старой версии плагина полный адрес описания можно временно сохранить в URL сервера здесь. Например, проверенный локальный путь: http://127.0.0.1:22346/upnp/DeviceDescription.xml. Порт и путь должны принадлежать работающему серверу; плагин не предполагает фиксированный порт. На этом компьютере порт 22345 также предоставляет тот же сервер WiiM. Написанное имя хоста localhost вернул HTTP 404 при прямой проверке и не был принят в качестве эквивалентной замены. Ошибка обнаружения не может быть однозначно приписана ни WiiM Home, ни Windows.

Добавьте папку с музыкой в локальную медиатеку и включите общий доступ DLNA. В тесте использовался первоисточник \\smbserver\music . Этот интерфейс не предоставляет ни файловых списков воспроизведения, ни видео; AAC ADTS, Opus и WavPack также отсутствуют. Списки воспроизведения, сохраненные в приложении WiiM, не поддерживают импорт внешних файлов списков воспроизведения.

Mezzmo 6.0.6.0

Добавьте папку «Библиотека», включая подпапки. Списки воспроизведения внешних файлов, разделенные Создать плейлист → Подключенный плейлист . «Добавить файлы из внешнего списка воспроизведения» импортирует указанный носитель и представляет собой другую операцию. Чтобы сохранить исходные теги файлов, оставьте автоматическое получение и запись метаданных из Интернета отключенными.

Предложение свойств папки Проверяйте папки на наличие новых файлов каждые. Уже связанные списки имеют отдельные результаты. Мониторинг папок сам по себе не создавал связанных списков из файлов списков воспроизведения, даже если были настроены дополнительные расширения списков воспроизведения. Обновление существующей ссылки и обнаружение новых файлов плейлиста — это разные функции. Отдельно проверенные списки теряют повторы с M3U/PLS/WPL; M3U8/XSPF остаются пустыми, и оба образца ASX сообщают о противоречивом количестве страниц. Умные плейлисты не могут заменить фиксированный внешний порядок повторами.

Фильтр по умолчанию включает .aif, но не .aiff. Добавление *.aiff индексировало образец только как файл неизвестного типа без потока, поэтому это изменение было отменено. WavPack также не отображался как играбельный для проверенного клиента. Запись в базе данных сама по себе не доказывает играбельность.

Windows Media Player Унаследованное/совместное использование 12.0

Под Панель управления → Центр управления сетями и общим доступом → Параметры потоковой передачи мультимедиа на Разрешить все нажмите и с помощью ОК сохранить. Это дает устройствам в локальной сети, включая WiiM и сотовый телефон с WiiM Home, доступ к медиатеке. В Доступ запрещен Проверьте одобрение этого устройства: доступ к функционирующему плагину на одном компьютере не означает, что внешние устройства разрешены.

Включите потоковую передачу мультимедиа для локальной сети и добавьте локальные папки с музыкой и видео в свои библиотеки Windows. Вы можете отключить автоматическое получение и запись метаданных из Интернета, чтобы сохранить исходные файлы. Полное локальное сравнение вернуло реальные медиафайлы 146 и полностью декодировало все образцы предлагаемого формата 20. OGG, Opus, WavPack, WebM и OGV отсутствовали; BPM и ключ в комплект поставки не вошли. После восстановления каталога WMP было возвращено шесть непустых плейлистов. Некоторые имена отличаются от импортированных списков; два старых списка M3U теряют одну дорожку из-за кодировки символов. Их эквиваленты WPL содержат все четыре трека.

Используйте названия списков воспроизведения без точек, например МСК смешанный 1-3 вместо этого МСК смешанный 1.3. В целевом сравнении WPL, M3U и M3U8 WMP усекал имена сохраненных импортируемых копий до первой точки; сокращенное имя также появлялось в UPnP. Дефис сохранял полное имя.

Для WMP плагин запрашивает списки только структуры с небольшим фильтром метаданных. Полные метаданные трека, ресурсы и содержимое плейлиста по-прежнему читаются, при этом сохраняются проверки нумерации страниц и согласованности. Для этой библиотеки очистка и оптимизация плагина сократили измеренное время первого запроса каталога примерно с 22 секунд до 4.3–4.6 секунд. Это измерение поставщика для проверенной библиотеки, а не общее обещание для интерфейса VirtualDJ или более крупных библиотек.

Если ваша коллекция также содержит файлы списков воспроизведения, добавьте в музыкальную библиотеку Windows только фактические подпапки аудио, а папки видео добавляйте отдельно. Импортируйте плейлисты напрямую в WMP. Добавление всей родительской папки привело к тому, что WMP представил некоторые файлы списков воспроизведения в виде звуковых дорожек или пустых списков. Повторный импорт создал дополнительные копии WPL в папке Windows. Музыка → Плейлисты. Перед пересборкой создайте резервную копию каталога WMP и заархивируйте старые, четко идентифицированные импортированные копии за пределами отслеживаемых папок; восстановление базы данных приведет к их повторному индексированию. Исходные медиафайлы и плейлисты сохраняются.

Медиа-файлы на общем ресурсе SMB в нашем тесте не работали как библиотека WMP DLNA, даже через сетевой диск. Y:. Служба могла прочитать исходный файл, а Samba уже разрешала чтение и запись, но общий медиа-каталог оставался пустым. Этот вывод относится к проверенному здесь сетевому источнику, а не к каждой конфигурации SMB. Локальные файлы подлежат отдельной локальной проверке.

Windows Автономные файлы не использовались, поскольку они создают синхронизированную локальную копию. После перезапуска службы описание устройства WMP и UPnP root в нашей проверке снова стали доступны примерно через три секунды. Запись о сервере, отсутствующая изначально, не требует автоматического восстановления библиотеки.

Документация производителя

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

Gonic: музыкальные папки

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

MariaDB: изменить столбцы базы данных