Recomendaciones de configuración avanzada

Actualizado: 19.10.2026

Aquí se recopilan las configuraciones requeridas del servidor y guías de instalación adicionales. Los enlaces de configuración en la lista de compatibilidad conducen a las secciones relevantes.

Navidrome: Agrupar álbumes juntos sin importar la fecha de lanzamiento

Navidrome 0.64.2 también agrupa álbumes por fecha de lanzamiento de forma predeterminada. Si las etiquetas de fecha en diferentes formatos de archivo se interpretan como año de grabación o lanzamiento, el mismo álbum puede aparecer más de una vez.

Para ignorar las fechas de lanzamiento al agrupar álbumes, establezca la siguiente regla en Navidrome. Reemplace una regla existente en lugar de agregar una clave TOML duplicada. Si agrega una nueva regla, colóquela en el nivel superior antes de las secciones de la tabla.

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

El ID del álbum MusicBrainz, el artista del álbum, el nombre del álbum y la versión del álbum aún determinan la agrupación. La regla se aplica a toda la biblioteca. Los lanzamientos que difieran sólo por fecha se pueden combinar. No se requieren cambios en las etiquetas de los archivos multimedia.

Navidrome luego reinicie. La regla del álbum modificada desencadena un análisis completo. Luego recarga la vista del álbum en los clientes. Una variable de entorno ND_PID_ALBUM tiene prioridad sobre el archivo de configuración y es posible que deba ajustarse en consecuencia.

Fuente: Navidrome: identificadores de álbumes y pistas configurables.

Navidrome: dar prioridad a las portadas incrustadas

Cuando pistas de distintos álbumes comparten carpeta, un Folder.jpg común puede sustituir todas sus portadas. Esta prioridad prefiere una portada incrustada disponible; si no existe, las demás fuentes se conservan como alternativas.

En navidrome.toml, sustituya el valor existente o añada el ajuste en el nivel principal, antes de las secciones de tabla. No duplique la clave.

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

Después, reinicie Navidrome. El reinicio por sí solo no recalcula las portadas guardadas. En Navidrome 0.64.2, los álbumes afectados pueden resolverse de nuevo individualmente con el comando artwork oficial:

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

Sustituya la ruta de ejemplo y los identificadores de álbum. Ejecute el comando con el mismo usuario de servicio, directorio de trabajo, configuración, entorno y base de datos que Navidrome. No es necesario modificar los archivos ni sus etiquetas, ni eliminar la base de datos.

Después, sincronice de nuevo la biblioteca del cliente, por ejemplo en Amperfy, para obtener los nuevos identificadores de portada. No es necesario reinstalar la aplicación ni vaciar toda la caché de portadas.

Ampache y LMS: Iniciar sesión con clave API

Ampache 7, Ampache 8 y LMS requieren una clave API para iniciar sesión. Cree una clave para su propia cuenta en el servidor y úsela cuando se conecte en MusicServer Connect. Mantenlo confidencial.

Ampache 7.10.2: Importar títulos sin artistas del título

Síntoma y causa

Los archivos sin un artista de pista se pueden omitir durante la importación del catálogo. La corrección de la base de datos a continuación permite su importación. El inicio de sesión de Ampache requiere una clave API; ver Inicie sesión con una clave API.

Alcance

Esta corrección se aplica a Ampache 7.10.2 con MariaDB y la definición de columna que se muestra a continuación. Para otras versiones, compruebe primero si se aplica la misma causa.

que ha cambiado

Solo se cambia song.artist en la base de datos Ampache seleccionada para permitir NULL. Se conservan su tipo de datos, el valor predeterminado 0 y los índices existentes. El código fuente y los archivos de música de Ampache no se modifican. No se inventan nombres de artistas ni se reemplazan etiquetas de archivos. Otras bases de datos y la configuración global de MariaDB no se ven afectadas.

Corrección general de la base de datos

Requisitos

Ejecute estos comandos en el servidor MariaDB, dentro de su contenedor cuando corresponda. La cuenta de la base de datos necesita acceso de lectura para verificar y permiso ALTER en la canción. El ejemplo utiliza el inicio de sesión local root. Para otra cuenta de base de datos, utilice su configuración de cliente seguro existente; No pongas una contraseña en el comando.

Primero identifique el nombre real de la base de datos, que aparece como database_name en la configuración Ampache. Utilice su propio nombre de base de datos en cada comando.

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

Para el problema confirmado, el resultado muestra Type=int(11) unsigned, Null=NO y Default=0. Si es Null=YES, la corrección ya está aplicada. No cambie una definición diferente sin verificarla.

Recomendado: el guión adjunto Descargar ampache7-null-artist.sh en el servidor de base de datos. Comprueba la columna, acepta solo el tipo INT sin signo esperado y no realiza más cambios si NULL ya está permitido. Un esquema inesperado hace que se detenga sin cambios.

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

El núcleo SQL concreto de la solución para la definición confirmada anteriormente es:

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

Importa los archivos que faltan y comprueba el resultado.

Después de cambiar el esquema, importe los archivos que faltan. Utilice la ruta de la aplicación, el nombre del catálogo y la cuenta de servicio de su propia instalación. La versión de PHP debe coincidir con la versión 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 agrega nuevos archivos multimedia. No solicita la limpieza del catálogo, la importación de listas de reproducción ni una nueva exploración de las etiquetas de archivos existentes. Luego, Ampache puede actualizar las asignaciones y los contadores internos.

Luego actualice el complemento, abra todos los títulos y verifique los títulos que faltaban anteriormente. Entonces los títulos de arriba Todos los títulos → marcar todo → buscar en la base de datos → agregar a la base de datos en la base de datos de búsqueda VirtualDJ. Ver Buscar dentro de los nodos del árbol.

Funcionamiento y actualizaciones posteriores

Este es un ajuste del esquema de la base de datos local, no una migración general Ampache confirmada oficialmente. Después de una actualización de la base de datos Ampache, verifique nuevamente song.artist y la importación de archivos sin artistas de pistas: una migración puede cambiar la definición. El guión se puede comprobar repetidamente.

Para restaurar NOT NULL, las entradas NULL existentes primero necesitarían un manejo deliberado; Restablecer ciegamente la columna no es una reversión adecuada. La corrección marcada conserva los artistas de las pistas faltantes como información faltante.

Gonic 0.22.0: un álbum por carpeta de música

Síntoma y causa

Gonic requiere una carpeta separada para cada álbum. Mantenga juntos los archivos de un álbum; No mezcle diferentes álbumes en una carpeta. Una carpeta compartida para solteros no relacionados no cumple con este requisito. Luego, Gonic podrá aplicar los metadatos del álbum del primer archivo, incluido el artista del álbum, a todos los demás archivos de esa carpeta.

Estructura de carpetas recomendada

Para pistas sueltas, crea también una subcarpeta por álbum, por ejemplo «Einzeltitel/Alter Ego - Betty Ford (Bonus Remixes Version)» / «Einzeltitel/Homie Isback - Cherrymoon». Las dos versiones de Cherrymoon pueden compartir carpeta si pertenecen al mismo álbum. Mantén separados los lanzamientos distintos. Guarda los archivos de música en subcarpetas de la ruta configurada: Gonic 0.22.0 omite los archivos situados directamente en la carpeta raíz.

Si varios servidores comparten una biblioteca, puede crear una vista de carpeta separada para Gonic mediante enlaces simbólicos. Allí también asigna a cada álbum su propia carpeta. Configure rutas de música para que cada pista se indexe solo una vez. La cuenta de servicio Gonic necesita acceso tanto a los enlaces como a sus destinos.

Comprobar después del cambio

Vuelva a escanear completamente Gonic, luego actualice la lista de pistas del complemento. Consulta totales, agrupación de álbumes, nodos de artistas y reproducción. Los cambios en las rutas de importación pueden crear nuevas ID de servidor, así que verifique los favoritos existentes, las listas de reproducción y la configuración de VirtualDJ después. Registre las pistas nuevamente si es necesario. Agregar a la base de datos de búsqueda VirtualDJ. Las pistas individuales recién agregadas también deben proporcionarse en la estructura de carpetas del álbum adecuada.

Proporcionar listas de reproducción basadas en archivos para el usuario

Gonic lee listas de reproducción desde su configuración playlists-path y una subcarpeta que lleva el nombre del ID de usuario numérico. Coloque allí los archivos M3U/M3U8 con rutas de medios resueltas para Gonic. Un escaneo de música normal no importa automáticamente listas de reproducción de otras carpetas de la biblioteca. Nuestra configuración crea vistas derivadas sin cambiar los originales compartidos. Actualice estas vistas después de cambiar las fuentes.

Documentación del proyecto Gonic

Gerbera 3.3.0-77: BPM, Clave, UTF-8 e Inotify

Agregue las siguientes asignaciones para BPM y clave. Los archivos de música deben contener las etiquetas BPM, KEY o INITIALKEY correspondientes. Mantenga las asignaciones existentes como PERFORMER.

Líneas adicionales: Tag Name y Upnp metadata entry
Biblioteca	Tag Name	Upnp metadata entry
taglib	BPM	upnp:beatsPerMinute
taglib	KEY	upnp:key
taglib	INITIALKEY	upnp:initialKey
ffmpeg	bpm	upnp:beatsPerMinute
ffmpeg	clave	upnp:key
ffmpeg	clave inicial	upnp:initialKey

Para una instalación basada en XML, agregue las entradas en importar → opciones de biblioteca → id3 → metadatos y ffmpeg → metadatos. Gerbera etiqueta el grupo XML id3 como taglib Library Options en su interfaz web. Configure charset en UTF-8 en ambas bibliotecas; mantenga o configure filesystem-charset, metadata-charset y playlist-charset en UTF-8 también. Guarde y reinicie Gerbera. Las asignaciones de etiquetas adicionales entran en vigor cuando los archivos se importan nuevamente; una nueva exploración normal puede omitir archivos sin cambios. Para una nueva instalación, configure estas opciones antes de importar música.

MP4, M4A y M4V: prefieren etiquetas BPM más precisas

Disponible en Git build 3.3.0-77: La extensión BPM Gerbera-PR #3993 se ha fusionado y se incluye en la imagen oficial. Una mayor precisión es opcional y debe habilitarse con prefer_highest_bpm_accuracy="yes" estar encendido. Sin este atributo queda no el valor predeterminado.

El atributo MP4 tmpo contiene un número entero. Además, una etiqueta adicional de iTunes BPM puede contener un valor más preciso. En el elemento XML existente import → library-options → id3 ¿Se puede activar su preferencia? mantenga las asignaciones de etiquetas existentes:

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

Si falta prefer_highest_bpm_accuracy o si está configurado en no, se conserva el comportamiento anterior. Para yes Gerbera lee tmpo y la etiqueta adicional BPM por separado. Si la distancia es menor que 1 BPM, se adopta el valor de la etiqueta, por ejemplo 123,5 en lugar 123. Si los valores difieren en al menos 1 BPM, la selección está determinada por prefer_ambigous_bpm_value: tmpo prefiere el número entero, bpm_tag la etiqueta adicional. Si el segundo atributo está ausente, bpm_tag. La notación de atributos es explícita. prefer_ambigous_bpm_value.

Sólo los números positivos finitos son válidos para esta selección; utilice un punto decimal en la etiqueta del archivo. Si sólo una fuente es válida, se utiliza. Los valores de medio tiempo o doble tiempo no se corrigen automáticamente. Otras etiquetas, géneros, claves y portadas se leen como antes. Reinicie Gerbera después de cambiar la configuración y vuelva a importar los archivos afectados; una nueva exploración normal puede omitir archivos sin cambios.

AIFF: BPM, clave y lectura de múltiples géneros

Si a los archivos AIFF les faltan BPM o clave a pesar de las etiquetas ID3 existentes, en Gerbera Configuración → Experto → Importar → Asignaciones → Mimetype-Contenttype la asignación del tipo MIME reconocido al tipo de contenido aiff suplemento. Para audio/x-aiff y audio/aiff cada uno aiff entrar. Esto permite que Gerbera utilice el lector TagLib correspondiente; Las asignaciones de teclas BPM/de la tabla anterior aún son necesarias.

En la configuración XML, las siguientes líneas en la sección existente import → mappings → mimetype-contenttype con las siguientes adiciones, conservando las asignaciones existentes:

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

Reinicie Gerbera o su contenedor e importe los archivos afectados nuevamente. Una nueva exploración normal puede omitir archivos no modificados; no es necesario cambiar el nombre ni la marca de tiempo.

OGV: Adoptar etiquetas de las pistas de audio y vídeo.

Con OGV, el título, artista, álbum, género, BPM y clave pueden estar en pistas individuales de audio y video. Activar en Gerberas Configuración → Experto → Library Options → ffmpeg Library Options la opción streams-enabled. Esto está disponible en la configuración XML. import → library-options → ffmpegelemento, el atributo streams-enabled="yes" poner; Preservar los atributos existentes y las asignaciones de etiquetas.

Reinicie Gerbera o su contenedor, luego vuelva a importar los archivos OGV existentes. Las asignaciones de teclas/BPM en la tabla anterior aún son necesarias. Sin el análisis de metadatos de transmisión habilitado, estos valores pueden estar ausentes a pesar de las etiquetas de archivos guardadas correctamente.

WebM y WMV: adopte múltiples géneros con el lector adecuado

Desde Git build 3.3.0-62 y también en el actual 3.3.0-77 Puede leer múltiples etiquetas de género de WebM y WMV. Las actualizaciones conservan la configuración existente, por lo que es posible que aún falten las asignaciones de lectores agregadas en la nueva compilación. en Configuración → Experto → Importar → Asignaciones → Mimetype-Contenttype Agregue las siguientes asignaciones o en la sección XML existente import → mappings → mimetype-contenttype entrar:

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

Mantenga las asignaciones existentes y la configuración de clave/BPM, reinicie Gerbera y vuelva a importar los archivos afectados. Esto cambia el lector de metadatos que se utiliza, no el tipo MIME del vídeo devuelto. Los archivos no necesitan conversión ni cambio de nombre. La base es la Asignaciones predeterminadas de esta versión fuente de Gerbera.

Detectar automáticamente cambios de archivos y atributos

Inotify detecta eventos del sistema de archivos. inotify-attrib="yes" además monitorea los cambios de atributos, incluidas las marcas de tiempo cambiadas al tacto. Para una instalación de Linux, amplíe la sección de escaneo automático existente en /etc/gerbera/config.xml conservando la ruta de la música:

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

Luego use el servicio Linux. systemctl restart gerbera reiniciar.

Inotify en el contenedor oficial Gerbera

La imagen oficial ya habilita Inotify para la carpeta de música montada, pero el monitoreo de atributos adicionales está inicialmente deshabilitado. Usar Inotify y Monitorear los cambios de atributos de Inotify aparecen en Configuración Gerbera → Experto → Importar, pero no se pueden editar a través de esa vista en la imagen marcada. La configuración se almacena en /var/run/gerbera/autoscan.xml..

En QNAP, abra gerbera-qnap en Container Station e inicie su terminal o consola. En Synology, seleccione gerbera-synology en Container Manager, abra su terminal e inicie /bin/sh.. Ejecute el siguiente comando dentro del contenedor.
Inserte el siguiente bloque. Completa el atributo y muestra el archivo escaneado; Se conservan la ruta de la música y la configuración existente.

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

El resultado debe mostrar escaneo automático con inotify-attrib="yes". Reinicie el contenedor, luego verifique que Monitor Inotify Attribute Changes esté seleccionado en Gerbera Config. Si falta autoscan.xml, primero identifique el archivo de configuración que realmente se está utilizando. Este comando se aplica a la compilación oficial especificada en las guías NAS.

Las etiquetas de género separadas no necesitan configuración adicional. MusicServer Connect utiliza todos los campos de género proporcionados por UPnP. Desde la versión 1.5, los géneros combinados separados por punto y coma o barras diagonales también se asignan a sus vistas de género individuales. Las etiquetas de servidor y archivo permanecen sin cambios.

Fuentes: Gerbera escaneo automático y monitoreo de atributos, Configuración inicial de la imagen oficial del contenedor..

Gerbera 3.3.0-77: nombres de títulos puros en los resultados de búsqueda

Gerbera combina M_ARTIST y M_TITLE para títulos de pistas en respuestas de búsqueda UPnP de forma predeterminada. MusicServer Connect importa a través de esa interfaz, por lo que "Speedy J - Electric Deluxe" aparece en la columna de título aunque la etiqueta del archivo TITLE contiene solo "Electric Deluxe".

En servidor → upnp, configure el resultado del elemento de búsqueda para usar solo M_TITLE. extend="no" reemplaza la lista predeterminada en lugar de agregar entradas:

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

el Script de configuración gerbera-suchtitel.py establece esta opción en una configuración XML existente. La ruta predeterminada es /etc/gerbera/config.xml; se puede proporcionar otra ruta como argumento. Se conservan los espacios de nombres, comentarios y otras configuraciones existentes. Si la estructura del servidor es ambigua, el script se detiene antes de escribir.

Alternativamente en la interfaz web de Gerbera en Configuración → Servidor → UPnP → Resultado del elemento de búsqueda la entrada M_ARTIST quitar y solo M_TITLE para retenerlo. Verifique las configuraciones ya guardadas en la interfaz web, ya que pueden anular los valores XML. Esta configuración también se aplica a Gerbera 3.3. El artista permanece disponible como un campo de metadatos separado.

Reinicie Gerbera y vuelva a cargar la conexión del complemento. Esta configuración cambia los títulos de las pistas en los resultados de búsqueda; no se necesitan complementos ni cambios en archivos de música. Compruebe también la visualización de las pistas ya almacenadas en VirtualDJ. La detección de artista opcional FRITZ!Box es independiente de esta configuración.

Gerbera: Vistas e importación de listas de reproducción

Por qué la misma lista de reproducción aparece varias veces

Gerbera puede mostrar la misma lista de reproducción en Listas de reproducción → Todas las listas de reproducción y Listas de reproducción → Directorios. Esto no significa que el archivo de la lista de reproducción exista más de una vez.

MusicServer Connect combina vistas de listas de reproducción idénticas. Si sus contenidos difieren o una consulta está incompleta, es posible que permanezcan visibles varias vistas.

Verifique las importaciones de listas de reproducción incompletas

Verifique las entradas de la lista de reproducción. Las rutas relativas se refieren a su carpeta.
Verifique que todos los archivos de música a los que se hace referencia existan y sean legibles por la cuenta de servicio de Gerbera.
Lea la lista de reproducción nuevamente después de los cambios. Si la importación está incompleta, reinicie el servicio Gerbera y espere el escaneo.
Luego actualice la vista en el complemento y verifique la lista de reproducción.

Para detectar cambios en las marcas de tiempo de los archivos automáticamente, utilice Monitoreo de atributos de Inotify activar.

Referencias de listas de reproducción obsoletas y juego de caracteres M3U

Compruebe de nuevo el contenido de las listas tras modificar los archivos multimedia referenciados. Un nuevo análisis normal puede dejar las vistas existentes sin cambios. Después, actualice la biblioteca en MusicServer Connect. Los identificadores del catálogo pueden cambiar.

Para compartir los mismos archivos de lista de reproducción con MinimServer, guardamos M3U con Windows-1252 y M3U8 con UTF-8. El importador estándar de Gerbera en la compilación probada 3.3.0-77 no resolvió correctamente la ruta de diéresis de Windows-1252-M3U. el Descargue la extensión de importación M3U verificada y guárdelo en el directorio de script personalizado configurado. Detecta UTF-8 válido en líneas M3U y, en caso contrario, utiliza Windows-1252. Las listas de reproducción M3U8, PLS y XML siguen utilizando el importador estándar. Conservar los scripts personalizados existentes.

En la configuración Gerbera existente en import/scripting/import-function el nombre de la función de la lista de reproducción de importPlaylist en mscImportPlaylist para cambiar. Bajo import/scripting/script-folder/custom El directorio configurado debe contener el archivo descargado y almacenarse permanentemente para las instalaciones de contenedores. En el banco de pruebas es inferior. /var/run/gerbera/custom-js. Luego reinicie Gerbera e importe los registros de la lista de reproducción nuevamente. La extensión requiere el importador de JavaScript.

MiniDLNA / ReadyMedia 1.3.3: extensiones de archivo de lista de reproducción

MiniDLNA 1.3.3 reconoce listas de reproducción con .m3u y .pls. Los archivos con .m3u8 no se leen.

Recomendación: cambie el nombre de M3U si es posible

Si ninguna otra aplicación o configuración del servidor depende del nombre del archivo M3U8 actual, cambie la extensión de .m3u8 a .m3u. Esta es la solución más sencilla para MiniDLNA. Mantenga el contenido, la codificación UTF-8 y la ubicación sin cambios para que las rutas musicales relativas sigan funcionando. Actualice cualquier referencia al nombre del archivo de la lista de reproducción. Luego haga que MiniDLNA importe la lista de reproducción nuevamente y actualice el complemento.

Alternativa: conservar una fuente M3U8 compartida

Si otros servidores necesitan el archivo M3U8, cree un archivo M3U adicional para MiniDLNA. Si está en una carpeta diferente, ajuste las rutas de música relativas o utilice rutas absolutas.

el Script de configuración minidlna-playlist-view.py comprueba el origen y el destino, crea el M3U derivado y agrega media_dir=A,/media3 a la configuración existente de MiniDLNA. No cambia la fuente M3U8 ni las entradas media_dir existentes. En caso de conflicto de destino, se detiene. Vuelva a cargar MiniDLNA y actualice el complemento. Después de cambiar la lista de reproducción de origen, ejecute el script y reinicie MiniDLNA nuevamente para mantener actualizada la vista derivada. No hay ningún observador de cambios instalado.

Permisos de caché al reconstruir

Si MiniDLNA no puede limpiar su caché de cobertura durante la reconstrucción, verifique los permisos de escritura en el caché y sus subdirectorios.

Para otras instalaciones, primero identifique la cuenta de servicio real y la ruta de caché configurada. Después de reconstruir la biblioteca, actualice el complemento. Si es necesario, registre nuevamente la lista de pistas completa usando “Búsqueda en la base de datos → Agregar a la base de datos”.

Compartir audio y vídeo

un compartir con media_dir=A,/srv/music se limita al audio. Para ambos tipos de medios, abra esta línea existente media_dir=AV,/srv/music cambiar, obtener más aprobaciones y reiniciar el servicio. Los límites de códec y metadatos siguen siendo independientes de esto.

Serviio 2.5: liberación de vistas requeridas

Para tener disponibles los artistas del álbum y el orden del álbum original, muestre las categorías requeridas en la consola Serviio.

Orden de las pistas

Para ver el orden de las pistas originales, abra un solo álbum. Una clasificación de columnas seleccionada en VirtualDJ puede cambiar el orden visible.

En la consola Serviio, en Presentación → Audio, configure Música, Álbumes, Títulos y Listas de reproducción en "Mostrar categoría". Otras categorías de audio pueden utilizar "Mostrar contenido únicamente". La vista del álbum debe estar disponible para la consulta complementaria. No se necesitan cambios en los archivos de música.

Diferentes artistas de álbumes guardados.

Si los metadatos del álbum o del artista de Serviio difieren de las etiquetas del archivo, vuelva a leer los metadatos en el servidor y luego actualice el complemento.

Si hay varias etiquetas de género, solo se adopta la primera.

Si un archivo tiene varias etiquetas de género, solo se utiliza la primera. Los géneros restantes faltan en los metadatos y el árbol de géneros devueltos. Esta limitación de compatibilidad no es específica de un formato de archivo.

Lea también vídeos

bajo Biblioteca → Carpetas compartidas editar la carpeta de la biblioteca existente y además de Audio también Vídeo para habilitarlo. Guarde el recurso compartido y Forzar actualización ejecutar. Serviio entrega listas de reproducción de archivos mixtos en vistas separadas de audio y video.

Servidor Twonky 8.5.2: recuperación de pistas y álbumes completos

Cuando detecta la estructura Twonky, MusicServer Connect utiliza las vistas nativas completas de pistas y álbumes. En nuestras comprobaciones, la búsqueda global del servidor omitió siete pistas accesibles en W e Y. El respaldo automático también recupera estas pistas y preserva el orden de los álbumes. No se necesita ninguna configuración de complemento adicional. Las páginas nativas incompletas o inconsistentes aún se rechazan.

La verificación de seguimiento cubrió los archivos multimedia 149 (audio 139, diez videos) y todas las vistas ofrecidas sin errores de recuperación. La falta de compatibilidad con ASX/XSPF, los formatos y los metadatos siguen siendo limitaciones del servidor. Es posible que Twonky requiera un nuevo inicio de sesión de proveedor después de reiniciar; un aviso de inicio de sesión no es un catálogo de música.

Universal Media Server 15.8.2: Servicio Linux y visualización de álbumes.

Para un servicio Linux, configure el entorno en UTF-8 para que se puedan procesar rutas de música que contengan diéresis y otros caracteres Unicode.

con systemctl edit DIENSTNAME.service Configure la siguiente adición para su propio servicio UMS. Después de eso systemctl daemon-reload Ejecute, reinicie este servicio y espere el escaneo de la biblioteca.

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

La configuración regional C.UTF-8 debe estar disponible en el sistema. Configurar Java file.encoding solo no reemplaza la configuración regional utilizada para los nombres de archivos. Un comando Java iniciado desde un shell interactivo puede utilizar configuraciones diferentes a las del servicio en ejecución.

El acceso directo a la carpeta de música en Linux evita las restricciones de uso compartido de Windows en los nombres de archivos, como los nombres que contienen un signo de interrogación.

Artistas de álbumes y búsqueda de bases de datos.

Para obtener información completa sobre el artista del álbum en UMS.conf, active la búsqueda de base de datos integrada y reinicie UMS:

search_lucene_use_engine = false

La configuración reemplaza la búsqueda de texto completo de Lucene con la búsqueda de base de datos incorporada.

Orden del álbum original

Para ver el orden de las pistas originales, abra un solo álbum. Una clasificación de columnas seleccionada en VirtualDJ puede cambiar el orden visible.

UMS combina varias etiquetas de género en un texto separado por "/". MusicServer Connect crea nodos de género individuales a partir de él; la pista aparece en todos los géneros enumerados. Tratar con múltiples géneros.

Archivos ASX y búsqueda de catálogo incompleta.

UMS 15.8.2 puede contar los archivos de lista de reproducción ASX como carpetas de vídeo sin devolver los objetos correspondientes. La búsqueda de audio también puede anunciar más coincidencias de las que devuelve y puede omitir OGG de las búsquedas de clases de audio. MusicServer Connect detecta estas inconsistencias y complementa el catálogo utilizando carpetas de archivos reales. La colección verificada de archivos de audio y diez videos 141 aparece en su totalidad, y se conservan las identificaciones de audio y los metadatos existentes. No se necesita ninguna configuración adicional.

El complemento descubre subcarpetas reales independientemente de la búsqueda SQL incompleta. Las páginas de búsqueda previamente marcadas se utilizan únicamente para asignar alias. Compara dos inventarios de archivos completos antes de aceptarlos y vuelve a comprobar si hay cambios en el estado de búsqueda. No atraviesa combinaciones de filtros virtuales. Si una versión futura de UMS proporciona resultados de búsqueda completos con las clases de medios correctas, el complemento vuelve a utilizar automáticamente esa búsqueda directa. Los archivos fuente de la biblioteca permanecen sin cambios.

Este respaldo no repara los metadatos del servidor o las entradas de la lista de reproducción que faltan: ASX, WPL y XSPF aún no están como vistas de la lista de reproducción. UMS omitió la primera pista de las listas antiguas M3U/PLS marcadas aquí. Las tres listas de formato mixto, sin embargo, contienen las seis posiciones, incluidas entradas repetidas de audio y vídeo.

Conversión y transmisión de audio WAV

UMS puede transcodificar audio a WAV de bits 16 según el perfil del cliente. Cuatro muestras contenían audio completo en la verificación de seguimiento, aunque las longitudes ilimitadas de WAV no superaron la validación estricta del archivo. La decodificación normal y la comparación después de la normalización al bit 16 fueron exitosas. Esto no demuestra la preservación de una resolución original de bits 24. Las solicitudes de rango muy pequeño podrían volver vacías durante la conversión; Las descargas normales y las solicitudes de KiB 64 funcionaron.

Ocultar la carpeta de transcodificación adicional

show_transcode_folder = false Oculta la carpeta virtual para configuraciones de transcodificación alternativas. Se conservan la transcodificación en sí y las etiquetas multimedia guardadas. Esta opción de visualización por sí sola no corrige recuentos de páginas UPnP inconsistentes.

MinimServer: BPM/Actualización de claves y bibliotecas

Leer BPM y clave de archivos de música

Para proporcionar etiquetas adicionales, necesita una licencia MinimServer completa o de prueba. Los archivos de música deben contener etiquetas BPM y KEY o INITIALKEY.

En la página de configuración de MinimServer, abra Propiedades.
Bajo itemTags los nombres BPM,KEY,INITIALKEY suplemento. Mantener las entradas existentes; las etiquetas deben coincidir con sus propios archivos de música. KEY y INITIALKEY considere: El campo MP3 TKEY es tratado por MinimServer como INITIALKEY se lee.
Guarde los cambios y realice el reinicio del servidor solicitado.
Ejecute una nueva exploración en Estado. Luego actualice la biblioteca en MusicServer Connect.

Más información: MinimServer: metadatos adicionales y Alcance de la licencia. Advanced Mode de WiiM es una característica de la aplicación WiiM; el requisito de licencia completa aquí se refiere a los metadatos adicionales del servidor.

Los valores ya almacenados en VirtualDJ pueden permanecer después de un cambio. Para volver a leer las etiquetas BPM/clave incrustadas, seleccione las pistas afectadas y elija "Leer BPM y clave del archivo de música" en el menú contextual. Para un análisis de audio nuevo, utilice “Analizar BPM y etiquetas”; con varias pistas seleccionadas, esta acción se encuentra en "Lote".

Volver a leer después de los cambios

Vuelva a escanear MinimServer después de cambiar archivos de música, etiquetas o tiempos de modificación. Abra su página de configuración, elija la pestaña Estado y haga clic en Volver a escanear. Actualice el estado hasta que indique "En ejecución", luego actualice MusicServer Connect. Reiniciar MinimServer por sí solo generalmente no activa una nueva exploración.

Un índice de servidor desactualizado puede devolver marcadores de posición de "Elemento modificado o eliminado" sin metadatos de pista ni archivos de audio. Es posible que estos marcadores de posición aún estén incluidos en el total informado. Luego, el complemento muestra menos pistas utilizables, aunque los artistas y álbumes de los álbumes siguen siendo conocidos desde los contenedores del servidor existentes.

Ver Página de configuración MinimServer y volver a escanear así como también API web oficial para reescaneos automatizados.

Combina un álbum de varias carpetas

Si las pistas del mismo álbum están en varias carpetas, MinimServer puede entregar varios álbumes con el mismo nombre. La configuración en Propiedades mergeFolderAlbums en true al valor indicado, guarde y reinicie MinimServer. El nombre del álbum y el artista del álbum deben coincidir. Esta configuración se aplica a toda la biblioteca y también puede combinar otros álbumes coincidentes de varias carpetas. Los archivos multimedia no se modifican.

En nuestra verificación, esto combinó “Pruebas de formato MSC 1.3” de las subcarpetas Audio y Video en un álbum con pistas 13 reconocidas por MinimServer. Anteriormente, los dos grupos contenían once y dos pistas. Luego abra el servidor en WiiM Home y … → Volver a escanear el servidor de música para actualizar el índice propio de la aplicación. La etiqueta puede diferir según el idioma de la aplicación. Posteriormente, WiiM Home mostró solo una copia del álbum de ejemplo en nuestra revisión.

Ver MinimServer: álbumes y carpetas y WiiM Home: leer la biblioteca multimedia nuevamente.

M3U/M3U8: Juego de caracteres y entradas faltantes

MinimServer espera .m3u con Windows-1252 o ISO-8859-1 y .m3u8 con codificación UTF-8. Un archivo UTF-8 con la extensión .m3u Por lo tanto, puede omitir pistas cuyos recorridos contengan caracteres acentuados. Utilice M3U8 para rutas Unicode. Si también se necesita M3U, guarde una copia separada con la codificación adecuada. No reemplace caracteres que esta codificación no pueda representar.

En la colección revisada, una nueva exploración reparó la referencia obsoleta de "Betty Ford" que anteriormente se devolvía como "Elemento modificado o eliminado" sin audio utilizable. La codificación Windows-1252 correcta del M3U adicional de Sven Väth también restauró la referencia de ruta acentuada a “W.I.R.” Luego, ambas listas proporcionaron las cuatro pistas en el orden de origen, sin una reconstrucción completa del catálogo. Las listas de formato mixto proporcionaron cinco de seis posiciones, incluidas las repeticiones; MKV quedó excluido porque el formato no es compatible.

Después de volver a escanear, actualice la biblioteca en el complemento. Fuente: MinimServer: formatos de listas de reproducción y conjuntos de caracteres.

JRiver: Importar listas de reproducción y permitir acceso de lectura

Importe listas de reproducción a la biblioteca JRiver. Si la importación automática de música omite una lista de reproducción, impórtela por separado y luego actualice la vista del complemento.

Escribir a través de la interfaz del servicio web de JRiver requiere que esté habilitada la autenticación. Se debe seguir permitiendo el acceso de lectura anónimo: MusicServer Connect lo utiliza para distinguir listas de reproducción regulares e inteligentes. El acceso de lectura no otorga permiso de edición de listas de reproducción.

Puedes mostrar u ocultar listas de reproducción inteligentes en el complemento. Los contenidos ocultos de la lista de reproducción inteligente no se solicitan mientras se crea el árbol; se cargan cuando los muestras. Las listas vacías y las listas sin pistas de audio no aparecen como listas de reproducción de música.

Synology: configurar el servidor de medios predeterminado

El servidor estándar de Synology es compatible con WiiM Home Advanced Mode. También es suficiente para MusicServer Connect si VirtualDJ calcula BPM y la clave. Para valores almacenados de BPM/clave, puede utilizar Gerbera en el contenedor . Ambos servidores pueden leer los mismos archivos de música.

Instale Media Server en el Centro de paquetes y copie su biblioteca de música en la carpeta de música compartida. Ya deben existir un grupo de almacenamiento y un volumen.

Configuración general: idioma del menú DMA según se desee, estilo del menú DMA Estilo simple; Deje el intervalo de informes SSDP en el valor predeterminado.
Configuración de búsqueda: configure el Formato de visualización de música en "Solo título"; permita archivos de portada adicionales con “Imagen de portada para archivos de audio/video” y conserve los nombres de archivo predeterminados.
Compatibilidad DMA: deje desactivados la transcodificación de audio y los tipos MIME personalizados. Permitir el acceso a los dispositivos deseados.
Después de copiar, expulse de forma segura la memoria USB. Las carpetas de álbumes, pistas individuales y listas de reproducción se encuentran directamente debajo de Música.

El servidor de medios Synology combina múltiples etiquetas de género en un valor separado por ";". MusicServer Connect crea nodos de género individuales, por lo que cada pista aparece en cada género enumerado. Tratar con múltiples géneros.

Guarde listas de reproducción con la extensión .m3u. En File Station, cambie el nombre de un archivo .m3u8 en Música/Listas de reproducción a .m3u, manteniendo el contenido UTF-8 y las rutas relativas. Si otros servidores necesitan M3U8, cree una copia de M3U por separado.

FRITZ!Box: formatos de audio y artistas de pistas.

Configurar el servidor de medios

Conecte el almacenamiento USB que contiene la biblioteca de música. En la interfaz FRITZ!Box, habilite Servidor multimedia en Red doméstica → Servidor multimedia, seleccione el almacenamiento USB como fuente de medios y aplique. Cree o actualice su índice de archivos en Red doméstica → USB/Almacenamiento o Almacenamiento (NAS) y espere la indexación. Luego seleccione el servidor de medios FRITZ!Box en MusicServer Connect.

Formatos de audio y metadatos.

FRITZ!Box puede transmitir muchos formatos de audio pero solo lee algunas de sus etiquetas. Sin compatibilidad con etiquetas, el artista del álbum, el álbum y el género no aparecen en el árbol de la biblioteca. Con la detección de artista de pista habilitada, MusicServer Connect puede derivar un artista a partir de nombres en el patrón "Artista - Nombre de pista". Los archivos siguen siendo accesibles a través de Todas las pistas, carpetas y listas de reproducción compatibles.

Evaluación de etiquetas según la tabla de formato FRITZ!Box
Formatos de audio	Lectura de etiquetas
MP3, WMA, ASF	Sí; no hay garantía de todos los campos de metadatos individuales.
FLAC	No
AAC, M4A	No
WAV, AIF/AIFF, LPCM	No
Ogg Vorbis, APE, WavPack, MPC	No
3GP, AC3, MKA, MPA, MP1, MP2, audio real, Karaoke CDG/BIN	No

Para MP3/WMA, la documentación del proveedor enumera el título, artista, álbum, género y número de pista y el ID3 v2.3 o anterior. Por lo tanto, el artista del álbum, BPM y la clave no están confirmados como campos admitidos. VirtualDJ o el reproductor deben admitir el formato de audio para la reproducción.

Recomendación: utilizar artistas de pista

Para bibliotecas con FLAC u otros formatos sin evaluación de etiquetas, incluso cuando se mezclan con MP3, la vista Artista de la pista si los nombres de los archivos siguen el patrón “Artista - Nombre del título” corresponder. Para hacer esto en el menú contextual de la fuente MusicServer Connect primero "Determinar el título del artista a partir de los nombres de los archivos" enciende. Luego seleccione "Mostrar artistas" y "Cambiar a título de artistas" si esta vista aún no está activa.

Esta detección está deshabilitada de forma predeterminada para nuevas conexiones de servidor y se guarda por conexión. Para desactivarlo, elija "Desactivar la detección de artistas de pistas a partir de nombres de archivos" en el mismo menú. Déjelo deshabilitado si los nombres de sus archivos no siguen a “Artista - Nombre de la pista”: el complemento no puede determinar si el texto antes de un guión es un artista o parte del título.

Cuando la detección está habilitada, falta el artista y el nombre coincide con el patrón, MusicServer Connect se divide en el primer "-". Por ejemplo, “1st Bass - Slam Me Down” se convierte en artista “1st Bass” y título “Slam Me Down”. En el título permanecen más guiones; Los metadatos del artista existentes tienen prioridad. Cuando está deshabilitada, esta división no se realiza y el título proporcionado por el servidor permanece sin cambios para este propósito. La detección de remezclas es una configuración separada.

Al cambiar, MusicServer Connect también actualiza las visualizaciones de títulos guardados si el título y el artista aún coinciden con una de las dos variantes generadas por el complemento. Se conservan otras ediciones manuales. Este interruptor no cambia los valores de BPM, clave, remezcla o análisis.

Esta detección llena el campo del artista y la vista del artista de pista. No reemplaza las etiquetas de álbum, álbum-artista o género. Si su biblioteca contiene solo MP3, WMA o ASF, se pueden usar las etiquetas proporcionadas por el servidor y la vista de artista de pista no es necesaria como alternativa. La vista del artista del álbum sólo es útil si el servidor realmente proporciona la información requerida.

Para formatos cuyas etiquetas no se leen, FRITZ!Box tampoco puede proporcionar valores de clave/BPM almacenados. VirtualDJ puede calcularlos él mismo. Para una navegación completa por la biblioteca basada en etiquetas, utilice un servidor de música que admita metadatos para sus formatos.

Listas de reproducción

Utilice M3U o PLS. WPL se reconoce pero puede omitir pistas, así que elija M3U o PLS para obtener listas completas confiables. M3U8, ASX y XSPF no se reconocen como listas de reproducción. Mantenga el contenido de UTF-8 y las rutas de música relativas válidas. MusicServer Connect elimina la extensión del archivo y el nombre de la carpeta adjunta del nombre de la lista de reproducción mostrada.

Documentación del fabricante: Formatos de audio, lectura de etiquetas y formatos de listas de reproducción., Ordenar y etiquetar versiones así como también Configurar el servidor de medios y crear un índice de archivos.

QNAP: ejecute el servidor de medios estándar y Gerbera en paralelo

El complemento de transmisión de medios estándar de QNAP es compatible con WiiM Home Advanced Mode. También es suficiente para MusicServer Connect si VirtualDJ calcula BPM y la clave y el orden incorrecto de la lista de reproducción son aceptables. Para valores almacenados de BPM/clave, géneros separados y orden correcto de la lista de reproducción, puede utilizar Gerbera con estación de contenedores ser complementado.

Instale la consola multimedia y el complemento de transmisión multimedia en App Center. Coloque las carpetas de música en Público/música. En Consola multimedia → Administración de contenido, seleccione Complemento de transmisión de medios y agregue Público/música como fuente de contenido.

Indexación: habilitar información multimedia; Prioridad normal. Para la biblioteca UTF-8, seleccione UTF-8 si se ofrece; de lo contrario, deje el valor predeterminado.
Abra la configuración del complemento Media Streaming por separado. Seleccione su propia cuenta de usuario NAS y la interfaz de red adecuada; utilice el puerto predeterminado 8200.
En DLNA Media Renderer, permita el acceso a la PC o cliente deseado.
En Configuración de navegación, establezca Estilo de menú predeterminado en Todas las categorías. En DLNA Media Renderer, seleccione también Todas las categorías y su propio perfil de usuario para el cliente. Aplicar ambos cambios.
Detenga e inicie el complemento Media Streaming en el App Center. Luego verifique nuevamente la liberación del dispositivo y configúrelo nuevamente si es necesario.
Las listas de reproducción están disponibles como M3U, PLS o WPL; M3U8 no es compatible. Utilice UTF-8 y rutas relativas válidas. El orden de seguimiento sigue siendo incorrecto en los tres formatos.

Los nombres de archivos que contienen un signo de interrogación pueden causar problemas cuando se copian mediante Windows/SMB. Copie los archivos afectados directamente desde el almacenamiento USB a la carpeta de música adecuada utilizando QNAP File Station.

Para el orden de los álbumes, mantenga la música de cada álbum en una carpeta. Para varios discos, utilice subcarpetas como CD 1 y CD 2, con números de pista únicos y positivos. QNAP utiliza sólo el primer género. El orden de la lista de reproducción sigue siendo incorrecto con M3U, PLS y WPL; cambiar entre ellos no resuelve esto.

Agregue Gerbera para MusicServer Connect

Continúe usando la biblioteca existente en Público/música y Gerbera después de la siguiendo instrucciones paso a paso . Luego conéctese a la URL del dispositivo de Gerbera en el complemento y verifique las pistas, las etiquetas y el pedido. Mantenga el complemento Media Streaming ejecutándose para WiiM Home Advanced Mode u otros dispositivos, seleccionando allí el servidor estándar de QNAP. Utilice Gerbera en MusicServer Connect para BPM/key y corrija el orden de la lista de reproducción. Si WiiM Home también necesita listas de reproducción confiables del mismo servidor, MinimServer es una solución compartida adecuada. Ambos servicios leen los mismos archivos de música.

Notas del proveedor: Formato M3U, UTF-8 y rutas relativas así como también Compartir dispositivos manualmente en el complemento de transmisión de medios.

QNAP: Configurar Gerbera con corrección WavPack paso a paso

Gerbera es un software de servidor multimedia adicional para su QNAP. Su beneficio clave para MusicServer Connect es el acceso a los valores ya almacenados en sus archivos de música: BPM y metadatos de claves musicales: El servidor de medios UPnP integrado de QNAP no proporciona esta información. Los siguientes pasos configuran las asignaciones de metadatos requeridas.

El soporte de la lista de reproducción también puede hablar por Gerbera: El servidor UPnP estándar QNAP descrito aquí no muestra las listas de reproducción M3U8. Para los formatos reconocidos M3U, PLS, ASX y WPL, no conserva el orden de las pistas. Por lo tanto, cambiar el nombre de M3U8 a M3U no soluciona el pedido. Gerbera es una alternativa si necesita M3U8 o un orden de reproducción exacto.

¿Cuándo no necesitas Gerbera? Si sus archivos no tienen valores de clave/BPM almacenados y el orden de la lista de reproducción no es importante, no necesita Gerbera para estos fines. VirtualDJ puede calcular BPM y la clave musical analizando archivos sin un servidor de música. Puede conservar el servidor de medios integrado de QNAP y dejar que VirtualDJ los calcule.

El propio servidor de medios de QNAP puede seguir ejecutándose junto con Gerbera, por ejemplo para WiiM Home Advanced Mode. Gerbera no admite este modo WiiM. Tu música permanece en su carpeta existente; Gerbera obtiene acceso de solo lectura. Esta guía también permite la detección automática de archivos nuevos y modificados.

Versión recomendada: Esta guía utiliza la compilación oficial de Git Gerbera. 3.3.0-77 de la revisión de la fuente 245e723. La imagen de Docker se configura con la etiqueta y la suma de comprobación SHA-256; contiene las correcciones ya solicitadas WavPack y títulos de listas de reproducción repetidos así como también múltiples géneros en WebM/WMV y mayor precisión BPM. En el caso de una actualización con una configuración existente, esto también Agregar asignaciones de lectores. Es un estado de desarrollo según 3.3.0, no una nueva versión estable.

Gerbera 3.3.0 es incorrecto durante la importación de WavPack: La imagen 3.3.0 sin cambios se puede leer al leer desde .wvarchivos. En la compilación utilizada aquí, la memoria afectada se asigna en el montón. WavPack sigue siendo totalmente utilizable; no se requiere ningún script de parche adicional. Utilice la referencia de imagen completa que se muestra arriba.

1. Preparar carpetas, usuarios y archivos.

Inicie sesión en QTS con una cuenta de administrador activa cuya contraseña conozca. La cuenta incorporada admin no es necesario activarlo para ello; otra cuenta de administrador autorizada es suficiente.
Instalar en Centro de aplicaciones la aplicación Estación de contenedores. Ábralo y complete la configuración inicial. La consola multimedia y el complemento de transmisión multimedia no son necesarios para Gerbera.
Crear bajo Panel de control → Permiso → Usuarios → Crear el usuario gerbera . Este usuario no necesita derechos de administrador. Concédale acceso de lectura al recurso compartido de música, incluidas sus carpetas y archivos. Continúe usando su cuenta de administrador para SSH.
Los ejemplos utilizan la carpeta de música. Public/music, en el NAS /share/Public/music. Para otro recurso compartido, utilice su ruta real. Tu música existente puede permanecer allí. Eliminar caracteres ilegales Windows como ? a partir de nombres de archivos y ajustar las referencias de las listas de reproducción si es necesario; las etiquetas de título aún pueden contener estos caracteres.
Crear en Estación de archivos bajo Public la carpeta gerbera-qnap y su subcarpeta vacía empty .
Descarga el Redactar archivo como compose.yaml . Cárguelo directamente a través de File Station a Public/gerbera-qnap al lado de la carpeta empty. El nombre del archivo debe compose.yaml sin adicional .txt.

2. Habilite SSH y obtenga acceso root

Abrir en QTS Panel de control → Servicios de red y archivos → Telnet/SSH.
Habilitar Permitir conexión SSH, salir del puerto en 22 y haga clic en Aplicar. si Editar permisos de acceso se ofrece, permita que su cuenta de administrador acceda allí. Si el firewall NAS está activo, el puerto SSH de su computadora debe estar permitido en la red local.
Abra Terminal en Windows-PC o PowerShell en Mac Terminal. Reemplazar en el siguiente comando DEIN_QTS_KONTO a través de su cuenta de administrador y NAS_IP con la dirección IP QNAP.

ssh DEIN_QTS_KONTO@NAS_IP

Al establecer la conexión por primera vez, compruebe la dirección de destino que se muestra y confirme la consulta con yes. Ingrese la contraseña de su cuenta QTS. No aparecen caracteres ni asteriscos al escribir. Úselo si se usa un puerto SSH diferente ssh -p PORTNUMMER DEIN_QTS_KONTO@NAS_IP.

Luego cambie a derechos de root:

sudo -i
id

Si solicita su contraseña nuevamente, use la misma contraseña de su cuenta QTS registrada. No es necesaria una contraseña de root especial. La salida de id debe uid=0 incluido; en QNAP se puede encontrar el nombre de usuario asociado admin . Si aparece un menú de administración, sal de él usando la opción Shell o Salir. Deje el terminal abierto durante la configuración: todos los siguientes comandos del terminal se ejecutan en el QNAP.

Determine las ID del usuario creado para acceder a la música:

id gerbera

Si la salida muestra uid=1001(gerbera) gid=100(everyone) es UID 1001 y GID 100. Escriba sus propios números para el archivo de redacción.

3. Personalizar el archivo de redacción

Abre el descargado compose.yaml usando un editor de texto, reemplace los valores de ejemplo para UID y GID a través de los números del paso 2 y vuelva a cargar el archivo guardado Public/gerbera-qnap alto. El mapeo de música inicialmente apunta a la carpeta vacía. La música existente sólo se importa después de la configuración de los metadatos.

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:

La imagen oficial selecciona la variante ARM64 o AMD64 adecuada para los modelos NAS compatibles. La plantilla no contiene una dirección IP fija de NAS. --interface eth0 utiliza la dirección de esta interfaz de red. Para dispositivos con múltiples puertos, conmutadores virtuales o agrupación de puertos, reemplace eth0 a través de la interfaz realmente utilizada para la red doméstica. network_mode: host habilita la detección UPnP en la red NAS.

/mnt/content:ro permanece sin cambios como ruta contenedora y solo permite leer la música. el volumen gerbera-data Guarda la configuración y la base de datos de forma permanente. restart: unless-stopped inicia el contenedor nuevamente después de un reinicio NAS si no se detuvo manualmente de antemano.

4. Iniciar aplicación con biblioteca vacía

Abierto Estación de contenedores → Aplicaciones → Crear. usa el nombre gerbera-qnap.
Añade el contenido completo de tu personalizado compose.yaml en el campo YAML. Mantenga las sangrías con espacios y haga clic Validar.
Cree e inicie la aplicación. La primera descarga de la imagen puede tardar algún tiempo. Espere hasta gerbera-qnap se muestra como activo.
Abierto http://NAS_IP:49494/ en tu navegador. Una URL web faltante en Container Station no impide el acceso directo. En esta etapa, la biblioteca Gerbera está intencionalmente vacía.

5. Configurar BPM, visualización de claves y títulos

Abierto en Gerbera configuración y elige en lista de moda la vista Experto. bajo Library Options → taglib Library Options → metadatos y debajo ffmpeg Library Options → Metadatos las siguientes asignaciones. Preservar otras líneas existentes.

Tag Name y Upnp metadata entry
Biblioteca	Tag Name	Upnp metadata entry
taglib	BPM	upnp:beatsPerMinute
taglib	KEY	upnp:key
taglib	INITIALKEY	upnp:initialKey
ffmpeg	bpm	upnp:beatsPerMinute
ffmpeg	clave	upnp:key
ffmpeg	clave inicial	upnp:initialKey

bajo Servidor → Nombre el nombre Gerbera QNAP un. De esta forma, el servidor podrá distinguirse posteriormente de los demás servidores de música.
Para AIFF a continuación Importar → Asignaciones → Mimetype-ContentType las dos asignaciones audio/x-aiff → aiff y audio/aiff → aiff suplemento. Sin estas asignaciones, es posible que falten BPM, clave y otros géneros a pesar de las etiquetas existentes. Configuración AIFF.
Para OGV a continuación ffmpeg Library Options la opción streams-enabled Actívelo para que las etiquetas se lean de las pistas de audio y video. Configuración OGV.
Establezca el campo para taglib y ffmpeg charset en UTF-8. también filesystem-charset, metadata-charset y playlist-charset debería UTF-8 uso.
bajo UPnP → Título Elemento de resultado vaciar el campo con M_ARTIST y recibir M_TITLE. Esto proporciona el título de la pista simple.
bajo WavPack Library Options permanece Habilitado encendido.
Haga clic en Guardar configuración, reinicie el contenedor vacío en Container Station y luego de volver a abrir la configuración verifique que los valores estén guardados.

BPM y Key ya deben estar guardados en los archivos de música; Gerbera no calcula estos valores. Para MP4/M4A/M4V en el existente id3elemento prefer_highest_bpm_accuracy="yes" y prefer_ambigous_bpm_value="bpm_tag" según Configurar la precisión de BPM a los valores indicados. Sin la primera opción, se conserva el comportamiento anterior. Una nueva exploración normal puede omitir archivos que ya se han importado y no han cambiado. Configure estas opciones antes de importar música por primera vez. Las etiquetas de género separadas no necesitan configuración adicional.

6. Habilitar actualizaciones automáticas

Gerbera ya monitorea archivos nuevos y modificados automáticamente. Agregue detección de cambios de atributos de archivos con este bloque completo en la terminal raíz abierta:

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

Al comienzo de la sección de escaneo automático de salida debe inotify-attrib="yes" estar de pie. La configuración está en el volumen de datos persistentes y se cargará en el siguiente inicio.

7. Monte la carpeta de música e inicie Gerbera.

Detener el proyecto o aplicación gerbera-qnap en Estación de Contenedores.
Abierto Public/gerbera-qnap/compose.yaml en la estación de archivos. Reemplace únicamente la asignación de carpeta vacía con su carpeta de música real, por ejemplo:

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

Guarde el archivo en el NAS, luego copie el siguiente bloque completo en el terminal root abierto. Aplica el archivo Compose modificado, reutiliza el volumen de datos existente e inicia Gerbera. Si la ruta de su proyecto es diferente, ajuste la primera línea cd … encendido. El proceso también se aplica a los archivos 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

Entonces ábrelo http://NAS_IP:49494/ y espere a que se cargue la biblioteca. Puedes ver el progreso a continuación. Estación de contenedores → Contenedor → gerbera-qnap → Protocolo. Continúe copiando solo archivos completamente preparados en la carpeta de música. Las listas de reproducción requieren rutas de archivo relativas válidas y codificación UTF-8.

8. Conectar MusicServer Connect

En MusicServer Connect, seleccione el servidor Gerbera QNAP. Usar para una conexión manual http://NAS_IP:49494/description.xml. Verifique el inventario de pistas, los valores clave/BPM guardados y el orden de sus listas de reproducción.

Si tiene problemas de conexión, verifique el estado del contenedor, la IP de NAS, la interfaz de red y los posibles conflictos de puertos. Para la detección UPnP debe UDP 1900, para la interfaz web y el acceso a los medios TCP 49494 ser accesible en la red local. en Permission denied controla UID, GID y los permisos de lectura del usuario Gerbera. el camino /content en el protocolo Gerbera es normal para la imagen oficial.

Salga de la terminal con exit; después sudo -i Por lo general, esto se requiere dos veces. Si no necesita SSH, elimínelo en QTS Panel de control → Servicios de red y archivos → Telnet/SSH la casilla de verificación para Permitir conexión SSH y haga clic en Aplicar.

9. Reinicios y versiones más nuevas de Gerbera

Para un reinicio normal seleccione Estación de contenedores → Contenedor → gerbera-qnap → Reiniciar. La configuración y la base de datos permanecen en el volumen de datos nombrado gerbera-data recibido. Al reconstruir el contenedor, se utiliza el ejecutable sin cambios de la imagen oficial.

Cambiar desde una instalación 3.3.0 existente

Utilice la referencia de imagen completa de esta guía y conserve la configuración de música, ID de usuario, nombres de proyectos y volúmenes de datos. Vuelva a crear el contenedor como se muestra a continuación. Un simple reinicio no instala una imagen diferente. Reemplazar el contenedor elimina cualquier parche binario local anterior.

Actualice a una versión estable más tarde

Elige en el página oficial de lanzamiento de Gerbera una versión estable que incluye la corrección WavPack PR #3981 . Lea las notas de configuración y base de datos. Hasta que dicha versión esté disponible, la versión de Git especificada explícitamente aquí es una compilación provisional fija. No utilice un móvil latest- o edgeetiqueta.
Abierto Public/gerbera-qnap/compose.yaml. Reemplace eso el valor completo después image: a través de gerbera/gerbera:NEUE_VERSION. Esto también incluye eliminar los anteriores. @sha256:…referencia, ya que pertenece a la imagen antigua. Reemplazar NEUE_VERSION con el número de versión seleccionado. Alternativamente, utilice la referencia de imagen completa de la guía actualizada. Mantenga todas las demás configuraciones sin cambios.
Si es necesario, habilite SSH como se describe arriba e inicie sesión en el terminal raíz. Descarga la imagen seleccionada:

docker pull gerbera/gerbera:NEUE_VERSION

Detenga el proyecto o aplicación existente en Container Station. Ejecute el bloque de comando completo Paso 7 fuera. El volumen de datos existente no debe eliminarse.
Espere a que finalice el inicio y cualquier actualización de la base de datos. Verifique la versión, el nombre del servidor y el protocolo, y guardó la configuración de clave/BPM. Conecte MusicServer Connect y consulte varias pistas, archivos WavPack y listas de reproducción.

Guías de proveedores: Estación de contenedores QNAP y cambios en YAML, Habilite SSH en QNAP, Crear usuario QTS, Imagen oficial de Docker Gerbera.

Synology: Configurar Gerbera con corrección WavPack paso a paso

Gerbera es un software de servidor multimedia adicional para su Synology. Su beneficio clave para MusicServer Connect es el acceso a los valores ya almacenados en sus archivos de música: BPM y metadatos de claves musicales: El servidor de medios UPnP integrado de Synology no proporciona esta información. Los siguientes pasos configuran las asignaciones de metadatos requeridas.

¿Cuándo no necesitas Gerbera? Si sus archivos de música no contienen valores de clave/BPM almacenados, no necesita Gerbera para este propósito. VirtualDJ puede calcular BPM y la clave musical analizando los archivos sin un servidor de música. Puede seguir usando el servidor de medios integrado de Synology y dejar que VirtualDJ los calcule.

El propio servidor de medios de Synology puede seguir ejecutándose junto con Gerbera, por ejemplo para WiiM Home Advanced Mode. Gerbera no admite este modo WiiM. Tu música permanece en su carpeta existente; Gerbera obtiene acceso de solo lectura. Esta guía también permite la detección automática de archivos nuevos y modificados.

1. NAS y preparar a los usuarios

Inicie sesión en la interfaz Synology DSM con una cuenta que pertenezca al grupo administrador escuchado. Esta es una cuenta que puede administrar paquetes y usuarios. El nombre de la cuenta no tiene por qué admin leer. Si su cuenta no tiene estos derechos, necesitará a la persona que administra el NAS.
abre esto Centro de paquetería e instalar Administrador de contenedores. Si este paquete no está disponible para su modelo, esta guía no se aplica a él. Para editar el archivo YAML, también puede instalar el paquete Synology editor de texto instalar.
Abierto Panel de control → Usuarios y grupo → Usuarios → Crear. Crear el usuario gerbera encendido. No requiere derechos de administrador. Asigne su propia contraseña; Continuará utilizando su cuenta de administrador de DSM para los siguientes comandos de terminal.
Abierto Panel de control → Carpeta compartida, seleccione su carpeta de música, por ejemplo musicy elige Editar → Permisos. Dar al usuario gerbera permiso Sólo lectura. El acceso también debe aplicarse a las carpetas y archivos de música incluidos.

Los ejemplos utilizan /volume1/music como carpeta de música y /volume1/docker para archivos contenedores. Si estas carpetas están en un volumen diferente, use sus rutas NAS reales en las ubicaciones apropiadas. Los caminos de los contenedores /mnt/content y /var/run/gerbera sigue igual.

2. Crear carpetas y copiar archivos.

Abierto Estación de archivos. En la carpeta compartida, cree docker la subcarpeta gerbera-synology . Si la carpeta compartida docker falta, créelo bajo Panel de control → Carpeta compartida → Crear .
Crea otra subcarpeta llamada empty encendido. Esta carpeta permanece vacía. Sirve como una carpeta de música temporal para que la importación sólo comience después de que se hayan configurado los metadatos.
Descarga el Redactar archivo como compose.yaml a tu computadora.
Sube el archivo usando Estación de archivos → Cargar directamente en docker/gerbera-synology al lado de la carpeta empty. El nombre del archivo debe ser exactamente compose.yaml sin adicional .txt estar adjunto.

La carpeta del proyecto contiene estas dos entradas:

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

3. Active SSH, inicie sesión en NAS y determine sus ID

Necesita acceso a la terminal NAS para encontrar ID de usuario y ejecutar los siguientes comandos de Docker. Puede copiar los comandos que se muestran aquí; No se requieren conocimientos de programación.

Verifique la cuenta y contraseña de DSM

Abrir en DSM Panel de control → Usuario y grupo → Usuario. Resalte la cuenta que desea usar para iniciar sesión más tarde a través de SSH y haga clic en Editar.
La cuenta debe estar activada: Si es necesario, elimine la selección. Desactivar esta cuenta de usuario. Después de guardar, la lista de usuarios debe mostrar el estado. normales en lugar Discapacitado se muestran.
bajo Grupos de usuarios la cuenta debe pertenecer a administrador grupo. Necesita la contraseña de esta cuenta para iniciar sesión y luego cambiar a root. Si no la conoce, establezca y confirme una nueva contraseña en la configuración de la cuenta. Guarde los cambios.

Puede utilizar su cuenta de administrador de DSM existente para hacer esto. ¿Quieres específicamente la cuenta integrada? admin Para usarlo, active esta cuenta como se describe y asigne una contraseña conocida. La cuenta incorporada admin No es necesario activarlo si tienes otra cuenta activa del grupo. administrators uso. El usuario creado en el paso 1 gerbera se utiliza exclusivamente para acceder a la música y no requiere estos derechos de administrador.

Active el servicio SSH en el NAS

En DSM, abra el Panel de control y allí Terminal y SNMP. Seleccione la pestaña terminales.
Seleccione la casilla de verificación para Habilitar el servicio SSH. Para esta guía, salga del puerto en 22 se muestran.
Haga clic en Aplicar. Sólo entonces el NAS aceptará conexiones SSH. Si el firewall de DSM está activo, debe permitir el puerto SSH configurado para su computadora en la red local.

Inicie sesión desde su computadora y cambie a root

Puede encontrar la dirección IP NAS en Panel de control → Red → Interfaz de red. Abrir en la PC Windows terminales o PowerShell; en una Mac, la aplicación terminales.
Ingrese este comando. Reemplazar DEIN_DSM_KONTO con su cuenta de administrador de DSM y NAS_IP con su dirección IP NAS. No utilice el usuario recién creado gerbera.

ssh DEIN_DSM_KONTO@NAS_IP

Cuando se establece la conexión por primera vez, puede aparecer una consulta sobre la identidad del NAS. Verifique la dirección de destino que se muestra y confirme la conexión con yes. Luego ingrese la contraseña de su cuenta DSM. No aparecen caracteres ni asteriscos mientras escribe la contraseña; esto es normal. Si utiliza un puerto SSH diferente, agréguelo al conectarse. -p PORTNUMMER.

Luego cambie a los derechos requeridos para Docker con este comando:

sudo -i

Si se le solicita una contraseña nuevamente, use la misma contraseña de su cuenta DSM. No se requiere una contraseña especial root. El mensaje suele terminar con #. Mantenga abierta esta ventana de terminal durante la instalación. Todos los siguientes comandos de terminal se ejecutan allí en el NAS.

Para Connection refused Primero verifique si está utilizando el servicio SSH Aplicar encendidos y están utilizando la dirección IP y el número de puerto correctos. Si se rechaza la contraseña, verifique el nombre de la cuenta, la contraseña y el estado. normales y membresía en administrador. Guía de Synology para iniciar sesión SSH con privilegios de root También describe este proceso.

Ver ID de usuario de Gerbera:

id gerbera

Salida como uid=1030(gerbera) gid=100(users) significa: UID es 1030, GID es 100. Tenga en cuenta los números de su propia salida: identifican al usuario y al grupo.

4. Personalizar el archivo de redacción

En File Station, abra el archivo docker/gerbera-synology/compose.yaml con editor de texto. Alternativamente, edítelo en su computadora y cárguelo nuevamente. Para UID y GID ingrese los números que acaba de anotar; debe reemplazar los valores de ejemplo a continuación. Si es necesario, ajuste la ruta NAS a la carpeta del proyecto vacía. Guarde el archivo.

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 permite la detección en la red doméstica sin una dirección IP fija en YAML. el fin :ro Gerbera sólo permite leer la carpeta de música. en volumen gerbera-synology-data La configuración y la base de datos se guardan permanentemente. restart: unless-stopped permite que el contenedor NAS se inicie nuevamente después de reiniciar NAS, siempre que no lo haya detenido manualmente de antemano.

5. Inicie el proyecto con una biblioteca vacía.

Abierto Administrador de contenedores → Proyecto → Crear. Utilice exactamente este nombre de proyecto: gerbera-synology y la carpeta preparada como ruta docker/gerbera-synology.
Elige el preparado compose.yaml como un archivo de redacción existente. Si el cuadro de diálogo ofrece un editor YAML, puede insertar el contenido allí.
Para Configuración del portal web permanece Configurar el portal web a través de Web Station apagado. Haga clic en Siguiente y crear e iniciar el proyecto. La primera descarga de la imagen puede tardar algún tiempo.
bajo Contenedor → gerbera-synology debe ser el estado corriendo o corriendo aparecer.
Abrir en el navegador http://NAS_IP:49494/, por ejemplo http://192.168.1.10:49494/. Reemplace la dirección de ejemplo con su IP NAS. Ves la superficie de Gerbera; la biblioteca de música está intencionalmente vacía en este punto.

6. Configurar BPM, visualización de claves y títulos

Abierto en Gerbera configuración y seleccione la vista Experto. bajo Library Options → taglib Library Options → metadatos así como bajo ffmpeg Library Options → Metadatos agregue las siguientes líneas, conservando otras asignaciones existentes.

Tag Name y Upnp metadata entry
Biblioteca	Tag Name	Upnp metadata entry
taglib	BPM	upnp:beatsPerMinute
taglib	KEY	upnp:key
taglib	INITIALKEY	upnp:initialKey
ffmpeg	bpm	upnp:beatsPerMinute
ffmpeg	clave	upnp:key
ffmpeg	clave inicial	upnp:initialKey

bajo Servidor → Nombre el nombre Gerbera Synology un. De esta forma, el servidor podrá distinguirse posteriormente de los demás servidores de música.
Para AIFF a continuación Importar → Asignaciones → Mimetype-ContentType las dos asignaciones audio/x-aiff → aiff y audio/aiff → aiff suplemento. Sin estas asignaciones, es posible que falten BPM, clave y otros géneros a pesar de las etiquetas existentes. Configuración AIFF.
Para OGV a continuación ffmpeg Library Options la opción streams-enabled Actívelo para que las etiquetas se lean de las pistas de audio y video. Configuración OGV.
Establecer el campo charset para taglib y ffmpeg a UTF-8. también filesystem-charset, metadata-charset y playlist-charset debería UTF-8 uso.
bajo UPnP → Título Elemento de resultado vaciar el campo con M_ARTIST y recibir M_TITLE. El nombre del título puro se transfiere como título en lugar de “Artista – Título”.
bajo WavPack Library Options permanece Habilitado encendido.
Haga clic en Guardar configuración, reinicie el contenedor en Container Manager y verifique que los valores se guarden después de volver a abrir la configuración de Gerbera.

BPM y Key ya deben estar guardados en los archivos de música; Estas configuraciones no calculan los valores. Para MP4/M4A/M4V en el existente id3elemento prefer_highest_bpm_accuracy="yes" y prefer_ambigous_bpm_value="bpm_tag" según Configurar la precisión de BPM a los valores indicados. Sin la primera opción, se conserva el comportamiento anterior. Luego importe los archivos afectados nuevamente.

7. Habilitar actualizaciones automáticas

Gerbera ya monitorea archivos nuevos y modificados automáticamente. Con el siguiente bloque puedes agregar la detección de cambios en los atributos del archivo. Copie el bloque completo en la terminal NAS aún abierta:

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

En la salida debe estar al comienzo de la sección de escaneo automático. inotify-attrib="yes" estar de pie. El archivo está en el volumen de datos permanente. La configuración se cargará con la carpeta de música cuando la inicies posteriormente.

8. Monte la carpeta de música e inicie Gerbera.

Detener el proyecto o aplicación gerbera-synology en el Administrador de contenedores.
Abierto docker/gerbera-synology/compose.yaml en la estación de archivos. Reemplace únicamente la asignación de carpeta vacía con su carpeta de música real, por ejemplo:

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

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

Entonces ábrelo http://NAS_IP:49494/ y espere a que se cargue la biblioteca. Puedes ver el progreso a continuación. Administrador de contenedores → Contenedor → gerbera-synology → Protocolo. Continúe copiando solo archivos completamente preparados en la carpeta de música. Las listas de reproducción requieren rutas de archivo relativas válidas y codificación UTF-8.

9. Conéctate con MusicServer Connect

En MusicServer Connect, seleccione el servidor Gerbera Synology. Si se necesita una URL del dispositivo, utilice http://NAS_IP:49494/description.xml. Verifique sus canciones, álbumes y listas de reproducción y abra algunas canciones con BPM guardados y valores clave.

Si no se puede acceder a la interfaz o no se encuentra el servidor, primero verifique el estado del contenedor y la IP NAS. Si el firewall DSM está activado TCP 49494 y para detección UPnP UDP 1900 desde su red local. Si el registro informa Permission denied para la carpeta de música, verifique el permiso de lectura del usuario gerbera y los UID y GID del paso 3. el camino /content en el protocolo es normal para la imagen oficial; se refiere a la carpeta de música integrada.

Luego, salga de la terminal con exit salir; después sudo -i suele ser dos veces exit necesario. Si no necesita SSH, ábralo en DSM Panel de control → Terminal y SNMP → Terminal, desactive la casilla de verificación para Habilitar el servicio SSH y haga clic en Aplicar.

10. Reinicios y versiones más nuevas de Gerbera

Para un reinicio normal seleccione Administrador de contenedores → Contenedor → gerbera-synology → Reiniciar. La configuración y la base de datos permanecen en el volumen de datos nombrado gerbera-synology-data recibido. Al reconstruir el contenedor, se utiliza el ejecutable sin cambios de la imagen oficial.

Cambiar desde una instalación 3.3.0 existente

Actualice a una versión estable más tarde

Elige en el página oficial de lanzamiento de Gerbera una versión estable que incluye la corrección WavPack PR #3981 . Lea las notas de configuración y base de datos. Hasta que dicha versión esté disponible, la versión de Git especificada explícitamente aquí es una compilación provisional fija. No utilice un móvil latest- o edgeetiqueta.
Abierto docker/gerbera-synology/compose.yaml. Reemplace eso el valor completo después image: a través de gerbera/gerbera:NEUE_VERSION. Esto también incluye eliminar los anteriores. @sha256:…referencia, ya que pertenece a la imagen antigua. Reemplazar NEUE_VERSION con el número de versión seleccionado. Alternativamente, utilice la referencia de imagen completa de la guía actualizada. Mantenga todas las demás configuraciones sin cambios.
Si es necesario, habilite SSH como se describe arriba e inicie sesión en el terminal raíz. Descarga la imagen seleccionada:

docker pull gerbera/gerbera:NEUE_VERSION

Detenga el proyecto o aplicación existente en Container Manager. Ejecute el bloque de comando completo Paso 8 fuera. El volumen de datos existente no debe eliminarse.
Espere a que finalice el inicio y cualquier actualización de la base de datos. Verifique la versión, el nombre del servidor y el protocolo, y guardó la configuración de clave/BPM. Conecte MusicServer Connect y consulte varias pistas, archivos WavPack y listas de reproducción.

Guías de proveedores: Proyectos de gestión de contenedores, Modelos NAS disponibles para Container Manager, Inicio de sesión SSH con derechos de administrador, Imagen oficial Gerbera.

WiiM Home: biblioteca multimedia ampliada

WiiM Home Advanced Mode proporciona su propia vista de biblioteca con categorías de álbumes, artistas y pistas. Los servidores compatibles incluyen MinimServer, el servidor estándar de Synology, el servidor estándar de QNAP y Serviio. Actualmente, Gerbera proporciona la vista de carpetas en WiiM Home.

En Advanced Mode, WiiM importa metadatos del servidor a su propio índice, luego crea vistas uniformes de álbumes, artistas, pistas, listas de reproducción y géneros y su propia búsqueda. En Legacy Mode, muestra la navegación del servidor. Estos términos describen los modos de funcionamiento del WiiM Home.

Recomendación para compartir

Los servidores estándar Synology y QNAP admiten WiiM Home Advanced Mode, que no necesita BPM ni metadatos clave. El orden incorrecto de la lista de reproducción de QNAP también sigue siendo una limitación en WiiM Home.

Si VirtualDJ calcula BPM y la clave, el servidor de medios estándar de Synology es suficiente para MusicServer Connect. Lo mismo se aplica a QNAP si el orden incorrecto de la lista de reproducción es aceptable. En estos casos no es necesaria una instalación adicional de Gerbera.

Para usar valores clave/BPM almacenados o conservar el orden de la lista de reproducción QNAP en MusicServer Connect, puede agregar Gerbera con la corrección WavPack en Docker. Seleccione Gerbera en el complemento y el servidor estándar en WiiM Home Advanced Mode. Ambos pueden leer la misma biblioteca de música. MinimServer sigue siendo una solución de servidor único que cubre estos requisitos y WiiM Home Advanced Mode; todavía necesita la configuración adicional BPM/etiqueta clave. La ejecución de Gerbera en Synology requiere un Administrador de contenedores disponible.

Más información: WiiM Home: biblioteca multimedia y servidores compatibles.

Ampache 7/8: Leer vídeos y listas de reproducción de archivos

Un catálogo de música no importa vídeos a Ampache. Para la videoteca, un catálogo local adicional con el tipo de medio. Vídeo y escanearlo. Las rutas del catálogo no deben superponerse. Por lo tanto, nuestra configuración utiliza una vista de directorio Linux adicional de solo lectura que apunta a los mismos archivos de video; los archivos de la biblioteca compartida permanecen sin cambios.

Importe listas de reproducción basadas en archivos explícitamente. El comando CLI oficial es php bin/cli run:updateCatalog -i "Katalogname"; utilice la versión de PHP y la cuenta de servicio apropiadas para su instalación. Una nueva exploración de metadatos por sí sola no es suficiente. En nuestra comparación, ambas versiones proporcionaron entradas de audio con repeticiones; Las entradas de vídeo estaban ausentes en las listas de reproducción de archivos mixtos.

Entregar MP3 sin cambios

Si se permite la conversión automática de MP3 pero no se configura ningún convertidor, Ampache 8 puede devolver HTTP 500 durante la transmisión. Para la entrega sin cambios en la configuración existente, transcode_mp3 = "false" al valor indicado. Alternativamente, configure un transcodificador que funcione. Con la conversión MP3 desactivada, tanto la transmisión como la descarga se verificaron byte por byte en nuestras comprobaciones.

LMS: Listas de reproducción con pistas del mismo álbum

En la configuración de LMS en Varios la opción Saltar listas de reproducción que contengan pistas del mismo álbum si quieres que aparezcan estas listas de reproducción. Luego recarga la biblioteca. La comparación confirmó que las pistas de audio repetidas se suministraron en su orden original.

Asset UPnP: carpetas multimedia y de listas de reproducción

En la interfaz web del activo en Carpetas → Carpetas multimedia agregue la carpeta de la biblioteca. bajo Carpetas de listas de reproducción especifique cada carpeta con archivos de lista de reproducción individualmente; Las carpetas de listas de reproducción subordinadas no se incluyen allí automáticamente. Estos están bajo prueba /srv/music/Playlists y /srv/music/Format-Test-1.3/Playlists.

bajo Opciones → Configuración de pantalla Desactive los prefijos para los números de pistas, los artistas antes de las pistas de compilación y los artistas después de los títulos de las listas de reproducción si desea nombres de pistas simples. Estas configuraciones cambian la visualización, no los archivos de música. El proveedor de activos utiliza la rama incorporada. Listas de reproducción para listas de reproducción de archivos. Esta consulta no atraviesa recursivamente combinaciones de filtros dinámicos ni radio por Internet. Se puede conservar la navegación predeterminada marcada, incluida la navegación dinámica. Las vistas de catálogo, artista, álbum y género se verificaron sin errores de recuperación después de este ajuste. Suministros de activos M3U, M3U8 y PLS; Los títulos de las pistas PLS devueltos por el servidor pueden contener un prefijo de artista.

Guía de activos

Jellyfin 12.2.0: DLNA y perfil de cliente

Jellyfin requiere el oficial para MusicServer Connect Complemento DLNA. Instálelo desde el catálogo oficial de complementos en la administración del servidor y reinicie Jellyfin. Se comprobó DLNA 14.0.0.0. En su configuración, elija la cuenta cuyas bibliotecas deben exponerse a través de DLNA. MusicServer Connect utiliza UPnP/DLNA, independientemente del inicio de sesión en la propia interfaz web de Jellyfin.

Bibliotecas y metadatos

Archivos de audio como tipo de biblioteca. musica, vídeos como Vídeos musicales como bibliotecas. Haga que las carpetas de listas de reproducción y medios relevantes sean legibles y luego escanee ambas bibliotecas. Para utilizar únicamente etiquetas de archivos, desactive los proveedores de imágenes y metadatos externos; También verifique la configuración global de artista y álbum. Mantenga habilitados los títulos incrustados y las imágenes locales. Nuestra configuración accede a la biblioteca de música compartida de solo lectura.

Perfil de cliente para MusicServer Connect

el Descargue un perfil de cliente DLNA verificado y como MusicServer Connect.xml Guárdelo en la carpeta de perfil de usuario del complemento DLNA. Esto es menor para la instalación nativa de Debian. /var/lib/jellyfin/plugins/configurations/dlna/user/; para otras instalaciones, utilice el directorio de datos actual Jellyfin. El servicio Jellyfin debe poder leer el archivo. Reinicie Jellyfin, luego actualice la biblioteca de complementos.

El perfil identifica MusicServer Connect por su User-Agent. Proporciona URL de recursos estables y tipos de medios correctos para audio M4A y video OGV, manteniendo accesibles las vistas de álbumes y estos formatos visibles en el catálogo. Se almacena por separado de los perfiles del sistema suministrados.

Restricciones restantes

Todas las fuentes de audio y video y las vistas del complemento 195 se recuperaron sin errores en la verificación con los archivos 125. A través de DLNA, Jellyfin no proporciona ninguna clave BPM y escala incorrectamente la tasa de bits. ASX/XSPF están ausentes; M3U, M3U8, PLS y WPL pierden pistas repetidas. Algunas listas antiguas de M3U/M3U8 también están incompletas. Algunos artistas de álbumes están mal asignados y es posible que las carpetas de música planas carezcan de una vista de álbum nativa. WMA carece de su segundo género; Los videos carecen de artista, álbum y género. El perfil del cliente no soluciona estas limitaciones.

Instalación oficial de Linux · Documentación oficial DLNA

WiiM Home, Mezzmo y Windows Media Player

Con estos servidores Windows, MusicServer Connect utiliza automáticamente las carpetas de archivos o pistas verificadas para evitar respuestas de búsqueda global incorrectas o muy lentas. No se necesita ninguna configuración de complemento adicional. Luego, las búsquedas de complementos se ejecutan en el catálogo importado.

Las respuestas UPnP pueden tardar hasta 30 segundos o 60 segundos para Windows Media Player. Las solicitudes siguen siendo cancelables. Las páginas no válidas o que cambian aún se rechazan; esperar más no puede proporcionar archivos o metadatos faltantes.

WiiM Home Media Server 0.2.10.5

Los servidores de música y VirtualDJ pueden ejecutarse en la misma PC Windows, incluidos varios servidores a la vez. La lista de servidores combina la detección UPnP normal con una comprobación adicional de los servidores locales compatibles. Identifica sus puertos abiertos reales y verifica las descripciones de los dispositivos UPnP. Las diferentes ID de dispositivos permanecen separadas; múltiples puntos finales para un servidor no crean entradas duplicadas. No se requieren derechos de administrador.

El descubrimiento UPnP normal de Windows no encontró WiiM Home en la misma PC en nuestra verificación, aunque se pudo acceder a la descripción de su dispositivo. El descubrimiento complementario del complemento lo encuentra como WiiM Home: LaptopAcer — en otra PC, use su nombre en su lugar. En el cuadro de diálogo de conexión, haga clic en Buscar de nuevo y seleccione el servidor WiiM. Esta conexión UPnP no necesita nombre de usuario ni contraseña. Se comprobó que WiiM Home, Mezzmo y Windows Media Player se ejecutaban simultáneamente.

Para una versión anterior del complemento, la dirección de descripción completa se puede guardar temporalmente en URL servidor aquí. Por ejemplo, la ruta local marcada es http://127.0.0.1:22346/upnp/DeviceDescription.xml. El puerto y la ruta deben pertenecer al servidor en ejecución; el complemento no asume un puerto fijo. En esta computadora, el puerto 22345 también expuso el mismo servidor WiiM. El nombre de host escrito localhost devolvió HTTP 404 en una verificación directa y no fue aceptado como reemplazo equivalente. El error de descubrimiento no se puede atribuir de manera concluyente ni a WiiM Home ni a Windows.

Agregue la carpeta de música a la biblioteca multimedia local y active el uso compartido DLNA. La fuente original se utilizó en la prueba. \\smbserver\music . Esta interfaz no proporciona listas de reproducción ni vídeos basados en archivos; AAC ADTS, Opus y WavPack también están ausentes. Las listas de reproducción guardadas en la aplicación WiiM no son compatibles con la importación de archivos de listas de reproducción externos.

Mezzmo 6.0.6.0

Agregue la carpeta Biblioteca, incluidas las subcarpetas. Listas de reproducción de archivos externos separadas mediante Crear lista de reproducción → Lista de reproducción conectada . “Agregar archivos desde una lista de reproducción externa” importa medios referenciados y es una operación diferente. Para conservar las etiquetas de archivos originales, deje desactivadas la recuperación y escritura automática de metadatos de Internet.

Oferta de propiedades de carpeta Compruebe las carpetas en busca de archivos nuevos cada. Las listas ya vinculadas tienen resultados separados. La supervisión de carpetas por sí sola no creaba listas vinculadas a partir de archivos de listas de reproducción, incluso con extensiones de listas de reproducción adicionales configuradas. Actualizar un enlace existente y descubrir nuevos archivos de lista de reproducción son características diferentes. Las listas marcadas por separado pierden repeticiones con M3U/PLS/WPL; M3U8/XSPF permanecen vacíos y ambas muestras de ASX informan recuentos de páginas inconsistentes. Las listas de reproducción inteligentes no pueden sustituir un orden externo fijo con repeticiones.

El filtro predeterminado incluye .aif pero no .aiff. Al agregar *.aiff, la muestra se indexó solo como un tipo de archivo desconocido sin secuencia, por lo que este cambio se revirtió. WavPack tampoco fue expuesto como jugable para el cliente marcado. Una entrada en la base de datos por sí sola no prueba la jugabilidad.

Windows Media Player Legado / Compartir 12.0

bajo Panel de control → Centro de redes y recursos compartidos → Opciones de transmisión de medios en Permitir todo haga clic y con Aceptar guardar. Esto les da a los dispositivos en la red local, incluido WiiM, y al teléfono celular con WiiM Home acceso a la biblioteca multimedia. en Acceso denegado Verifique la aprobación de este dispositivo: el acceso a complementos en funcionamiento en la misma PC no significa que se permitan dispositivos externos.

Habilite la transmisión de medios para la red local y agregue carpetas locales de música y videos a sus bibliotecas Windows. Puede desactivar la recuperación y escritura automática de metadatos de Internet para conservar los archivos fuente. La comparación local completa arrojó archivos multimedia reales 146 y decodificó completamente todas las muestras de formato ofrecidas por 20. OGG, Opus, WavPack, WebM y OGV estuvieron ausentes; BPM y la clave no fueron suministradas. Después de reconstruir el catálogo de WMP, se devolvieron seis listas de reproducción no vacías. Algunos nombres difieren de las listas importadas; dos listas M3U más antiguas pierden una pista debido a la codificación de caracteres. Sus equivalentes WPL contienen las cuatro pistas.

Utilice nombres de listas de reproducción sin puntos, por ejemplo MSC Mixto 1-3 en lugar MSC Mixto 1.3. En la comparación específica de WPL, M3U y M3U8, WMP truncó los nombres de copia de importación guardados en el primer punto; el nombre abreviado también apareció en UPnP. Un guión conservó el nombre completo.

Para WMP, el complemento solicita listados solo de estructura con un pequeño filtro de metadatos. Los metadatos completos de la pista, los recursos y el contenido de la lista de reproducción aún se leen, y se conservan las comprobaciones de paginación y coherencia. Para esta biblioteca, la limpieza y la optimización del complemento redujeron la primera solicitud de catálogo medida de aproximadamente segundos 22 a segundos 4.3–4.6. Esta es una medida del proveedor para la biblioteca verificada, no una promesa general para la interfaz de VirtualDJ o bibliotecas más grandes.

Si su colección también contiene archivos de listas de reproducción, agregue solo las subcarpetas de audio reales a la biblioteca de música Windows y agregue carpetas de video por separado. Importe listas de reproducción explícitamente a WMP. Agregar toda la carpeta principal provocó que WMP expusiera algunos archivos de listas de reproducción como pistas de audio o listas vacías. Las importaciones repetidas crearon copias adicionales de WPL en la carpeta Windows. Música → Listas de reproducción. Antes de reconstruir, haga una copia de seguridad del catálogo WMP y archive las copias de importación antiguas y claramente identificadas fuera de las carpetas monitoreadas; reconstruir la base de datos por sí sola los indexaría nuevamente. Se conservan los medios y las listas de reproducción originales.

Los archivos multimedia en el recurso compartido SMB no funcionaron como biblioteca WMP DLNA en nuestra prueba, ni siquiera a través de la unidad de red. Y:. El servicio podía leer un archivo original y Samba ya permitía lectura y escritura, pero el catálogo de medios compartido permanecía vacío. Este hallazgo se aplica a la fuente de red marcada aquí, no a todas las configuraciones de SMB. Los archivos locales están cubiertos por una verificación local separada.

No se utilizaron archivos sin conexión Windows, ya que crean una copia local sincronizada. Después de reiniciar el servicio, la descripción del dispositivo WMP y UPnP root fueron accesibles nuevamente en aproximadamente tres segundos en nuestra verificación. Una entrada de servidor que falta inicialmente no requiere reconstruir automáticamente su biblioteca.

Documentación del fabricante

Configuración Gerbera

Gonic: carpetas de música

MinimServer: Configuración

MariaDB: alterar las columnas de la base de datos