Recomendações de configuração avançada

Atualizado em: 19.10.2026

As configurações de servidor necessárias e guias de instalação adicionais são coletados aqui. Os links de configuração na lista de compatibilidade levam às seções relevantes.

Navidrome: Agrupe álbuns independentemente da data de lançamento

Navidrome 0.64.2 também agrupa álbuns por data de lançamento por padrão. Se as tags de data em diferentes formatos de arquivo forem interpretadas como ano de gravação ou lançamento, o mesmo álbum poderá aparecer mais de uma vez.

Para ignorar as datas de lançamento ao agrupar álbuns, defina a seguinte regra em Navidrome. Substitua uma regra existente em vez de adicionar uma chave TOML duplicada. Se estiver adicionando uma nova regra, coloque-a no nível superior, antes das seções da tabela.

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

O ID do álbum MusicBrainz, o artista do álbum, o nome do álbum e a versão do álbum ainda determinam o agrupamento. A regra se aplica a toda a biblioteca. Lançamentos que diferem apenas por data podem ser combinados. Nenhuma alteração nas tags do arquivo de mídia é necessária.

Navidrome e reinicie. A regra do álbum alterada aciona uma verificação completa. Em seguida, recarregue a visualização do álbum nos clientes. Uma variável de ambiente ND_PID_ALBUM tem precedência sobre o arquivo de configuração e pode precisar ser ajustado de acordo.

Fonte: Navidrome: identificadores configuráveis de álbum e faixa.

Navidrome: dar prioridade às capas incorporadas

Quando faixas de álbuns diferentes partilham uma pasta, um Folder.jpg comum pode substituir todas as capas. Esta prioridade prefere uma capa incorporada disponível; na sua ausência, as restantes fontes continuam disponíveis como alternativa.

Em navidrome.toml, substitua o valor existente ou acrescente a definição no nível principal, antes das secções de tabela. Não duplique a chave.

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

Depois, reinicie o Navidrome. Reiniciar, por si só, não recalcula as capas guardadas. No Navidrome 0.64.2, é possível voltar a resolver os álbuns afetados individualmente com o comando artwork oficial:

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

Substitua o caminho de exemplo e os identificadores dos álbuns. Execute o comando com o mesmo utilizador de serviço, diretório de trabalho, configuração, ambiente e base de dados do Navidrome. Não é necessário alterar os ficheiros ou as etiquetas, nem eliminar a base de dados.

Depois, volte a sincronizar a biblioteca do cliente, por exemplo no Amperfy, para receber os novos identificadores das capas. Não é necessário reinstalar a aplicação nem limpar todo o cache de capas.

Ampache e LMS: Login com chave API

Ampache 7, Ampache 8 e LMS requerem uma chave API para login. Crie uma chave para sua própria conta no servidor e use-a ao conectar-se no MusicServer Connect. Mantenha-o confidencial.

Ampache 7.10.2: Importar títulos sem artistas de títulos

Sintoma e causa

Arquivos sem artista de faixa podem ser omitidos durante a importação do catálogo. A correção do banco de dados abaixo possibilita sua importação. O login Ampache requer uma chave API; veja Faça login com uma chave API.

Escopo

Esta correção se aplica a Ampache 7.10.2 com MariaDB e à definição de coluna mostrada abaixo. Para outras versões, verifique primeiro se a mesma causa se aplica.

O que mudou

Somente song.artist no banco de dados Ampache selecionado é alterado para permitir NULL. Seu tipo de dados, valor padrão 0 e índices existentes são mantidos. O código-fonte Ampache e os arquivos de música permanecem inalterados. Nenhum nome de artista é inventado e nenhuma tag de arquivo é substituída. Outros bancos de dados e configurações globais do MariaDB não são afetados.

Correção geral do banco de dados

Requisitos

Execute estes comandos no servidor MariaDB, dentro de seu contêiner quando aplicável. A conta do banco de dados precisa de acesso de leitura para verificação e permissão ALTER na música. O exemplo usa login root local. Para outra conta de banco de dados, use sua configuração de cliente seguro existente; não coloque uma senha no comando.

Primeiro identifique o nome real do banco de dados, listado como database_name na configuração Ampache. Use seu próprio nome de banco de dados em cada comando.

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

Para o problema confirmado, a saída mostra Type=int(11) unsigned, Null=NO e Default=0. Se for Null=YES, a correção já foi aplicada. Não altere uma definição diferente sem verificá-la.

Recomendado: o script anexo Baixar ampache7-null-artist.sh no servidor de banco de dados. Ele verifica a coluna, aceita apenas o tipo INT não assinado esperado e não faz mais alterações se NULL já for permitido. Um esquema inesperado o faz parar sem alterações.

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

O núcleo SQL concreto da correção para a definição confirmada acima é:

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

Importe os arquivos ausentes e verifique o resultado

Após alterar o esquema, importe os arquivos ausentes. Use o caminho do aplicativo, o nome do catálogo e a conta de serviço da sua própria instalação. A versão do PHP deve corresponder à versão 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 adiciona novos arquivos de mídia. Ele não solicita limpeza de catálogo, importação de lista de reprodução ou nova verificação de tags de arquivos existentes. Ampache pode então atualizar mapeamentos e contadores internos.

Em seguida, atualize o plugin, abra todos os títulos e verifique os títulos ausentes anteriormente. Então os títulos acima Todos os títulos → marcar todos → pesquisar banco de dados → adicionar ao banco de dados no banco de dados de pesquisa VirtualDJ. Veja Pesquisar nos nós da árvore.

Operação e atualizações posteriores

Este é um ajuste do esquema do banco de dados local, não uma migração geral Ampache oficialmente confirmada. Após uma atualização do banco de dados Ampache, verifique novamente song.artist e a importação de arquivos sem artistas de faixa: uma migração pode alterar a definição. O script pode ser verificado repetidamente.

Para restaurar NOT NULL, as entradas NULL existentes precisariam primeiro de tratamento deliberado; redefinir cegamente a coluna não é uma reversão apropriada. A correção marcada preserva os artistas das faixas ausentes como informações ausentes.

Gonic 0.22.0: um álbum por pasta de música

Sintoma e causa

Gonic requer uma pasta separada para cada álbum. Mantenha os arquivos de um álbum juntos; não misture álbuns diferentes em uma pasta. Uma pasta compartilhada para solteiros não relacionados não atende a esse requisito. Gonic pode então aplicar os metadados do álbum do primeiro arquivo, incluindo o artista do álbum, a todos os outros arquivos dessa pasta.

Estrutura de pastas recomendada

Para faixas avulsas, também crie uma subpasta por álbum, por exemplo «Einzeltitel/Alter Ego - Betty Ford (Bonus Remixes Version)» / «Einzeltitel/Homie Isback - Cherrymoon». As duas versões de Cherrymoon podem compartilhar a pasta se pertencerem ao mesmo álbum. Mantenha lançamentos diferentes separados. Coloque os arquivos de música em subpastas do caminho configurado: o Gonic 0.22.0 ignora arquivos diretamente na pasta raiz.

Se vários servidores compartilharem uma biblioteca, você poderá criar uma visualização de pasta separada para Gonic usando links simbólicos. Dê a cada álbum sua própria pasta também. Configure caminhos de música para que cada faixa seja indexada apenas uma vez. A conta de serviço Gonic precisa de acesso aos links e aos seus destinos.

Verifique após a alteração

Digitalize novamente o Gonic e atualize a lista de faixas do plugin. Verifique totais, agrupamento de álbuns, nós de artistas e reprodução. Alterações nos caminhos de importação podem criar novos IDs de servidor, portanto, verifique posteriormente os favoritos, listas de reprodução e configurações VirtualDJ existentes. Registre as faixas novamente, se necessário. Adicionar ao banco de dados de pesquisa VirtualDJ. As faixas individuais recém-adicionadas também devem ser fornecidas na estrutura de pastas do álbum apropriada.

Forneça listas de reprodução baseadas em arquivos para o usuário

Gonic lê playlists de seus configurados playlists-path e uma subpasta com o nome do ID numérico do usuário. Coloque os arquivos M3U/M3U8 com caminhos de mídia resolvidos para Gonic lá. Uma verificação normal de música não importa automaticamente listas de reprodução de outras pastas da biblioteca. Nossa configuração cria visualizações derivadas sem alterar os originais compartilhados. Atualize essas visualizações após alterar as fontes.

Documentação do projeto Gonic

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

Adicione os seguintes mapeamentos para BPM e chave. Os arquivos de música devem conter as tags BPM e KEY ou INITIALKEY correspondentes. Mantenha os mapeamentos existentes, como PERFORMER.

Linhas adicionais: Tag Name e 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	chave	upnp:key
ffmpeg	chave inicial	upnp:initialKey

Para uma instalação baseada em XML, adicione as entradas em importação → opções de biblioteca → id3 → metadados e ffmpeg → metadados. Gerbera rotula o grupo XML id3 como taglib Library Options em sua interface da web. Defina charset como UTF-8 em ambas as bibliotecas; mantenha ou defina filesystem-charset, metadata-charset e playlist-charset como UTF-8 também. Salve e reinicie Gerbera. Mapeamentos de tags adicionais entram em vigor quando os arquivos são importados novamente; uma nova verificação normal pode ignorar arquivos inalterados. Para uma nova instalação, configure estas opções antes de importar músicas.

MP4, M4A e M4V: prefira tags BPM mais precisas

Disponível na versão Git 3.3.0-77: A extensão BPM Gerbera-PR#3993 foi mesclado e está incluído na imagem oficial. Maior precisão é opcional e deve ser habilitada com prefer_highest_bpm_accuracy="yes" estar ligado. Sem este atributo permanece no o padrão.

O atributo MP4 tmpo contém um número inteiro. Além disso, uma tag adicional do iTunes BPM pode conter um valor mais preciso. No elemento XML existente import → library-options → id3 sua preferência pode ser ativada; mantenha os mapeamentos de tags existentes:

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

Se estiver faltando prefer_highest_bpm_accuracy ou se estiver definido para no, o comportamento anterior é mantido. Para yes Leituras Gerbera tmpo e a tag BPM adicional separadamente. Se a distância for menor que 1 BPM, o valor do tag é adotado, por exemplo 123,5 em vez disso 123. Se os valores diferirem em pelo menos 1 BPM, a seleção será determinada por prefer_ambigous_bpm_value: tmpo prefere o número inteiro, bpm_tag a etiqueta adicional. Se o segundo atributo estiver ausente, bpm_tag. A notação de atributo é explícita prefer_ambigous_bpm_value.

Apenas números positivos finitos são válidos para esta seleção; use um ponto decimal na tag do arquivo. Se apenas uma fonte for válida, ela será usada. Os valores de intervalo ou de tempo duplo não são corrigidos automaticamente. Outras tags, gêneros, chave e capas são lidas como antes. Reinicie o Gerbera após alterar a configuração e reimporte os arquivos afetados; uma nova verificação normal pode ignorar arquivos inalterados.

AIFF: BPM, chave e leitura de vários gêneros

Se os arquivos AIFF estiverem faltando BPM ou chave apesar das tags ID3 existentes, em Gerberas Configuração → Especialista → Importar → Mapeamentos → Mimetype-Contenttype o mapeamento do tipo MIME reconhecido para o tipo de conteúdo aiff suplemento. Para audio/x-aiff e audio/aiff cada aiff entre. Isso permite que Gerbera use o leitor TagLib correspondente; os mapeamentos BPM/chave da tabela acima ainda são necessários.

Na configuração XML, as seguintes linhas na seção existente import → mappings → mimetype-contenttype com as seguintes adições, mantendo os mapeamentos existentes:

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

Reinicie o Gerbera ou seu contêiner e importe os arquivos afetados novamente. Uma nova verificação normal pode ignorar arquivos inalterados; nenhuma mudança de nome ou carimbo de data/hora é necessária.

OGV: Adote tags das trilhas de áudio e vídeo

Com OGV, o título, artista, álbum, gênero, BPM e chave podem estar nas faixas individuais de áudio e vídeo. Ativar em Gerberas Configuração → Especialista → Library Options → ffmpeg Library Options a opção streams-enabled. Isso está disponível na configuração XML import → library-options → ffmpegelemento, o atributo streams-enabled="yes" colocar; Preservar atributos e atribuições de tags existentes.

Reinicie o Gerbera ou seu contêiner e importe novamente os arquivos OGV existentes. Os mapeamentos BPM/chave na tabela acima ainda são necessários. Sem a análise de metadados de fluxo habilitada, esses valores podem estar ausentes apesar das tags de arquivo salvas corretamente.

WebM e WMV: adote vários gêneros com o leitor certo

Desde a compilação do Git 3.3.0-62 e também na atual 3.3.0-77 pode ler várias tags de gênero de WebM e WMV. As atualizações mantêm a configuração existente, portanto, os mapeamentos de leitor adicionados na nova compilação ainda podem estar ausentes. Em Configuração → Especialista → Importar → Mapeamentos → Mimetype-Contenttype Adicione os seguintes mapeamentos ou na seção XML existente import → mappings → mimetype-contenttype digite:

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

Mantenha os mapeamentos existentes e as configurações de BPM/chave, reinicie Gerbera e reimporte os arquivos afetados. Isso altera qual leitor de metadados é usado, e não o tipo MIME de vídeo retornado. Os arquivos não precisam de conversão ou renomeação. A base é a Mapeamentos padrão desta versão de origem Gerbera.

Detecte automaticamente alterações em arquivos e atributos

O Inotify detecta eventos do sistema de arquivos. inotify-attrib="yes" monitora adicionalmente alterações de atributos, incluindo carimbos de data/hora alterados por toque. Para uma instalação Linux, estenda a seção de autoscan existente em /etc/gerbera/config.xml preservando o caminho da música:

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

Em seguida, use o serviço Linux systemctl restart gerbera reiniciar.

Inotify no contêiner oficial Gerbera

A imagem oficial já habilita o Inotify para a pasta de música montada, mas o monitoramento de atributos adicionais está inicialmente desabilitado. Use Inotify e monitore as alterações de atributos do Inotify aparecem em Gerbera Config → Expert → Import, mas não podem ser editadas por meio dessa visualização na imagem verificada. As configurações são armazenadas em /var/run/gerbera/autoscan.xml.

No QNAP, abra gerbera-qnap no Container Station e inicie seu terminal ou console. Em Synology, selecione gerbera-synology no Container Manager, abra seu terminal e inicie /bin/sh. Execute o seguinte comando dentro do contêiner.
Insira o seguinte bloco. Completa o atributo e mostra o arquivo de varredura; O caminho da música e as configurações existentes são mantidos.

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

A saída deve mostrar varredura automática com inotify-attrib="yes". Reinicie o contêiner e verifique se Monitor Inotify Attribute Changes está selecionado em Gerbera Config. Se autoscan.xml estiver faltando, primeiro identifique o arquivo de configuração realmente em uso. Este comando se aplica à compilação oficial especificada nos guias NAS.

Tags de gênero separadas não precisam de configurações adicionais. MusicServer Connect usa todos os campos de gênero fornecidos pelo UPnP. Desde a versão 1.5, os gêneros combinados separados por ponto e vírgula ou barras também são atribuídos às suas visualizações de gênero individuais. As tags de servidor e arquivo permanecem inalteradas.

Fontes: Verificação automática Gerbera e monitoramento de atributos, Configuração inicial da imagem oficial do contêiner.

Gerbera 3.3.0-77: nomes de títulos puros nos resultados da pesquisa

Gerbera combina M_ARTIST e M_TITLE para títulos de faixas em respostas de pesquisa UPnP por padrão. MusicServer Connect importa através dessa interface, então “Speedy J - Electric Deluxe” aparece na coluna do título mesmo que a tag do arquivo TITLE contenha apenas “Electric Deluxe”.

Em servidor → upnp, configure o resultado do item de pesquisa para usar apenas M_TITLE. extend="no" substitui a lista padrão em vez de anexar entradas:

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

O Script de configuração gerbera-suchtitel.py define esta opção em uma configuração XML existente. O caminho padrão é /etc/gerbera/config.xml; outro caminho pode ser fornecido como argumento. Namespaces, comentários e outras configurações existentes são preservados. Se a estrutura do servidor for ambígua, o script será interrompido antes da gravação.

Alternativamente, na interface web do Gerbera em Configuração → Servidor → UPnP → Resultado do item de pesquisa a entrada M_ARTIST remova e apenas M_TITLE para retê-lo. Verifique as configurações já salvas na interface web, pois elas podem substituir os valores XML. Esta configuração também se aplica a Gerbera 3.3. O artista permanece disponível como um campo de metadados separado.

Reinicie Gerbera e recarregue a conexão do plugin. Esta configuração altera os títulos das faixas nos resultados da pesquisa; nenhuma alteração de plugin ou arquivo de música é necessária. Verifique também a exibição das faixas já armazenadas em VirtualDJ. A detecção de artista FRITZ!Box opcional é independente desta configuração.

Gerbera: visualizações e importação da lista de reprodução

Por que a mesma playlist aparece várias vezes

Gerbera pode mostrar a mesma lista de reprodução em Listas de reprodução → Todas as listas de reprodução e Listas de reprodução → Diretórios. Isso não significa que o arquivo da lista de reprodução exista mais de uma vez.

MusicServer Connect combina visualizações de listas de reprodução idênticas. Se o seu conteúdo for diferente ou uma consulta estiver incompleta, múltiplas visualizações poderão permanecer visíveis.

Verifique importações incompletas de playlists

Verifique as entradas da lista de reprodução. Os caminhos relativos referem-se às suas pastas.
Verifique se todos os arquivos de música referenciados existem e podem ser lidos pela conta de serviço do Gerbera.
Leia a lista de reprodução novamente após as alterações. Se a importação estiver incompleta, reinicie o serviço Gerbera e aguarde a verificação.
Em seguida, atualize a visualização no plugin e verifique a playlist.

Para detectar alterações nos carimbos de data/hora do arquivo automaticamente, use Monitoramento de atributos Inotify ativar.

Referências de lista de reprodução obsoletas e conjunto de caracteres M3U

Verifique novamente o conteúdo das listas após alterações nos ficheiros multimédia referenciados. Uma nova análise normal pode deixar as vistas existentes inalteradas. Depois, atualize a biblioteca no MusicServer Connect. Os identificadores do catálogo podem mudar.

Para compartilhar os mesmos arquivos da lista de reprodução com MinimServer, salvamos M3U com Windows-1252 e M3U8 com UTF-8. O importador padrão do Gerbera na versão testada 3.3.0-77 não resolveu corretamente o caminho do trema do Windows-1252-M3U. O Baixe a extensão de importação M3U verificada e salve-o no diretório de script personalizado configurado. Ele detecta UTF-8 válido em linhas M3U e, caso contrário, usa Windows-1252. As listas de reprodução M3U8, PLS e XML continuam a usar o importador padrão. Preservar scripts personalizados existentes.

Na configuração Gerbera existente em import/scripting/import-function o nome da função da lista de reprodução de importPlaylist ligado mscImportPlaylist para mudar. Sob import/scripting/script-folder/custom O diretório configurado deve conter o arquivo baixado e ser armazenado permanentemente para instalações de contêiner. Na bancada de testes é inferior /var/run/gerbera/custom-js. Em seguida, reinicie o Gerbera e importe os registros da playlist novamente. A extensão requer o importador JavaScript.

MiniDLNA / ReadyMedia 1.3.3: Extensões de arquivo de lista de reprodução

MiniDLNA 1.3.3 reconhece playlists com .m3u e .pls. Arquivos com .m3u8 não são lidos.

Recomendação: renomeie M3U se possível

Se nenhuma outra configuração de aplicativo ou servidor depender do nome do arquivo M3U8 atual, altere a extensão de .m3u8 para .m3u. Esta é a solução mais simples para MiniDLNA. Mantenha o conteúdo, a codificação UTF-8 e a localização inalterados para que os caminhos relativos da música continuem funcionando. Atualize todas as referências ao nome do arquivo da lista de reprodução. Em seguida, faça com que MiniDLNA importe a lista de reprodução novamente e atualize o plugin.

Alternativa: preservar uma fonte M3U8 compartilhada

Se outros servidores precisarem do arquivo M3U8, crie um arquivo M3U adicional para MiniDLNA. Se estiver em uma pasta diferente, ajuste os caminhos relativos da música ou use caminhos absolutos.

O Script de configuração minidlna-playlist-view.py verifica a origem e o destino, cria o M3U derivado e adiciona media_dir=A,/media3 à configuração existente do MiniDLNA. Isso não altera a origem M3U8 ou as entradas media_dir existentes. Num conflito de destino, ele para. Recarregue MiniDLNA e atualize o plugin. Após alterar a lista de reprodução de origem, execute o script e reinicie MiniDLNA novamente para manter a visualização derivada atualizada. Nenhum observador de alterações está instalado.

Permissões de cache ao reconstruir

Se MiniDLNA não puder limpar seu cache de cobertura durante a reconstrução, verifique as permissões de gravação no cache e em seus subdiretórios.

Para outras instalações, primeiro identifique a conta de serviço real e o caminho do cache configurado. Após reconstruir a biblioteca, atualize o plugin. Se necessário, registre novamente a lista completa de faixas usando “Pesquisa de banco de dados → Adicionar ao banco de dados”.

Compartilhe áudio e vídeo

Uma partilha com media_dir=A,/srv/music está limitado ao áudio. Para ambos os tipos de mídia, abra esta linha existente media_dir=AV,/srv/music alterar, obter mais aprovações e reiniciar o serviço. Os limites de codec e metadados permanecem independentes disso.

Serviio 2.5: liberar visualizações necessárias

Para ter os artistas dos álbuns e a ordem original dos álbuns disponíveis, exiba as categorias necessárias no console Serviio.

Ordem das faixas

Para a ordem original das faixas, abra um único álbum. Uma classificação de coluna selecionada em VirtualDJ pode alterar a ordem visível.

No console Serviio em Apresentação → Áudio, defina Música, Álbuns, Títulos e Listas de Reprodução para “Categoria de exibição”. Outras categorias de áudio podem usar “Exibir apenas conteúdo”. A visualização do álbum deve estar disponível para a consulta complementar. Nenhuma alteração no arquivo de música é necessária.

Diferentes artistas de álbuns salvos

Se os metadados do álbum ou artista de Serviio forem diferentes das tags do arquivo, releia os metadados no servidor e atualize o plug-in.

Se houver múltiplas tags de gênero, somente a primeira será adotada.

Se um arquivo tiver diversas tags de gênero, somente a primeira será usada. Os gêneros restantes estão faltando nos metadados retornados e na árvore de gêneros. Esta limitação de compatibilidade não é específica de um formato de arquivo.

Servidor Twonky 8.5.2: recuperação completa de faixas e álbuns

Quando detecta a estrutura Twonky, MusicServer Connect usa a trilha nativa completa e as visualizações do álbum. Em nossas verificações, a pesquisa global do servidor omitiu sete faixas acessíveis em W e Y. O substituto automático também recupera essas faixas e preserva a ordem dos álbuns. Nenhuma configuração adicional de plug-in é necessária. Páginas nativas incompletas ou inconsistentes ainda são rejeitadas.

A verificação de acompanhamento abrangeu arquivos de mídia 149 (áudio 139, dez vídeos) e todas as visualizações oferecidas sem erros de recuperação. A falta de suporte, formatos e metadados de ASX/XSPF permanecem como limitações do servidor. Twonky pode exigir um novo login de fornecedor após reiniciar; um aviso de login não é um catálogo de músicas.

Universal Media Server 15.8.2: serviço Linux e exibição de álbum

Para um serviço Linux, configure o ambiente como UTF-8 para que caminhos de música contendo tremas e outros caracteres Unicode possam ser processados.

Com systemctl edit DIENSTNAME.service Configure a adição a seguir para seu próprio serviço UMS. Depois disso systemctl daemon-reload Execute, reinicie este serviço e aguarde a verificação da biblioteca.

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

O código de idioma C.UTF-8 deve estar disponível no sistema. A configuração de Java file.encoding por si só não substitui o código de idioma usado para nomes de arquivos. Um comando Java iniciado a partir de um shell interativo pode usar configurações diferentes do serviço em execução.

O acesso direto à pasta de músicas no Linux evita restrições de compartilhamento do Windows em nomes de arquivos, como nomes que contêm um ponto de interrogação.

Artistas de álbuns e pesquisa de banco de dados

Para obter informações completas sobre o artista do álbum no UMS.conf, ative a pesquisa de banco de dados integrada e reinicie o UMS:

search_lucene_use_engine = false

A configuração substitui a procura de texto completo do Lucene pela procura de banco de dados integrada.

Ordem do álbum original

Para a ordem original das faixas, abra um único álbum. Uma classificação de coluna selecionada em VirtualDJ pode alterar a ordem visível.

UMS combina múltiplas tags de gênero em um texto separado por “/”. MusicServer Connect cria nós de gênero individuais a partir dele; a faixa aparece em todos os gêneros listados. Lidando com vários gêneros.

Arquivos ASX e pesquisa de catálogo incompleta

O UMS 15.8.2 pode contar os arquivos da lista de reprodução ASX como pastas de vídeo sem retornar os objetos correspondentes. A pesquisa de áudio também pode anunciar mais correspondências do que retorna e pode omitir OGG das pesquisas de classe de áudio. MusicServer Connect detecta essas inconsistências e complementa o catálogo usando pastas de arquivos reais. A coleção verificada de áudio 141 e dez arquivos de vídeo aparece na íntegra, com IDs de áudio e metadados existentes retidos. Nenhuma configuração adicional é necessária.

O plugin descobre subpastas reais independentemente da pesquisa SQL incompleta. As páginas de pesquisa verificadas anteriormente são usadas apenas para mapear aliases. Ele compara dois inventários completos de arquivos antes de aceitá-los e verifica novamente se há alterações no estado de pesquisa. Ele não atravessa combinações de filtros virtuais. Se uma versão futura do UMS fornecer resultados de pesquisa completos com classes de mídia corretas, o plug-in usará automaticamente essa pesquisa direta novamente. Os arquivos de origem da biblioteca permanecem inalterados.

Este substituto não repara metadados de servidor ou entradas de lista de reprodução ausentes: ASX, WPL e XSPF ainda estão ausentes como visualizações de lista de reprodução. A UMS omitiu a primeira faixa das listas M3U/PLS mais antigas verificadas aqui. As três listas de formato misto, entretanto, contêm todas as seis posições, incluindo entradas repetidas de áudio e vídeo.

Conversão e streaming de áudio WAV

O UMS pode transcodificar o áudio para 16-bit WAV dependendo do perfil do cliente. Quatro amostras continham áudio completo na verificação de acompanhamento, embora os comprimentos WAV ilimitados tenham falhado na validação rigorosa do arquivo. A decodificação normal e a comparação após a normalização para o bit 16 foram bem-sucedidas. Isso não prova a preservação de uma resolução original de bits 24. Solicitações de intervalo muito pequeno podem retornar vazias durante a conversão; downloads normais e solicitações 64 KiB funcionaram.

Oculte a pasta extra de transcodificação

show_transcode_folder = false oculta a pasta virtual para configurações alternativas de transcodificação. A própria transcodificação e as tags de mídia salvas são retidas. Esta opção de exibição por si só não corrige contagens de páginas UPnP inconsistentes.

MinimServer: BPM/chave e atualização de biblioteca

Leia BPM e chave de arquivos de música

Para fornecer tags adicionais, você precisa de uma licença MinimServer completa ou de teste. Os arquivos de música devem conter as tags BPM e KEY ou INITIALKEY.

Na página de configuração MinimServer, abra Propriedades.
Em itemTags os nomes BPM,KEY,INITIALKEY suplemento. Manter as entradas existentes; as tags devem corresponder aos seus próprios arquivos de música. KEY e INITIALKEY considere: O campo MP3 TKEY é tratado por MinimServer como INITIALKEY é lido.
Salve as alterações e execute a reinicialização do servidor solicitada.
Execute uma nova verificação em Status. Em seguida, atualize a biblioteca em MusicServer Connect.

Mais informações: MinimServer: metadados adicionais e Escopo da licença. O Advanced Mode de WiiM é um recurso do aplicativo WiiM; o requisito de licença completa aqui diz respeito aos metadados adicionais do servidor.

Os valores já armazenados em VirtualDJ podem permanecer após uma alteração. Para reler BPM/key tags incorporados, selecione as faixas afetadas e escolha “Ler BPM e chave do arquivo de música” no menu de contexto. Para novas análises de áudio, use “Analyse BPM and tags”; com múltiplas faixas selecionadas, esta ação está em “Lote”.

Releia após as alterações

Verifique novamente o MinimServer após alterar arquivos de música, tags ou tempos de modificação. Abra sua página de configuração, escolha a guia Status e clique em Rescan. Atualize o status até que ele informe “Em execução” e, em seguida, atualize MusicServer Connect. Reiniciar o MinimServer sozinho geralmente não aciona uma nova verificação.

Um índice de servidor desatualizado pode retornar espaços reservados para “Item modificado ou excluído” sem metadados de trilha ou arquivos de áudio. Esses espaços reservados ainda podem ser incluídos no total relatado. O plug-in mostra menos faixas utilizáveis, embora os artistas e álbuns permaneçam conhecidos nos contêineres de servidor existentes.

Veja Página de configuração MinimServer e nova verificação bem como API web oficial para novas verificações automatizadas.

Combine um álbum de várias pastas

Se as faixas do mesmo álbum estiverem em várias pastas, o MinimServer poderá entregar vários álbuns com o mesmo nome. A configuração em Propriedades mergeFolderAlbums ligado true para o valor indicado, salve e reinicie MinimServer. O nome do álbum e o artista do álbum devem corresponder. Esta configuração se aplica a toda a biblioteca e também pode combinar outros álbuns correspondentes de várias pastas. Os arquivos de mídia permanecem inalterados.

Em nossa verificação, isso combinou “MSC Format Tests 1.3” das subpastas de Áudio e Vídeo em um álbum com faixas 13 reconhecidas por MinimServer. Anteriormente, os dois grupos continham onze e duas faixas. Em seguida, abra o servidor em WiiM Home e … → Verificar novamente o servidor de música para atualizar o próprio índice do aplicativo. O rótulo pode variar dependendo do idioma do aplicativo. Posteriormente, WiiM Home exibiu apenas uma cópia do álbum de exemplo em nossa verificação.

Veja MinimServer: álbuns e pastas e WiiM Home: Leia a biblioteca de mídia novamente.

M3U/M3U8: conjunto de caracteres e entradas ausentes

MinimServer espera .m3u com Windows-1252 ou ISO-8859-1 e .m3u8 com codificação UTF-8. Um arquivo UTF-8 com a extensão .m3u pode, portanto, omitir faixas cujos caminhos contenham caracteres acentuados. Use M3U8 para caminhos Unicode. Se M3U também for necessário, salve uma cópia separada na codificação apropriada. Não substitua caracteres que esta codificação não possa representar.

Na coleção verificada, uma nova digitalização reparou a referência obsoleta de “Betty Ford” anteriormente retornada como “Item modificado ou excluído” sem áudio utilizável. A codificação Windows-1252 correta do Sven Väth M3U adicional também restaurou a referência de caminho acentuado para “W.I.R.” Ambas as listas forneceram todas as quatro faixas na ordem de origem, sem uma reconstrução completa do catálogo. Listas de formato misto forneciam cinco das seis posições, incluindo repetições; MKV permaneceu excluído porque o formato não é compatível.

Após a nova verificação, atualize a biblioteca no plugin. Fonte: MinimServer: formatos de lista de reprodução e conjuntos de caracteres.

JRiver: importe playlists e permita acesso de leitura

Importe playlists para a biblioteca JRiver. Se a importação automática de música pular uma lista de reprodução, importe-a separadamente e atualize a visualização do plug-in.

A gravação por meio da interface de serviço da web do JRiver requer que a autenticação seja habilitada. O acesso de leitura anônimo deve permanecer permitido: MusicServer Connect o utiliza para distinguir listas de reprodução regulares e inteligentes. O acesso de leitura não concede permissão de edição de playlist.

Você pode mostrar ou ocultar playlists inteligentes no plugin. O conteúdo oculto da lista de reprodução inteligente não é solicitado durante a construção da árvore; eles são carregados quando você os mostra. Listas vazias e listas sem faixas de áudio não aparecem como listas de reprodução de música.

Synology: Configurar servidor de mídia padrão

O servidor padrão do Synology suporta WiiM Home Advanced Mode. Também é suficiente para MusicServer Connect se VirtualDJ calcular BPM e se chavear. Para valores BPM/chave armazenados, você pode usar Gerbera no contêiner . Ambos os servidores podem ler os mesmos arquivos de música.

Instale o Media Server no Package Center e copie sua biblioteca de músicas para a pasta de músicas compartilhada. Um conjunto de armazenamento e um volume já devem existir.

Configurações gerais: idioma do menu DMA conforme desejado, estilo do menu DMA Estilo simples; Deixe o intervalo de relatório do SSDP com o valor padrão.
Configurações de pesquisa: defina o formato de exibição de música como “Somente título”; permitir arquivos de capa extras com “Imagem de capa para arquivos de áudio/vídeo” e manter os nomes de arquivo padrão.
Compatibilidade DMA: deixe a transcodificação de áudio e os tipos MIME personalizados desativados. Permita o acesso aos dispositivos desejados.
Após a cópia, ejete a memória USB com segurança. Os álbuns, faixas individuais e pastas de playlists estão localizados diretamente abaixo da música.

O servidor de mídia Synology combina múltiplas tags de gênero em um valor separado por “;”. MusicServer Connect cria nós de gênero individuais, para que cada faixa apareça em cada gênero listado. Lidando com vários gêneros.

Salve playlists com a extensão .m3u. No File Station, renomeie um arquivo .m3u8 em music/Playlists para .m3u, mantendo o conteúdo UTF-8 e os caminhos relativos. Se outros servidores precisarem de M3U8, crie uma cópia M3U separada.

FRITZ!Box: formatos de áudio e artistas de faixas

Configure o servidor de mídia

Conecte o armazenamento USB que contém a biblioteca de música. Na interface FRITZ!Box, habilite o Media Server em Home Network → Media Server, selecione o armazenamento USB como fonte de mídia e aplique. Crie ou atualize seu índice de arquivo em Rede Doméstica → USB/Armazenamento ou Armazenamento (NAS) e aguarde a indexação. Em seguida, selecione o servidor de mídia FRITZ!Box em MusicServer Connect.

Formatos de áudio e metadados

FRITZ!Box pode transmitir muitos formatos de áudio, mas lê apenas algumas de suas tags. Sem suporte de tags, o artista, o álbum e o gênero do álbum estão ausentes da árvore da biblioteca. Com a detecção de artista de faixa habilitada, MusicServer Connect pode derivar um artista de nomes no padrão “Artista - Nome da faixa”. Os arquivos permanecem acessíveis em Todas as faixas, pastas e listas de reprodução suportadas.

Avaliação de tags de acordo com tabela de formato FRITZ!Box
Formatos de áudio	Leitura de tags
MP3, WMA, ASF	Sim; nenhuma garantia de todos os campos de metadados individuais.
FLAC	Não
AAC, M4A	Não
WAV, AIF/AIFF, LPCM	Não
Ogg Vorbis, APE, WavPack, MPC	Não
3GP, AC3, MKA, MPA, MP1, MP2, Áudio Real, Karaokê CDG/BIN	Não

Para MP3/WMA, a documentação do fornecedor lista título, artista, álbum, gênero e número da faixa e ID3 v2.3 ou anterior. Artista do álbum, BPM e chave não são, portanto, confirmados como campos suportados. VirtualDJ ou o player deve suportar o formato de áudio para reprodução.

Recomendação: use artistas de trilha

Para bibliotecas com FLAC ou outros formatos sem avaliação de tags, mesmo quando misturadas com MP3, a visualização Artista da faixa se os nomes dos arquivos seguirem o padrão “Artista - Nome do Título” corresponder. Para fazer isso primeiro no menu de contexto da fonte MusicServer Connect “Determinar o artista do título a partir dos nomes dos arquivos” ligue. Em seguida, selecione “Mostrar artistas” e “Mudar para artistas de títulos” se esta visualização ainda não estiver ativa.

Esta detecção é desabilitada por padrão para novas conexões de servidor e é salva por conexão. Para desligá-lo, escolha “Desativar detecção de artista de faixa em nomes de arquivo” no mesmo menu. Deixe-o desativado se os nomes dos seus arquivos não seguirem “Artista - Nome da faixa”: o plugin não pode determinar se o texto antes de um hífen é um artista ou parte do título.

Quando a detecção está habilitada, o artista está faltando e o nome corresponde ao padrão, MusicServer Connect se divide no primeiro “ - ”. Por exemplo, “1st Bass - Slam Me Down” torna-se o artista “1st Bass” e o título “Slam Me Down”. Outros hífens permanecem no título; os metadados existentes do artista têm prioridade. Quando desabilitada, esta divisão não é realizada e o título fornecido pelo servidor permanece inalterado para esta finalidade. A detecção de remix é uma configuração separada.

Ao alternar, MusicServer Connect também atualiza as exibições de títulos salvos se o título e o artista ainda corresponderem a uma das duas variantes geradas pelo plug-in. Outras edições manuais são preservadas. Esta opção não altera os valores de BPM, chave, remix ou análise.

Esta detecção preenche o campo do artista e a visualização do artista da faixa. Ele não substitui tags de álbum, artista de álbum ou gênero. Se sua biblioteca contiver apenas MP3, WMA ou ASF, as tags fornecidas pelo servidor poderão ser usadas e a visualização track-artist não será necessária como substituto. A visualização do artista do álbum só será útil se o servidor realmente fornecer as informações necessárias.

Para formatos cujas tags não são lidas, FRITZ!Box também não pode fornecer valores BPM/chave armazenados. VirtualDJ pode calculá-los sozinho. Para uma navegação completa na biblioteca baseada em tags, use um servidor de música que suporte metadados para seus formatos.

Listas de reprodução

Utilize M3U ou PLS. WPL é reconhecido, mas pode omitir faixas, então escolha M3U ou PLS para obter listas completas confiáveis. M3U8, ASX e XSPF não são reconhecidos como listas de reprodução. Mantenha o conteúdo UTF-8 e caminhos musicais relativos válidos. MusicServer Connect remove a extensão do arquivo e o nome da pasta anexado do nome da lista de reprodução exibida.

Documentação do fabricante: Formatos de áudio, leitura de tags e formatos de playlist, Classificando e marcando versões bem como Configure o servidor de mídia e crie o índice de arquivos.

QNAP: Execute o servidor de mídia padrão e Gerbera em paralelo

O complemento de streaming de mídia padrão do QNAP suporta WiiM Home Advanced Mode. Também é suficiente para MusicServer Connect se VirtualDJ calcular BPM e a chave e a ordem incorreta da lista de reprodução forem aceitáveis. Para valores BPM/chave armazenados, gêneros separados e ordem correta da lista de reprodução, você pode usar Gerbera com estação de contêineres ser complementado.

Instale o console multimídia e o complemento de streaming de mídia no App Center. Coloque as pastas de música em Público/música. Em Console multimídia → Gerenciamento de conteúdo, selecione Complemento de streaming de mídia e adicione Público/música como fonte de conteúdo.

Indexação: Habilite Informações Multimídia; Prioridade normal. Para a biblioteca UTF-8, selecione UTF-8 se oferecido, caso contrário, deixe o padrão.
Abra as configurações do complemento Media Streaming separadamente. Selecione sua própria conta de usuário NAS e a interface de rede apropriada; use a porta padrão 8200.
Em DLNA Media Renderer, permita o acesso do PC ou cliente desejado.
Em Configurações de navegação, defina Estilo de menu padrão para Todas as categorias. Em DLNA Media Renderer, selecione também Todas as categorias e seu próprio perfil de usuário para o cliente. Aplique ambas as alterações.
Pare e inicie o complemento de streaming de mídia no App Center. Em seguida, verifique novamente a liberação do dispositivo e configure-o novamente, se necessário.
As listas de reprodução estão disponíveis como M3U, PLS ou WPL; M3U8 não é compatível. Use UTF-8 e caminhos relativos válidos. A ordem das faixas permanece incorreta em todos os três formatos.

Nomes de arquivos contendo um ponto de interrogação podem causar problemas quando copiados por meio de Windows/SMB. Copie os arquivos afetados diretamente do armazenamento USB para a pasta de música apropriada usando QNAP File Station.

Para ordenar os álbuns, mantenha as músicas de cada álbum em uma pasta. Para discos múltiplos, use subpastas como CD 1 e CD 2, com números de faixa positivos e exclusivos. QNAP usa apenas o primeiro gênero. A ordem da lista de reprodução permanece incorreta com M3U, PLS e WPL; alternar entre eles não resolve isso.

Adicionar Gerbera para MusicServer Connect

Continue a usar a biblioteca existente em Público/música e Gerbera após o seguindo instruções passo a passo . Em seguida, conecte-se ao URL do dispositivo Gerbera no plugin e verifique as faixas, tags e ordem. Mantenha o complemento de streaming de mídia em execução para WiiM Home Advanced Mode ou outros dispositivos, selecionando o servidor padrão do QNAP lá. Use Gerbera em MusicServer Connect para BPM/key e corrija a ordem da lista de reprodução. Se o WiiM Home também precisar de listas de reprodução confiáveis do mesmo servidor, o MinimServer é uma solução compartilhada adequada. Ambos os serviços leem os mesmos arquivos de música.

Notas do fornecedor: Formato M3U, UTF-8 e caminhos relativos bem como Compartilhamento manual de dispositivos no complemento de streaming de mídia.

QNAP: Configure Gerbera com correção WavPack passo a passo

Gerbera é um software de servidor de mídia adicional para seu QNAP. Seu principal benefício para MusicServer Connect é o acesso aos valores já armazenados em seus arquivos de música: BPM e metadados de tonalidade musical: O servidor de mídia UPnP integrado do QNAP não fornece essas informações. As etapas a seguir configuram os mapeamentos de metadados necessários.

O suporte à playlist também pode falar por Gerbera: O servidor UPnP padrão QNAP descrito aqui não exibe listas de reprodução M3U8. Para os formatos M3U, PLS, ASX e WPL reconhecidos, ele não preserva a ordem das trilhas. Renomear M3U8 para M3U, portanto, não corrige o pedido. Gerbera é uma alternativa se você precisar de M3U8 ou da ordem exata de reprodução.

Quando você não precisa de Gerbera? Se seus arquivos não tiverem valores BPM/chave armazenados e a ordem da lista de reprodução não for importante, você não precisará de Gerbera para esses fins. VirtualDJ pode calcular BPM e tom musical analisando arquivos sem um servidor de música. Você pode manter o servidor de mídia integrado do QNAP e deixar o VirtualDJ calculá-los.

O próprio servidor de mídia do QNAP pode continuar funcionando junto com o Gerbera, por exemplo, para WiiM Home Advanced Mode. Gerbera não suporta este modo WiiM. Sua música permanece na pasta existente; Gerbera obtém acesso somente leitura. Este guia também permite a detecção automática de arquivos novos e alterados.

Versão recomendada: Este guia usa a versão oficial do Git Gerbera 3.3.0-77 da revisão de origem 245e723. A imagem Docker é definida com tag e soma de verificação SHA-256; contém as correções já solicitadas WavPack e títulos de playlist repetidos bem como vários gêneros em WebM/WMV e maior precisão BPM. No caso de uma atualização com uma configuração existente, isso também Adicionar mapeamentos de leitor. É um status de desenvolvimento de acordo com 3.3.0, não uma nova versão estável.

Gerbera 3.3.0 está incorreto durante a importação de WavPack: A imagem 3.3.0 inalterada pode ser lida ao ler de .wvarquivos. Na compilação usada aqui, a memória afetada é alocada no heap. WavPack permanece totalmente utilizável; nenhum script de patch adicional é necessário. Use a referência completa da imagem mostrada acima.

1. Preparar pastas, usuários e arquivos

Faça login no QTS com uma conta de administrador ativa cuja senha você conhece. A conta integrada admin não precisa estar ativado para isso; outra conta de administrador autorizada é suficiente.
Instalar em Central de aplicativos o aplicativo Estação de contêineres. Abra-o e conclua a configuração inicial. O console multimídia e o complemento de streaming de mídia não são necessários para Gerbera.
Criar em Painel de controle → Permissão → Usuários → Criar o usuário gerbera . Este usuário não precisa de direitos de administrador. Conceda acesso de leitura ao compartilhamento de música, incluindo suas pastas e arquivos. Continue usando sua conta de administrador para SSH.
Os exemplos usam a pasta de música Public/music, no NAS /share/Public/music. Para outro compartilhamento, use seu caminho real. Sua música existente pode ficar lá. Remova caracteres ilegais Windows como ? dos nomes dos arquivos e ajuste as referências da lista de reprodução, se necessário; as tags de título ainda podem conter esses caracteres.
Criar em Estação de arquivos sob Public a pasta gerbera-qnap e sua subpasta vazia empty .
Baixe o Componha o arquivo como compose.yaml . Carregue-o diretamente através do File Station para Public/gerbera-qnap ao lado da pasta empty. O nome do arquivo deve compose.yaml sem adicional .txt.

2. Habilite SSH e obtenha acesso root

Abrir no QTS Painel de controle → Serviços de rede e arquivos → Telnet/SSH.
Habilitar Permitir conexão SSH, saia do porto às 22 e clique em Aplicar. Se Editar permissões de acesso é oferecido, permita o acesso da sua conta de administrador lá. Se o firewall NAS estiver ativo, a porta SSH do seu computador deverá ser permitida na rede local.
Abra o Terminal no Windows-PC ou o PowerShell no Terminal Mac. Substitua no seguinte comando DEIN_QTS_KONTO através da sua conta de administrador e NAS_IP com o endereço IP QNAP.

ssh DEIN_QTS_KONTO@NAS_IP

Ao estabelecer a conexão pela primeira vez, verifique o endereço de destino exibido e confirme a consulta com yes. Digite a senha da sua conta QTS. Nenhum caractere ou asterisco aparece durante a digitação. Use se uma porta SSH diferente for usada ssh -p PORTNUMMER DEIN_QTS_KONTO@NAS_IP.

Em seguida, mude para direitos de root:

sudo -i
id

Se você solicitar sua senha novamente, use a mesma senha da sua conta QTS registrada. Não é necessária uma senha root especial. A saída de id deve uid=0 incluído; em QNAP o nome de usuário associado pode ser encontrado admin . Se um menu de gerenciamento aparecer, saia dele usando a opção Shell ou Sair. Deixe o terminal aberto durante a configuração: todos os comandos de terminal a seguir são executados no QNAP.

Determine os IDs do usuário criado para acesso à música:

id gerbera

Se a saída mostrar uid=1001(gerbera) gid=100(everyone) é UID 1001 e GID 100. Anote seus próprios números para o arquivo de composição.

3. Personalizar arquivo de composição

Abra o baixado compose.yaml usando um editor de texto, substitua os valores de exemplo por UID e GID através dos números da etapa 2 e recarregue o arquivo salvo Public/gerbera-qnap alto. O mapeamento da música aponta inicialmente para a pasta vazia. A música existente só é importada após a configuração dos metadados.

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:

A imagem oficial seleciona a variante ARM64 ou AMD64 apropriada para os modelos NAS suportados. O modelo não contém um endereço IP NAS fixo. --interface eth0 usa o endereço desta interface de rede. Para dispositivos com múltiplas portas, switches virtuais ou agrupamento de portas, substitua eth0 através da interface realmente utilizada para a rede doméstica. network_mode: host permite a detecção UPnP na rede NAS.

/mnt/content:ro permanece inalterado como caminho do contêiner e só permite a leitura da música. O volume gerbera-data salva configurações e banco de dados permanentemente. restart: unless-stopped inicia o contêiner novamente após uma reinicialização do NAS se ele não tiver sido interrompido manualmente antes.

4. Inicie o aplicativo com biblioteca vazia

Abrir Estação de contêineres → Aplicativos → Criar. Use o nome gerbera-qnap.
Adicione o conteúdo completo do seu personalizado compose.yaml no campo YAML. Mantenha os recuos com espaços e clique Validar.
Crie e inicie o aplicativo. O primeiro download da imagem pode demorar algum tempo. Espere até gerbera-qnap é mostrado como ativo.
Abrir http://NAS_IP:49494/ no seu navegador. Um URL da web ausente no Container Station não impede o acesso direto. Neste estágio, a biblioteca Gerbera está intencionalmente vazia.

5. Configurar BPM, exibição de chave e título

Abrir em Gerbera Configuração e escolha em Listar moda a vista Especialista. Abaixo Library Options → taglib Library Options → metadados e abaixo ffmpeg Library Options → Metadados os seguintes mapeamentos. Preservar outras linhas existentes.

Tag Name e 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	chave	upnp:key
ffmpeg	chave inicial	upnp:initialKey

Abaixo Servidor → Nome o nome Gerbera QNAP uma. Desta forma, o servidor poderá posteriormente ser distinguido dos outros servidores de música.
Para AIFF abaixo Importar → Mapeamentos → Mimetype-ContentType as duas atribuições audio/x-aiff → aiff e audio/aiff → aiff suplemento. Sem essas atribuições, BPM, key e outros gêneros podem estar faltando, apesar das tags existentes. Configuração AIFF.
Para OGV abaixo ffmpeg Library Options a opção streams-enabled Ative para que as tags sejam lidas nas trilhas de áudio e vídeo. Configuração OGV.
Defina o campo para taglib e ffmpeg charset ligado UTF-8. Também filesystem-charset, metadata-charset e playlist-charset deveria UTF-8 usar.
Abaixo UPnP → Item de resultado do título esvazie o campo com M_ARTIST e receber M_TITLE. Isso fornece o título simples da faixa.
Abaixo WavPack Library Options permanece Habilitado ligado.
Clique em Salvar configuração, reinicie o container vazio no Container Station e após reabrir a configuração verifique se os valores estão salvos.

BPM e Key já devem estar salvos nos arquivos de música; Gerbera não calcula esses valores. Para MP4/M4A/M4V no existente id3elemento prefer_highest_bpm_accuracy="yes" e prefer_ambigous_bpm_value="bpm_tag" de acordo com Configurar a precisão BPM aos valores indicados. Sem a primeira opção, o comportamento anterior é mantido. Uma nova verificação normal pode ignorar arquivos que já foram importados e não foram alterados. Configure essas opções antes de importar músicas pela primeira vez. Tags de gênero separadas não precisam de configurações adicionais.

6. Habilite atualizações automáticas

Gerbera já monitora arquivos novos e alterados automaticamente. Adicione detecção de alterações de atributos de arquivo com este bloco completo no terminal raiz aberto:

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

No início da seção de autoscan de saída deve inotify-attrib="yes" ficar de pé. A configuração está no volume de dados persistente e será carregada na inicialização seguinte.

7. Monte a pasta de músicas e inicie Gerbera

Pare o projeto ou aplicativo gerbera-qnap na Estação de Contêineres.
Abrir Public/gerbera-qnap/compose.yaml na estação de arquivos. Substitua apenas o mapeamento de pasta vazio pela sua pasta de música real, por exemplo:

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

Salve o arquivo no NAS e copie todo o bloco a seguir no terminal root aberto. Ele aplica o arquivo Compose alterado, reutiliza o volume de dados existente e inicia Gerbera. Se o caminho do seu projeto for diferente, ajuste a primeira linha cd … ligado. O processo também se aplica a arquivos 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

Então abra-o http://NAS_IP:49494/ e espere a biblioteca carregar. Você pode ver o progresso abaixo Estação de Contêiner → Contêiner → gerbera-qnap → Protocolo. Continue a copiar apenas os arquivos totalmente preparados para a pasta de músicas. As listas de reprodução requerem caminhos de arquivo relativos válidos e codificação UTF-8.

8. Conecte MusicServer Connect

Em MusicServer Connect, selecione o servidor Gerbera QNAP. Use para uma conexão manual http://NAS_IP:49494/description.xml. Verifique o inventário de faixas, os valores BPM/chave salvos e a ordem de suas listas de reprodução.

Se você tiver problemas de conexão, verifique o status do contêiner, IP NAS, interface de rede e possíveis conflitos de porta. Para detecção UPnP deve UDP 1900, para a interface web e acesso à mídia TCP 49494 estar acessível na rede local. Em Permission denied controlar UID, GID e as permissões de leitura do usuário Gerbera. O caminho /content no protocolo Gerbera é normal para a imagem oficial.

Saia do terminal com exit; depois sudo -i isso geralmente é necessário duas vezes. Se você não precisar de SSH, remova no QTS Painel de controle → Serviços de rede e arquivos → Telnet/SSH a caixa de seleção para Permitir conexão SSH e clique em Aplicar.

9. Reinicializações e versões mais recentes do Gerbera

Para uma reinicialização normal, selecione Estação de Contêiner → Contêiner → gerbera-qnap → Reiniciar. As configurações e o banco de dados permanecem no volume de dados nomeado gerbera-data recebido. Ao reconstruir o contêiner, é usado o executável inalterado da imagem oficial.

Mudando de uma instalação 3.3.0 existente

Use a referência completa de imagens deste guia e preserve as configurações de música, IDs de usuário, nomes de projetos e volumes de dados. Recrie o contêiner conforme mostrado abaixo. Uma simples reinicialização não instala uma imagem diferente. A substituição do contêiner remove qualquer patch binário local anterior.

Atualize para uma versão estável mais tarde

Escolha no página oficial de lançamento do Gerbera uma versão estável que inclui a correção WavPack PR#3981 . Leia as notas de configuração e banco de dados. Até que tal versão esteja disponível, a versão do Git explicitamente especificada aqui é uma compilação provisória fixa. Não use um movimento latest- ou edgeetiqueta.
Abrir Public/gerbera-qnap/compose.yaml. Substitua isso o valor completo depois image: através gerbera/gerbera:NEUE_VERSION. Isso também inclui a remoção dos anteriores @sha256:…referência, pois pertence à imagem antiga. Substituir NEUE_VERSION com o número da versão selecionada. Como alternativa, use a referência completa da imagem do guia atualizado. Mantenha todas as outras configurações inalteradas.
Se necessário, habilite o SSH conforme descrito acima e faça login no terminal raiz. Baixe a imagem selecionada:

docker pull gerbera/gerbera:NEUE_VERSION

Pare o projeto ou aplicativo existente no Container Station. Execute o bloco de comando completo Passo 7 fora. O volume de dados existente não deve ser excluído.
Aguarde a inicialização e a conclusão de qualquer atualização do banco de dados. Verifique a versão, o nome do servidor e o protocolo e as configurações BPM/chave salvas. Conecte MusicServer Connect e confira diversas faixas, arquivos WavPack e playlists.

Guias do fornecedor: Mudanças na estação de contêiner QNAP e YAML, Habilite SSH em QNAP, Criar usuário QTS, imagem oficial do Docker Gerbera.

Synology: Configure Gerbera com correção WavPack passo a passo

Gerbera é um software de servidor de mídia adicional para seu Synology. Seu principal benefício para MusicServer Connect é o acesso aos valores já armazenados em seus arquivos de música: BPM e metadados de tonalidade musical: O servidor de mídia UPnP integrado do Synology não fornece essas informações. As etapas a seguir configuram os mapeamentos de metadados necessários.

Quando você não precisa de Gerbera? Se seus arquivos de música não contiverem valores BPM/chave armazenados, você não precisará de Gerbera para essa finalidade. VirtualDJ pode calcular BPM e tom musical analisando os arquivos sem um servidor de música. Você pode continuar usando o servidor de mídia integrado do Synology e deixar o VirtualDJ calculá-los.

O próprio servidor de mídia do Synology pode continuar funcionando junto com o Gerbera, por exemplo, para WiiM Home Advanced Mode. Gerbera não suporta este modo WiiM. Sua música permanece na pasta existente; Gerbera obtém acesso somente leitura. Este guia também permite a detecção automática de arquivos novos e alterados.

1. NAS e preparar usuários

Faça login na interface do DSM Synology com uma conta que pertença ao grupo administrador ouvi. Esta é uma conta que tem permissão para gerenciar pacotes e usuários. O nome da conta não precisa admin leia. Se sua conta não tiver esses direitos, você precisará da pessoa que gerencia o NAS.
Abra isto Central de encomendas e instale Gerenciador de contêineres. Se este pacote não estiver disponível para o seu modelo, este guia não se aplica a ele. Para editar o arquivo YAML, você também pode instalar o pacote Synology Editor de texto instalar.
Abrir Painel de Controle → Usuários e Grupo → Usuários → Criar. Crie o usuário gerbera ligado. Não requer direitos de administrador. Atribua sua própria senha; Você continuará usando sua conta de administrador do DSM para os comandos de terminal a seguir.
Abrir Painel de controle → Pasta compartilhada, selecione sua pasta de músicas, por exemplo musice escolha Editar → Permissões. Dê ao usuário gerbera permissão Somente leitura. O acesso também deve se aplicar às pastas e arquivos de música incluídos.

Os exemplos usam /volume1/music como a pasta de música e /volume1/docker para arquivos contêiner. Se essas pastas estiverem em um volume diferente, use seus caminhos NAS reais nos locais apropriados. Os caminhos do contêiner /mnt/content e /var/run/gerbera permaneça o mesmo.

2. Crie pastas e copie arquivos

Abrir Estação de arquivos. Na pasta compartilhada, crie docker a subpasta gerbera-synology . Se a pasta compartilhada docker está faltando, crie-o em Painel de controle → Pasta compartilhada → Criar .
Crie outra subpasta chamada empty ligado. Esta pasta permanece vazia. Serve como uma pasta temporária de músicas para que a importação só comece após a configuração dos metadados.
Baixe o Componha o arquivo como compose.yaml para o seu computador.
Carregue o arquivo usando Estação de arquivos → Carregar diretamente em docker/gerbera-synology ao lado da pasta empty. O nome do arquivo deve ser exatamente compose.yaml sem adicional .txt estar anexado.

A pasta do projeto contém estas duas entradas:

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

3. Ative o SSH, faça login em NAS e determine seus IDs

Você precisa de acesso de terminal ao NAS para encontrar IDs de usuário e executar os seguintes comandos do Docker. Você pode copiar os comandos mostrados aqui; não é necessário conhecimento de programação.

Verifique a conta e a senha do DSM

Abrir no DSM Painel de controle → Usuário e grupo → Usuário. Destaque a conta que deseja usar para fazer login posteriormente via SSH e clique em Editar.
A conta deve estar ativada: Se necessário, remova a seleção Desative esta conta de usuário. Após salvar, a lista de usuários deve mostrar o status Normais em vez disso Desativado são mostrados.
Abaixo Grupos de usuários a conta deve pertencer a administrador grupo. Você precisa da senha desta conta para fazer login e depois mudar para root. Caso não saiba, defina e confirme uma nova senha nas configurações da conta. Salve as alterações.

Você pode usar sua conta de administrador DSM existente para fazer isso. Você deseja especificamente a conta integrada admin Para utilizá-lo, ative esta conta conforme descrito e atribua uma senha conhecida. A conta integrada admin não precisa ser ativado se você tiver outra conta ativa do grupo administrators usar. O usuário criado na etapa 1 gerbera é usado exclusivamente para acesso à música e não requer esses direitos de administrador.

Ative o serviço SSH no NAS

No DSM, abra o Painel de controle e lá Terminal e SNMP. Selecione a guia Terminais.
Marque a caixa de seleção para Habilitar serviço SSH. Para este guia, deixe o porto em 22 são mostrados.
Clique em Aplicar. Só então o NAS aceitará conexões SSH. Se o firewall DSM estiver ativo, ele deverá permitir a porta SSH definida para o seu computador na rede local.

Faça login no seu computador e mude para root

Você pode encontrar o endereço IP NAS em Painel de controle → Rede → Interface de rede. Abra no PC Windows Terminais ou PowerShell; em um Mac, o aplicativo Terminais.
Digite este comando. Substituir DEIN_DSM_KONTO com sua conta de administrador do DSM e NAS_IP com seu endereço IP NAS. Não use o usuário recém-criado gerbera.

ssh DEIN_DSM_KONTO@NAS_IP

Ao estabelecer a conexão pela primeira vez, poderá aparecer uma consulta referente à identidade do NAS. Verifique o endereço de destino exibido e confirme a conexão com yes. Em seguida, digite a senha da sua conta DSM. Nenhum caractere ou asterisco aparece quando você digita a senha; isso é normal. Se você usar uma porta SSH diferente, adicione-a ao conectar. -p PORTNUMMER.

Em seguida, mude para os direitos necessários para o Docker com este comando:

sudo -i

Se for solicitada uma senha novamente, use a mesma senha da sua conta DSM. Não é necessária uma senha root especial. O prompt geralmente termina com #. Mantenha esta janela do terminal aberta durante a configuração. Todos os comandos de terminal a seguir são executados no NAS.

Para Connection refused Primeiro verifique se você está usando o serviço SSH Aplicar está ligado e usando o endereço IP e o número de porta corretos. Se a senha for rejeitada, verifique o nome da conta, senha, status Normais e adesão em administrador. Guia do Synology para login SSH com privilégios de root também descreve esse processo.

Visualizar IDs de usuário Gerbera:

id gerbera

Saída como uid=1030(gerbera) gid=100(users) significa: UID é 1030, GID é 100. Observe os números da sua própria saída: eles identificam o usuário e o grupo.

4. Personalizar arquivo de composição

No File Station, abra o arquivo docker/gerbera-synology/compose.yaml com Editor de texto. Alternativamente, edite-o no seu computador e carregue-o novamente. Para UID e GID digite os números que você acabou de anotar; você deve substituir os valores de exemplo abaixo. Se necessário, ajuste o caminho NAS para a pasta vazia do projeto. Salve o arquivo.

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 a detecção na rede doméstica sem um endereço IP fixo no YAML. O fim :ro Gerbera permite apenas a leitura da pasta de músicas. Em volume gerbera-synology-data As configurações e o banco de dados são salvos permanentemente. restart: unless-stopped permite que o contêiner NAS seja iniciado novamente após uma reinicialização do NAS, desde que você não o tenha interrompido manualmente antes.

5. Inicie o projeto com uma biblioteca vazia

Abrir Gerenciador de contêineres → Projeto → Criar. Use exatamente este nome de projeto: gerbera-synology e a pasta preparada como o caminho docker/gerbera-synology.
Escolha o preparado compose.yaml como um arquivo Compose existente. Se a caixa de diálogo oferecer um editor YAML, você poderá inserir o conteúdo lá.
Para Configurações do portal da web permanece Configurar portal web via Web Station desligado. Clique em Próximo e crie e inicie o projeto. O primeiro download da imagem pode demorar algum tempo.
Abaixo Contêiner → gerbera-synology deve ser o status Correndo ou Correndo aparecer.
Abrir no navegador http://NAS_IP:49494/, por exemplo http://192.168.1.10:49494/. Substitua o endereço de exemplo pelo seu IP NAS. Você vê a superfície de Gerbera; a biblioteca de música está intencionalmente vazia neste momento.

6. Configurar BPM, exibição de chave e título

Abrir em Gerbera Configuração e selecione a visualização Especialista. Abaixo Library Options → taglib Library Options → metadados bem como sob ffmpeg Library Options → Metadados adicione as linhas a seguir, mantendo outros mapeamentos existentes.

Tag Name e 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	chave	upnp:key
ffmpeg	chave inicial	upnp:initialKey

Abaixo Servidor → Nome o nome Gerbera Synology uma. Desta forma, o servidor poderá posteriormente ser distinguido dos outros servidores de música.
Para AIFF abaixo Importar → Mapeamentos → Mimetype-ContentType as duas atribuições audio/x-aiff → aiff e audio/aiff → aiff suplemento. Sem essas atribuições, BPM, key e outros gêneros podem estar faltando, apesar das tags existentes. Configuração AIFF.
Para OGV abaixo ffmpeg Library Options a opção streams-enabled Ative para que as tags sejam lidas nas trilhas de áudio e vídeo. Configuração OGV.
Defina o campo charset para taglib e ffmpeg para UTF-8. Também filesystem-charset, metadata-charset e playlist-charset deveria UTF-8 usar.
Abaixo UPnP → Item de resultado do título esvazie o campo com M_ARTIST e receber M_TITLE. O nome puro do título é transferido como título em vez de “Artista – Título”.
Abaixo WavPack Library Options permanece Habilitado ligado.
Clique em Salvar configuração, reinicie o contêiner no Container Manager e verifique se os valores foram salvos após reabrir a configuração Gerbera.

BPM e Key já devem estar salvos nos arquivos de música; essas configurações não calculam os valores. Para MP4/M4A/M4V no existente id3elemento prefer_highest_bpm_accuracy="yes" e prefer_ambigous_bpm_value="bpm_tag" de acordo com Configurar a precisão BPM aos valores indicados. Sem a primeira opção, o comportamento anterior é mantido. Em seguida, importe os arquivos afetados novamente.

7. Habilite atualizações automáticas

Gerbera já monitora arquivos novos e alterados automaticamente. Com o bloco a seguir você pode adicionar a detecção de alterações nos atributos do arquivo. Copie o bloco inteiro para o terminal NAS ainda aberto:

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

A saída deve estar no início da seção autoscan inotify-attrib="yes" ficar de pé. O arquivo está no volume de dados permanente. A configuração será carregada com a pasta de música quando você iniciá-la posteriormente.

8. Monte a pasta de músicas e inicie Gerbera

Pare o projeto ou aplicativo gerbera-synology no Gerenciador de contêineres.
Abrir docker/gerbera-synology/compose.yaml na estação de arquivos. Substitua apenas o mapeamento de pasta vazio pela sua pasta de música real, por exemplo:

- /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

Então abra-o http://NAS_IP:49494/ e espere a biblioteca carregar. Você pode ver o progresso abaixo Gerenciador de contêiner → Contêiner → gerbera-synology → Protocolo. Continue a copiar apenas os arquivos totalmente preparados para a pasta de músicas. As listas de reprodução requerem caminhos de arquivo relativos válidos e codificação UTF-8.

9. Conecte-se com MusicServer Connect

Em MusicServer Connect, selecione o servidor Gerbera Synology. Se for necessário um URL de dispositivo, use http://NAS_IP:49494/description.xml. Verifique suas músicas, álbuns e playlists e abra algumas músicas com BPM e valores-chave salvos.

Se a interface não estiver acessível ou o servidor não for encontrado, verifique primeiro o status do contêiner e o IP NAS. Se o firewall DSM estiver ativado TCP 49494 e para detecção de UPnP UDP 1900 da sua rede local. Se o log relatar Permission denied para a pasta de músicas, verifique a permissão de leitura do usuário gerbera e UID e GID da etapa 3. O caminho /content no protocolo é normal para a imagem oficial; refere-se à pasta de música integrada.

Depois, saia do terminal com exit sair; depois sudo -i geralmente é duas vezes exit necessário. Se você não precisar de SSH, abra no DSM Painel de controle → Terminal e SNMP → Terminal, desmarque a caixa de seleção para Habilitar serviço SSH e clique em Aplicar.

10. Reinicializações e versões mais recentes do Gerbera

Para uma reinicialização normal, selecione Gerenciador de contêiner → Contêiner → gerbera-synology → Reiniciar. As configurações e o banco de dados permanecem no volume de dados nomeado gerbera-synology-data recebido. Ao reconstruir o contêiner, é usado o executável inalterado da imagem oficial.

Mudando de uma instalação 3.3.0 existente

Atualize para uma versão estável mais tarde

Escolha no página oficial de lançamento do Gerbera uma versão estável que inclui a correção WavPack PR#3981 . Leia as notas de configuração e banco de dados. Até que tal versão esteja disponível, a versão do Git explicitamente especificada aqui é uma compilação provisória fixa. Não use um movimento latest- ou edgeetiqueta.
Abrir docker/gerbera-synology/compose.yaml. Substitua isso o valor completo depois image: através gerbera/gerbera:NEUE_VERSION. Isso também inclui a remoção dos anteriores @sha256:…referência, pois pertence à imagem antiga. Substituir NEUE_VERSION com o número da versão selecionada. Como alternativa, use a referência completa da imagem do guia atualizado. Mantenha todas as outras configurações inalteradas.
Se necessário, habilite o SSH conforme descrito acima e faça login no terminal raiz. Baixe a imagem selecionada:

docker pull gerbera/gerbera:NEUE_VERSION

Pare o projeto ou aplicativo existente no Container Manager. Execute o bloco de comando completo Passo 8 fora. O volume de dados existente não deve ser excluído.
Aguarde a inicialização e a conclusão de qualquer atualização do banco de dados. Verifique a versão, o nome do servidor e o protocolo e as configurações BPM/chave salvas. Conecte MusicServer Connect e confira diversas faixas, arquivos WavPack e playlists.

Guias do fornecedor: Projetos de gerenciador de contêineres, Modelos NAS disponíveis para Container Manager, Login SSH com direitos de administrador, Imagem oficial Gerbera.

WiiM Home: biblioteca de mídia expandida

WiiM Home Advanced Mode fornece sua própria visualização de biblioteca com categorias de álbum, artista e faixa. Os servidores suportados incluem MinimServer, servidor padrão Synology, servidor padrão QNAP e Serviio. Gerbera atualmente fornece a visualização de pasta em WiiM Home.

No Advanced Mode, o WiiM importa metadados do servidor para seu próprio índice e, em seguida, cria visualizações uniformes de álbuns, artistas, faixas, playlists e gêneros e sua própria pesquisa. Em Legacy Mode, ele exibe a navegação do servidor. Estes termos descrevem os modos de operação WiiM Home.

Recomendação para compartilhamento

Os servidores Synology e QNAP padrão suportam WiiM Home Advanced Mode, que não precisa de BPM ou metadados de chave. A ordem incorreta da lista de reprodução do QNAP também permanece uma limitação no WiiM Home.

Se VirtualDJ calcular BPM e se codificar, o servidor de mídia padrão de Synology será suficiente para MusicServer Connect. O mesmo se aplica a QNAP se a ordem incorreta da lista de reprodução for aceitável. Uma instalação adicional do Gerbera é desnecessária nesses casos.

Para usar valores BPM/chave armazenados ou preservar a ordem da lista de reprodução QNAP em MusicServer Connect, você pode adicionar Gerbera com a correção WavPack no Docker. Selecione Gerbera no plugin e o servidor padrão em WiiM Home Advanced Mode. Ambos podem ler a mesma biblioteca de música. MinimServer continua sendo uma solução de servidor único que atende a esses requisitos e WiiM Home Advanced Mode; ele ainda precisa da configuração extra de BPM/key tag. A execução de Gerbera em Synology requer um Container Manager disponível.

Mais informações: WiiM Home: Biblioteca de mídia e servidores suportados.

Ampache 7/8: Leia vídeos e listas de reprodução de arquivos

Um catálogo de música não importa vídeos para Ampache. Para a videoteca, um catálogo local adicional com o tipo de mídia Vídeo e digitalize-o. Os caminhos do catálogo não devem se sobrepor. Nossa configuração, portanto, usa uma visualização de diretório Linux somente leitura adicional apontando para os mesmos arquivos de vídeo; os arquivos da biblioteca compartilhada permanecem inalterados.

Importe listas de reprodução baseadas em arquivos explicitamente. O comando CLI oficial é php bin/cli run:updateCatalog -i "Katalogname"; use a versão do PHP e a conta de serviço apropriadas à sua instalação. Uma nova verificação de metadados por si só é insuficiente. Ambas as versões forneceram entradas de áudio com repetições em nossa comparação; entradas de vídeo estavam ausentes nas listas de reprodução de arquivos mistos.

Entregar MP3 inalterado

Se a conversão automática de MP3 for permitida, mas nenhum conversor estiver configurado, Ampache 8 poderá retornar HTTP 500 durante o streaming. Para entrega inalterada na configuração existente, transcode_mp3 = "false" ao valor indicado. Como alternativa, configure um transcodificador funcional. Com a conversão MP3 desativada, tanto o streaming quanto o download foram verificados byte por byte em nossas verificações.

LMS: Playlists com faixas do mesmo álbum

Nas configurações LMS em Diversos a opção Ignorar playlists que contenham faixas do mesmo álbum se você quiser que essas listas de reprodução apareçam. Em seguida, recarregue a biblioteca. A comparação confirmou que as faixas de áudio repetidas foram fornecidas na ordem original.

Asset UPnP: pastas de mídia e playlist

Na interface da web de ativos em Pastas → Pastas de mídia adicione a pasta da biblioteca. Abaixo Pastas da lista de reprodução especifique cada pasta com arquivos de lista de reprodução individualmente; As pastas de lista de reprodução subordinadas não são incluídas automaticamente nelas. Estes estão em teste /srv/music/Playlists e /srv/music/Format-Test-1.3/Playlists.

Abaixo Opções → Configurações de exibição Desative os prefixos para números de faixas, artistas antes das faixas de compilação e artistas após os títulos das listas de reprodução se desejar nomes de faixas simples. Essas configurações alteram a exibição, não os arquivos de música. O provedor de ativos usa a ramificação integrada Listas de reprodução para listas de reprodução de arquivos. Esta consulta não atravessa recursivamente combinações de filtros dinâmicos ou rádio na Internet. A navegação padrão verificada, incluindo a Navegação Dinâmica, pode ser mantida. As visualizações de catálogo, artista, álbum e gênero foram verificadas sem erros de recuperação após esse ajuste. Ativos fornecem M3U, M3U8 e PLS; Os títulos das faixas PLS retornados pelo servidor podem conter um prefixo de artista.

Guia de ativos

Jellyfin 12.2.0: DLNA e perfil do cliente

Jellyfin requer o oficial para MusicServer Connect Plug-in DLNA. Instale-o do catálogo oficial de plugins na administração do servidor e reinicie o Jellyfin. DLNA 14.0.0.0 foi verificado. Em suas configurações, escolha a conta cujas bibliotecas deverão ser expostas via DLNA. MusicServer Connect usa UPnP/DLNA, independentemente do login na própria interface web do Jellyfin.

Bibliotecas e metadados

Arquivos de áudio como tipo de biblioteca Música, vídeos como Vídeos musicais como bibliotecas. Torne legíveis as pastas relevantes de mídia e lista de reprodução e verifique ambas as bibliotecas. Para usar apenas tags de arquivo, desative metadados externos e provedores de imagens; verifique também as configurações globais do artista e do álbum. Mantenha títulos incorporados e imagens locais ativados. Nossa configuração acessa a biblioteca de música compartilhada somente leitura.

Perfil do cliente para MusicServer Connect

O Baixe um perfil de cliente DLNA verificado e como MusicServer Connect.xml Salve na pasta de perfil de usuário do plugin DLNA. Isso é menor para a instalação nativa do Debian /var/lib/jellyfin/plugins/configurations/dlna/user/; para outras instalações, use o diretório de dados Jellyfin real. O serviço Jellyfin deve ser capaz de ler o arquivo. Reinicie Jellyfin e atualize a biblioteca de plugins.

O perfil identifica MusicServer Connect por seu User-Agent. Ele fornece URLs de recursos estáveis e tipos de mídia corretos para áudio M4A e vídeo OGV, mantendo as visualizações do álbum acessíveis e esses formatos visíveis no catálogo. Ele é armazenado separadamente dos perfis de sistema fornecidos.

Restrições restantes

Todas as fontes de áudio e vídeo e visualizações do plugin 195 foram recuperadas sem erros na verificação com arquivos 125. Sobre DLNA, Jellyfin não fornece BPM/chave e dimensiona incorretamente as taxas de bits. ASX/XSPF estão ausentes; M3U, M3U8, PLS e WPL perdem faixas repetidas. Algumas listas M3U/M3U8 mais antigas também estão incompletas. Alguns artistas de álbuns são atribuídos incorretamente e as pastas de música simples podem não ter uma visualização nativa do álbum. WMA carece de seu segundo gênero; os vídeos carecem de artista, álbum e gênero. O perfil do cliente não corrige essas limitações.

Instalação oficial do Linux · Documentação oficial do DLNA

WiiM Home, Mezzmo e Windows Media Player

Com esses servidores Windows, o MusicServer Connect usa automaticamente a trilha verificada ou as pastas de arquivos para evitar respostas de pesquisa global incorretas ou muito lentas. Nenhuma configuração adicional de plug-in é necessária. As pesquisas de plug-in são executadas no catálogo importado.

As respostas UPnP podem levar até 30 segundos ou 60 segundos para Windows Media Player. As solicitações permanecem canceláveis. Páginas inválidas ou alteradas ainda serão rejeitadas; esperar mais não pode fornecer arquivos ou metadados ausentes.

WiiM Home Media Server 0.2.10.5

Os servidores de música e o VirtualDJ podem ser executados no mesmo PC Windows, incluindo vários servidores ao mesmo tempo. A lista de servidores combina a descoberta UPnP normal com uma verificação adicional de servidores locais suportados. Ele identifica suas portas abertas reais e verifica as descrições dos dispositivos UPnP. IDs de dispositivos diferentes permanecem separados; vários pontos de extremidade para um servidor não criam entradas duplicadas. Não são necessários direitos de administrador.

A descoberta UPnP normal do Windows não encontrou WiiM Home no mesmo PC em nossa verificação, embora a descrição do dispositivo estivesse acessível. A descoberta suplementar do plugin o considera como WiiM Home: LaptopAcer — em outro PC, use o nome dele. Na caixa de diálogo de conexão, clique em Pesquise novamente e selecione o servidor WiiM. Esta conexão UPnP não precisa de nome de usuário ou senha. WiiM Home, Mezzmo e Windows Media Player foram verificados em execução simultaneamente.

Para uma versão mais antiga do plugin, o endereço da descrição completa pode ser salvo temporariamente em URL servidor aqui. Por exemplo, o caminho local verificado é http://127.0.0.1:22346/upnp/DeviceDescription.xml. A porta e o caminho devem pertencer ao servidor em execução; o plugin não assume uma porta fixa. Neste computador, a porta 22345 também expôs o mesmo servidor WiiM. O nome do host escrito localhost retornou HTTP 404 em uma verificação direta e não foi aceito como substituto equivalente. A falha de descoberta não pode ser atribuída de forma conclusiva a WiiM Home ou Windows.

Adicione a pasta de músicas à biblioteca de mídia local e ative o compartilhamento DLNA. A fonte original foi usada no teste \\smbserver\music . Esta interface não fornece listas de reprodução nem vídeos baseados em arquivos; AAC ADTS, Opus e WavPack também estão ausentes. As listas de reprodução salvas no aplicativo WiiM não demonstram suporte para importação de arquivos de lista de reprodução externos.

Mezzmo 6.0.6.0

Adicione a pasta Biblioteca incluindo subpastas. Playlists de arquivos externos separadas por Criar playlist → Playlist conectada . “Adicionar arquivos de uma lista de reprodução externa” importa a mídia referenciada e é uma operação diferente. Para preservar as tags originais dos arquivos, deixe a recuperação e gravação automática de metadados da Internet desativadas.

Oferta de propriedades de pasta Verifique as pastas em busca de novos arquivos a cada. As listas já vinculadas possuem resultados separados. O monitoramento de pastas por si só não criou listas vinculadas a partir de arquivos de lista de reprodução, mesmo com extensões extras de lista de reprodução configuradas. Atualizar um link existente e descobrir novos arquivos de lista de reprodução são recursos diferentes. As listas verificadas separadamente perdem repetições com M3U/PLS/WPL; M3U8/XSPF permanecem vazios e ambas as amostras ASX relatam contagens de páginas inconsistentes. Playlists inteligentes não podem substituir uma ordem externa fixa por repetições.

O filtro padrão inclui .aif, mas não .aiff. A adição de *.aiff indexou a amostra apenas como um tipo de arquivo desconhecido sem fluxo, portanto, essa alteração foi revertida. WavPack também não foi exposto como jogável para o cliente verificado. Uma entrada no banco de dados por si só não prova a jogabilidade.

Windows Media Player Legado/Compartilhamento 12.0

Abaixo Painel de controle → Central de rede e compartilhamento → Opções de streaming de mídia ligado Permitir tudo clique e com OK salve. Isso dá aos dispositivos na rede local, incluindo WiiM e ao telefone celular com WiiM Home, acesso à biblioteca de mídia. Em Acesso negado Verifique a aprovação deste dispositivo: O funcionamento do acesso ao plugin no mesmo PC não significa que dispositivos externos sejam permitidos.

Habilite o streaming de mídia para a rede local e adicione pastas locais de música e vídeo às suas bibliotecas Windows. Você pode desativar a recuperação e gravação automática de metadados da Internet para preservar os arquivos de origem. A comparação local completa retornou arquivos de mídia reais 146 e decodificou totalmente todas as amostras de formato oferecidas pelo 20. OGG, Opus, WavPack, WebM e OGV estavam ausentes; BPM e chave não foram fornecidos. Após a reconstrução do catálogo WMP, seis listas de reprodução não vazias foram retornadas. Alguns nomes diferem das listas importadas; duas listas M3U mais antigas perdem uma trilha devido à codificação de caracteres. Seus equivalentes WPL contêm todas as quatro faixas.

Use nomes de playlists sem pontos, por exemplo MSC Misto 1-3 em vez disso MSC Misto 1.3. Na comparação WPL, M3U e M3U8 direcionada, o WMP truncou os nomes das cópias de importação salvas no primeiro ponto; o nome abreviado também apareceu no UPnP. Um hífen preservou o nome completo.

Para WMP, o plugin solicita listagens apenas de estrutura com um pequeno filtro de metadados. Metadados completos da faixa, recursos e conteúdo da lista de reprodução ainda são lidos, com paginação e verificações de consistência mantidas. Para esta biblioteca, a limpeza e a otimização do plug-in reduziram a primeira solicitação de catálogo medida de cerca de 22 segundos para 4.3 – 4.6 segundos. Esta é uma medida de provedor para a biblioteca verificada, não uma promessa geral para a interface do VirtualDJ ou bibliotecas maiores.

Se sua coleção também contém arquivos de lista de reprodução, adicione apenas as subpastas de áudio reais à biblioteca de música Windows e adicione pastas de vídeo separadamente. Importe listas de reprodução explicitamente para o WMP. Adicionar toda a pasta pai fez com que o WMP expusesse alguns arquivos da lista de reprodução como faixas de áudio ou listas vazias. Importações repetidas criaram cópias WPL adicionais na pasta Windows Música → Listas de reprodução. Antes de reconstruir, faça backup do catálogo WMP e arquive cópias de importação antigas e claramente identificadas fora das pastas monitoradas; reconstruir o banco de dados por si só os indexaria novamente. A mídia e as playlists originais são mantidas.

Os arquivos de mídia no compartilhamento SMB não funcionaram como uma biblioteca WMP DLNA em nosso teste, mesmo por meio da unidade de rede Y:. O serviço conseguia ler um arquivo original e o Samba já permitia leitura e gravação, mas o catálogo de mídia compartilhada permanecia vazio. Esta descoberta se aplica à fonte de rede verificada aqui, não a todas as configurações SMB. Os arquivos locais são cobertos pela verificação local separada.

Os arquivos offline Windows não foram utilizados, pois criam uma cópia local sincronizada. Depois de reiniciar o serviço, a descrição do dispositivo WMP e UPnP root ficaram acessíveis novamente em cerca de três segundos em nossa verificação. Uma entrada de servidor ausente inicialmente não requer automaticamente a reconstrução de sua biblioteca.

Documentação do fabricante

Configuração Gerbera

Gonic: pastas de música

MinimServer: Configuração

MariaDB: alterar colunas do banco de dados

Navidrome: Agrupe álbuns independentemente da data de lançamento

Navidrome: dar prioridade às capas incorporadas

Ampache e LMS: Login com chave API

Ampache 7.10.2: Importar títulos sem artistas de títulos

Sintoma e causa

Escopo

O que mudou

Correção geral do banco de dados

Requisitos

Importe os arquivos ausentes e verifique o resultado

Operação e atualizações posteriores

Gonic 0.22.0: um álbum por pasta de música

Sintoma e causa

Estrutura de pastas recomendada

Verifique após a alteração

Forneça listas de reprodução baseadas em arquivos para o usuário

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

MP4, M4A e M4V: prefira tags BPM mais precisas

AIFF: BPM, chave e leitura de vários gêneros

OGV: Adote tags das trilhas de áudio e vídeo

WebM e WMV: adote vários gêneros com o leitor certo

Detecte automaticamente alterações em arquivos e atributos

Inotify no contêiner oficial Gerbera

Gerbera 3.3.0-77: nomes de títulos puros nos resultados da pesquisa

Gerbera: visualizações e importação da lista de reprodução

Por que a mesma playlist aparece várias vezes

Verifique importações incompletas de playlists

Referências de lista de reprodução obsoletas e conjunto de caracteres M3U

MiniDLNA / ReadyMedia 1.3.3: Extensões de arquivo de lista de reprodução

Recomendação: renomeie M3U se possível

Alternativa: preservar uma fonte M3U8 compartilhada

Permissões de cache ao reconstruir

Compartilhe áudio e vídeo

Serviio 2.5: liberar visualizações necessárias

Ordem das faixas

Diferentes artistas de álbuns salvos

Se houver múltiplas tags de gênero, somente a primeira será adotada.

Leia também vídeos

Servidor Twonky 8.5.2: recuperação completa de faixas e álbuns

Universal Media Server 15.8.2: serviço Linux e exibição de álbum

Artistas de álbuns e pesquisa de banco de dados

Ordem do álbum original

Arquivos ASX e pesquisa de catálogo incompleta

Conversão e streaming de áudio WAV

Oculte a pasta extra de transcodificação

MinimServer: BPM/chave e atualização de biblioteca

Leia BPM e chave de arquivos de música

Releia após as alterações

Combine um álbum de várias pastas

M3U/M3U8: conjunto de caracteres e entradas ausentes

JRiver: importe playlists e permita acesso de leitura

Synology: Configurar servidor de mídia padrão

FRITZ!Box: formatos de áudio e artistas de faixas

Configure o servidor de mídia

Formatos de áudio e metadados

Recomendação: use artistas de trilha

Listas de reprodução

QNAP: Execute o servidor de mídia padrão e Gerbera em paralelo

Adicionar Gerbera para MusicServer Connect

QNAP: Configure Gerbera com correção WavPack passo a passo

1. Preparar pastas, usuários e arquivos

2. Habilite SSH e obtenha acesso root

3. Personalizar arquivo de composição

4. Inicie o aplicativo com biblioteca vazia

5. Configurar BPM, exibição de chave e título

6. Habilite atualizações automáticas

7. Monte a pasta de músicas e inicie Gerbera

8. Conecte MusicServer Connect

9. Reinicializações e versões mais recentes do Gerbera

Mudando de uma instalação 3.3.0 existente

Atualize para uma versão estável mais tarde

Synology: Configure Gerbera com correção WavPack passo a passo

1. NAS e preparar usuários

2. Crie pastas e copie arquivos

3. Ative o SSH, faça login em NAS e determine seus IDs

Verifique a conta e a senha do DSM

Ative o serviço SSH no NAS

Faça login no seu computador e mude para root

4. Personalizar arquivo de composição

5. Inicie o projeto com uma biblioteca vazia