Consigli per la configurazione avanzata

Aggiornato: 19.10.2026

Le impostazioni del server richieste e le guide di installazione aggiuntive sono raccolte qui. I collegamenti di configurazione nell'elenco di compatibilità portano alle sezioni pertinenti.

Navidrome: raggruppa gli album indipendentemente dalla data di uscita

Navidrome 0.64.2 raggruppa anche gli album per data di uscita per impostazione predefinita. Se i tag della data in formati di file diversi vengono interpretati come anno di registrazione o di uscita, lo stesso album potrebbe apparire più di una volta.

Per ignorare le date di rilascio quando si raggruppano gli album, impostare la seguente regola in Navidrome. Sostituisci una regola esistente anziché aggiungere una chiave TOML duplicata. Se aggiungi una nuova regola, posizionala al livello più alto prima delle sezioni della tabella.

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

MusicBrainz L'ID dell'album, l'artista dell'album, il nome dell'album e la versione dell'album determinano comunque il raggruppamento. La regola vale per tutta la biblioteca. Le pubblicazioni che differiscono solo per la data possono essere combinate. Non sono necessarie modifiche ai tag dei file multimediali.

Navidrome quindi riavviare. La regola dell'album modificata attiva una scansione completa. Quindi ricaricare la visualizzazione dell'album nei client. Una variabile d'ambiente ND_PID_ALBUM ha la precedenza sul file di configurazione e potrebbe essere necessario modificarlo di conseguenza.

Fonte: Navidrome: identificatori di album e traccia configurabili.

Navidrome: preferire le copertine incorporate

Quando brani di album diversi condividono una cartella, un file Folder.jpg comune può sostituire tutte le copertine. Questa priorità preferisce una copertina incorporata disponibile; se manca, le altre fonti restano disponibili come alternative.

In navidrome.toml sostituire il valore esistente o aggiungere l’impostazione al livello principale prima delle sezioni di tabella. Non duplicare la chiave.

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

Riavviare quindi Navidrome. Il solo riavvio non ricalcola le copertine memorizzate. In Navidrome 0.64.2 è possibile risolvere nuovamente i singoli album interessati con il comando artwork ufficiale:

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

Sostituire il percorso di esempio e gli identificativi degli album. Eseguire il comando con lo stesso utente di servizio, directory di lavoro, configurazione, ambiente e database di Navidrome. Non è necessario modificare i file o i tag, né eliminare il database.

Sincronizzare poi nuovamente la libreria del client, ad esempio Amperfy, per ricevere i nuovi identificativi delle copertine. Non è necessario reinstallare l’app né svuotare tutta la cache delle copertine.

Ampache e LMS: accesso con chiave API

Ampache 7, Ampache 8 e LMS richiedono una chiave API per l'accesso. Crea una chiave per il tuo account sul server e usala quando ti connetti a MusicServer Connect. Mantienilo riservato.

Ampache 7.10.2: importa titoli senza artisti dei titoli

Sintomo e causa

I file senza artista del brano potrebbero essere omessi durante l'importazione del catalogo. La correzione del database riportata di seguito ne abilita l'importazione. L'accesso Ampache richiede una chiave API; vedere Accedi con una chiave API.

Ambito

Questa correzione si applica a Ampache 7.10.2 con MariaDB e la definizione di colonna mostrata di seguito. Per le altre versioni verificare innanzitutto se si applica la stessa causa.

Cosa è cambiato

Solo song.artist nel database Ampache selezionato viene modificato per consentire NULL. Il tipo di dati, il valore predefinito 0 e gli indici esistenti vengono conservati. Il codice sorgente Ampache e i file musicali rimangono invariati. Nessun nome di artista viene inventato e nessun tag di file viene sostituito. Gli altri database e le impostazioni globali di MariaDB non sono interessati.

Correzione generale del database

Requisiti

Esegui questi comandi sul server MariaDB, all'interno del suo contenitore ove applicabile. L'account del database necessita dell'accesso in lettura per il controllo e l'autorizzazione ALTER sul brano. L'esempio utilizza l'accesso root locale. Per un altro account database, utilizza la configurazione client sicura esistente; non inserire una password nel comando.

Innanzitutto identificare il nome effettivo del database, elencato come database_name nella configurazione Ampache. Utilizza il nome del tuo database in ogni comando.

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

Per il problema confermato, l'output mostra Type=int(11) unsigned, Null=NO e Default=0. Se Null=YES, la correzione è già applicata. Non modificare una definizione diversa senza controllarla.

Consigliato: lo script allegato Scarica ampache7-null-artist.sh sul server del database. Controlla la colonna, accetta solo il tipo INT senza segno previsto e non apporta ulteriori modifiche se NULL è già consentito. Uno schema inaspettato lo fa fermare senza modifiche.

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

Il nucleo SQL concreto della correzione per la definizione confermata sopra è:

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

Importa i file mancanti e controlla il risultato

Dopo aver modificato lo schema, importa i file mancanti. Utilizza il percorso dell'applicazione, il nome del catalogo e l'account del servizio della tua installazione. La versione PHP deve corrispondere alla versione 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 aggiunge nuovi file multimediali. Non richiede la pulizia del catalogo, l'importazione di playlist o una nuova scansione dei tag dei file esistenti. Ampache può quindi aggiornare mappature e contatori interni.

Quindi aggiorna il plugin, apri tutti i titoli e controlla i titoli precedentemente mancanti. Poi i titoli sopra Tutti i titoli → seleziona tutto → cerca nel DB → aggiungi al database nel database di ricerca VirtualDJ. Vedi Cerca all'interno dei nodi dell'albero.

Funzionamento e aggiornamenti successivi

Si tratta di una modifica dello schema del database locale, non di una migrazione generale Ampache ufficialmente confermata. Dopo un aggiornamento del database Ampache, controllare nuovamente song.artist e l'importazione di file senza artisti della traccia: una migrazione potrebbe modificare la definizione. Lo script può essere controllato ripetutamente.

Per ripristinare NOT NULL, le voci NULL esistenti richiederebbero prima una gestione deliberata; la reimpostazione cieca della colonna non è un rollback appropriato. La correzione selezionata preserva gli artisti dei brani mancanti come informazioni mancanti.

Gonic 0.22.0: un album per cartella musicale

Sintomo e causa

Gonic richiede una cartella separata per ciascun album. Mantieni insieme i file di un album; non mischiare album diversi in una cartella. Una cartella condivisa per single non imparentati non soddisfa questo requisito. Gonic può quindi applicare i metadati dell'album del primo file, incluso l'artista dell'album, a tutti gli altri file in quella cartella.

Struttura delle cartelle consigliata

Anche per i brani singoli, crea una sottocartella per album, ad esempio «Einzeltitel/Alter Ego - Betty Ford (Bonus Remixes Version)» / «Einzeltitel/Homie Isback - Cherrymoon». Le due versioni di Cherrymoon possono condividere la cartella se appartengono allo stesso album. Tieni separate le pubblicazioni diverse. Colloca i file musicali nelle sottocartelle del percorso configurato: Gonic 0.22.0 ignora i file direttamente nella cartella principale.

Se più server condividono una libreria, è possibile creare una visualizzazione di cartelle separata per Gonic utilizzando collegamenti simbolici. Assegna anche lì a ogni album la propria cartella. Configura i percorsi musicali in modo che ogni traccia venga indicizzata una sola volta. L'account di servizio Gonic deve accedere sia ai collegamenti che alle relative destinazioni.

Controllo dopo la modifica

Effettua nuovamente la scansione completa di Gonic, quindi aggiorna l'elenco delle tracce del plugin. Controlla i totali, il raggruppamento degli album, i nodi degli artisti e la riproduzione. Le modifiche ai percorsi di importazione possono creare nuovi ID server, quindi controlla successivamente i preferiti, le playlist e le impostazioni VirtualDJ esistenti. Se necessario, registrare nuovamente le tracce. Aggiungi al database di ricerca VirtualDJ. I singoli brani appena aggiunti devono essere forniti anche nella struttura delle cartelle dell'album appropriata.

Fornire playlist basate su file per l'utente

Gonic legge le playlist dal suo configurato playlists-path e una sottocartella denominata in base all'ID utente numerico. Inserisci lì i file M3U/M3U8 con i percorsi multimediali risolti per Gonic. Una normale scansione musicale non importa automaticamente le playlist da altre cartelle della libreria. La nostra configurazione crea viste derivate senza modificare gli originali condivisi. Aggiorna queste visualizzazioni dopo aver modificato le origini.

Documentazione del progetto Gonic

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

Aggiungi le seguenti mappature per BPM e chiave. I file musicali devono contenere i tag BPM e KEY o INITIALKEY corrispondenti. Mantieni le mappature esistenti come PERFORMER.

Linee aggiuntive: 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	chiave	upnp:key
ffmpeg	chiaveiniziale	upnp:initialKey

Per un'installazione basata su XML, aggiungere le voci in import → opzioni libreria → id3 → metadati e ffmpeg → metadati. Gerbera etichetta il gruppo XML id3 come taglib Library Options nella sua interfaccia web. Imposta charset su UTF-8 in entrambe le librerie; mantenere o impostare anche filesystem-charset, metadata-charset e playlist-charset su UTF-8. Salva e riavvia Gerbera. Ulteriori mappature dei tag diventano effettive quando i file vengono nuovamente importati; una normale scansione potrebbe ignorare i file non modificati. Per una nuova installazione, configura queste opzioni prima di importare la musica.

MP4, M4A e M4V: preferiscono il tag BPM più preciso

Disponibile dalla build Git 3.3.0-77: L'estensione BPM Gerbera-PR #3993 è stato unito ed è incluso nell'immagine ufficiale. Una precisione maggiore è facoltativa e deve essere abilitata con prefer_highest_bpm_accuracy="yes" essere acceso. Senza questo attributo rimane no l'impostazione predefinita.

L'attributo MP4 tmpo contiene un numero intero. Inoltre, un tag iTunes BPM aggiuntivo può contenere un valore più preciso. Nell'elemento XML esistente import → library-options → id3 è possibile attivare la sua preferenza; mantieni le mappature dei tag esistenti:

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

Se mancante prefer_highest_bpm_accuracy o se è impostato su no, viene mantenuto il comportamento precedente. Per yes Gerbera legge tmpo e il tag aggiuntivo BPM separatamente. Se la distanza è inferiore a 1 BPM, viene acquisito ad es. il valore della variabile 123,5 invece 123. Se i valori differiscono di almeno 1 BPM, la selezione è determinata da prefer_ambigous_bpm_value: tmpo preferisce il numero intero, bpm_tag l'etichetta aggiuntiva. Se il secondo attributo è assente, bpm_tag. La notazione degli attributi è esplicita prefer_ambigous_bpm_value.

Per questa selezione sono validi solo i numeri positivi finiti; utilizzare un punto decimale nel tag del file. Se solo una fonte è valida, viene utilizzata. I valori di metà tempo o doppio tempo non vengono corretti automaticamente. Altri tag, generi, tonalità e copertine vengono letti come prima. Riavviare Gerbera dopo aver modificato la configurazione e reimportare i file interessati; una normale scansione potrebbe ignorare i file non modificati.

AIFF: BPM, chiave e lettura di più generi

Se nei file AIFF manca BPM o la chiave nonostante i tag ID3 esistenti, in Gerbera Config → Esperto → Importa → Mappature → Mimetype-Contenttype la mappatura del tipo MIME riconosciuto al tipo di contenuto aiff supplemento. Per audio/x-aiff e audio/aiff ciascuno aiff entrare. Ciò consente a Gerbera di utilizzare il lettore TagLib corrispondente; sono ancora necessarie le mappature BPM/tasti della tabella precedente.

Nella configurazione XML, le seguenti righe nella sezione esistente import → mappings → mimetype-contenttype con le seguenti integrazioni, mantenendo le mappature esistenti:

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

Riavvia Gerbera o il suo contenitore e importa nuovamente i file interessati. Una normale scansione potrebbe ignorare i file non modificati; non sono necessarie modifiche alla ridenominazione o al timestamp.

OGV: adotta tag dalle tracce audio e video

Con OGV titolo, artista, album, genere, BPM e chiave possono trovarsi nelle singole tracce audio e video. Attiva in Gerberas Configurazione → Esperto → Library Options → ffmpeg Library Options l'opzione streams-enabled. Questo è disponibile nella configurazione XML import → library-options → ffmpegelemento, l'attributo streams-enabled="yes" mettere; Conserva gli attributi esistenti e le assegnazioni dei tag.

Riavvia Gerbera o il suo contenitore, quindi reimporta i file OGV esistenti. Le mappature BPM/tasti nella tabella sopra sono ancora necessarie. Senza l'analisi dei metadati del flusso abilitata, questi valori potrebbero essere assenti nonostante i tag dei file salvati correttamente.

WebM e WMV: adotta più generi con il lettore giusto

Da quando Git ha creato 3.3.0-62 e anche in quello attuale 3.3.0-77 può leggere più tag di genere da WebM e WMV. Gli aggiornamenti mantengono la configurazione esistente, pertanto le mappature dei lettori aggiunte nella nuova build potrebbero ancora mancare. Dentro Config → Esperto → Importa → Mappature → Mimetype-Contenttype Aggiungi le seguenti mappature o nella sezione XML esistente import → mappings → mimetype-contenttype inserisci:

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

Mantieni le mappature esistenti e le impostazioni BPM/tasto, riavvia Gerbera e reimporta i file interessati. Ciò cambia il lettore di metadati utilizzato, non il tipo MIME del video restituito. I file non necessitano di conversione o ridenominazione. La base è la Mappature predefinite di questa versione sorgente Gerbera.

Rileva automaticamente le modifiche a file e attributi

Inotify rileva gli eventi del file system. inotify-attrib="yes" monitora inoltre le modifiche agli attributi, inclusi i timestamp modificati al tocco. Per un'installazione Linux, estendere la sezione di scansione automatica esistente in /etc/gerbera/config.xml preservando il percorso musicale:

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

Quindi utilizzare il servizio Linux systemctl restart gerbera riavviare.

Notifica nel contenitore ufficiale Gerbera

L'immagine ufficiale abilita già Inotify per la cartella musicale montata, ma il monitoraggio aggiuntivo degli attributi è inizialmente disabilitato. Usa Inotify e monitora le modifiche agli attributi Inotify vengono visualizzate in Gerbera Config → Esperto → Importa, ma non possono essere modificate tramite quella vista nell'immagine selezionata. Le impostazioni vengono memorizzate in /var/run/gerbera/autoscan.xml.

Su QNAP, apri gerbera-qnap in Container Station e avvia il suo terminale o console. Su Synology, seleziona gerbera-synology in Container Manager, apri il suo terminale e avvia /bin/sh.. Esegui il seguente comando all'interno del contenitore.
Inserisci il blocco seguente. Completa l'attributo e mostra il file di scansione; Il percorso musicale e le impostazioni esistenti vengono mantenuti.

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

L'output deve mostrare la scansione automatica con inotify-attrib="yes". Riavviare il contenitore, quindi verificare che Monitor Inotify Attribute Changes sia selezionato in Gerbera Config. Se manca autoscan.xml, identificare prima il file di configurazione effettivamente in uso. Questo comando si applica alla build ufficiale specificata nelle guide NAS.

I tag di genere separati non necessitano di impostazioni aggiuntive. MusicServer Connect utilizza tutti i campi di genere forniti da UPnP. A partire dalla versione 1.5, anche i generi combinati separati da punto e virgola o barre vengono assegnati alle rispettive visualizzazioni di genere individuali. I tag del server e dei file rimangono invariati.

Fonti: Gerbera scansione automatica e monitoraggio degli attributi, Configurazione iniziale dell'immagine ufficiale del contenitore.

Gerbera 3.3.0-77: nomi di titoli puri nei risultati di ricerca

Gerbera combina M_ARTIST e M_TITLE per i titoli dei brani nelle risposte di ricerca UPnP per impostazione predefinita. MusicServer Connect viene importato tramite quell'interfaccia, quindi "Speedy J - Electric Deluxe" appare nella colonna del titolo anche se il tag del file TITLE contiene solo "Electric Deluxe".

In server → upnp, configura search-item-result per utilizzare solo M_TITLE. extend="no" sostituisce l'elenco predefinito invece di aggiungere voci:

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

Il Script di configurazione gerbera-suchtitel.py imposta questa opzione in una configurazione XML esistente. Il percorso predefinito è /etc/gerbera/config.xml; è possibile fornire un altro percorso come argomento. Gli spazi dei nomi, i commenti e altre impostazioni esistenti vengono conservati. Se la struttura del server è ambigua, lo script si ferma prima della scrittura.

In alternativa nell'interfaccia web di Gerbera all'indirizzo Config → Server → UPnP → Risultato dell'elemento di ricerca l'entrata M_ARTIST rimuovere e solo M_TITLE per trattenerlo. Controlla le impostazioni già salvate nell'interfaccia web, poiché potrebbero sovrascrivere i valori XML. Questa impostazione si applica anche a Gerbera 3.3. L'artista rimane disponibile come campo di metadati separato.

Riavvia Gerbera e ricarica la connessione del plugin. Questa impostazione modifica i titoli delle tracce nei risultati di ricerca; non sono necessarie modifiche a plug-in o file musicali. Controlla anche la visualizzazione dei brani già memorizzati in VirtualDJ. Il rilevamento artista FRITZ!Box opzionale è indipendente da questa impostazione.

Gerbera: visualizzazioni e importazione della playlist

Perché la stessa playlist appare più volte

Gerbera può mostrare la stessa playlist sia in Playlist → Tutte le playlist che in Playlist → Directory. Ciò non significa che il file della playlist esista più di una volta.

MusicServer Connect combina visualizzazioni di playlist identiche. Se i loro contenuti differiscono o una query è incompleta, potrebbero rimanere visibili più visualizzazioni.

Controlla le importazioni di playlist incomplete

Controlla le voci della playlist. I percorsi relativi si riferiscono alla loro cartella.
Verifica che tutti i file musicali di riferimento esistano e siano leggibili dall'account di servizio di Gerbera.
Leggi di nuovo la playlist dopo le modifiche. Se l'importazione è incompleta, riavvia il servizio Gerbera e attendi la scansione.
Quindi aggiorna la visualizzazione nel plug-in e controlla la playlist.

Per rilevare automaticamente le modifiche ai timestamp dei file, utilizzare Monitoraggio degli attributi Inotify attivare.

Riferimenti a playlist deprecate e set di caratteri M3U

Controllare nuovamente il contenuto delle playlist dopo modifiche ai file multimediali referenziati. Una normale nuova scansione può lasciare invariate le viste esistenti. Aggiornare quindi la libreria in MusicServer Connect. Gli identificativi del catalogo possono cambiare.

Per condividere gli stessi file di playlist con MinimServer, salviamo M3U con Windows-1252 e M3U8 con UTF-8. L'importatore standard di Gerbera nella build testata 3.3.0-77 non ha risolto correttamente il percorso dieresi dello Windows-1252-M3U. Il Scarica l'estensione di importazione M3U verificata e salvarlo nella directory dello script personalizzato configurata. Rileva UTF-8 valido nelle linee M3U e altrimenti utilizza Windows-1252. Le playlist M3U8, PLS e XML continuano a utilizzare l'importatore standard. Conserva gli script personalizzati esistenti.

Nella configurazione Gerbera esistente sotto import/scripting/import-function il nome della funzione della playlist da importPlaylist su mscImportPlaylist cambiare. Sotto import/scripting/script-folder/custom La directory configurata deve contenere il file scaricato ed essere archiviata in modo permanente per le installazioni del contenitore. Al banco di prova è inferiore /var/run/gerbera/custom-js. Quindi riavvia Gerbera e importa nuovamente i record della playlist. L'estensione richiede l'importatore JavaScript.

MiniDLNA / ReadyMedia 1.3.3: estensioni dei file della playlist

MiniDLNA 1.3.3 riconosce le playlist con .m3u e .pls. I file con .m3u8 non vengono letti.

Raccomandazione: rinominare M3U se possibile

Se nessun'altra applicazione o configurazione del server dipende dal nome file M3U8 corrente, modificare l'estensione da .m3u8 a .m3u. Questa è la soluzione più semplice per MiniDLNA. Mantieni invariati i contenuti, la codifica UTF-8 e la posizione in modo che i percorsi musicali relativi continuino a funzionare. Aggiorna eventuali riferimenti al nome del file della playlist. Quindi chiedi a MiniDLNA di importare nuovamente la playlist e aggiornare il plug-in.

Alternativa: conservare una sorgente M3U8 condivisa

Se altri server necessitano del file M3U8, crea un file M3U aggiuntivo per MiniDLNA. Se si trova in una cartella diversa, regola i percorsi musicali relativi o utilizza percorsi assoluti.

Il Script di installazione minidlna-playlist-view.py controlla origine e destinazione, crea lo M3U derivato e aggiunge media_dir=A,/media3 alla configurazione esistente di MiniDLNA. Non modifica l'origine M3U8 o le voci media_dir esistenti. In caso di conflitto di destinazione, si ferma. Ricarica MiniDLNA e aggiorna il plugin. Dopo aver modificato la playlist di origine, esegui lo script e riavvia nuovamente MiniDLNA per mantenere aggiornata la vista derivata. Non è installato alcun osservatore delle modifiche.

Autorizzazioni della cache durante la ricostruzione

Se MiniDLNA non riesce a pulire la cover cache durante la ricostruzione, controlla i permessi di scrittura sulla cache e sulle sue sottodirectory.

Per le altre installazioni, identificare innanzitutto l'account di servizio effettivo e il percorso della cache configurato. Dopo aver ricostruito la libreria, aggiorna il plugin. Se necessario, registrare nuovamente l'elenco completo dei brani utilizzando “Ricerca DB → Aggiungi al database”.

Condividi audio e video

Una condivisione con media_dir=A,/srv/music è limitato all'audio. Per entrambi i tipi di media, apri questa riga esistente media_dir=AV,/srv/music modificare, ottenere ulteriori approvazioni e riavviare il servizio. I limiti di codec e metadati rimangono indipendenti da ciò.

Serviio 2.5: rilascio delle visualizzazioni richieste

Per avere a disposizione gli artisti degli album e l'ordine degli album originali, visualizza le categorie richieste nella console Serviio.

Ordine dei brani

Per l'ordine dei brani originale, apri un singolo album. Un ordinamento di colonne selezionato in VirtualDJ può modificare l'ordine visibile.

Nella console Serviio in Presentazione → Audio, imposta Musica, Album, Titoli e Playlist su "Visualizza categoria". Altre categorie audio possono utilizzare "Visualizza solo contenuto". La visualizzazione dell'album deve essere disponibile per la query supplementare. Non sono necessarie modifiche ai file musicali.

Diversi artisti degli album salvati

Se i metadati dell'album o dell'artista di Serviio differiscono dai tag del file, rileggi i metadati sul server, quindi aggiorna il plug-in.

Se sono presenti più tag di genere, viene adottato solo il primo.

Se un file ha più tag di genere, viene utilizzato solo il primo. I generi rimanenti mancano dai metadati restituiti e dall'albero dei generi. Questa limitazione di compatibilità non è specifica per un formato di file.

Twonky Server 8.5.2: recupero completo di traccia e album

Quando rileva la struttura Twonky, MusicServer Connect utilizza la visualizzazione completa della traccia nativa e dell'album. Nei nostri controlli, la ricerca globale del server ha omesso sette tracce accessibili sotto W e Y. Anche il fallback automatico recupera queste tracce e preserva l'ordine degli album. Non è necessaria alcuna impostazione aggiuntiva del plug-in. Le pagine native incomplete o incoerenti vengono comunque rifiutate.

Il controllo di follow-up ha riguardato i file multimediali 149 (audio 139, dieci video) e tutte le visualizzazioni offerte senza errori di recupero. Il supporto, i formati e i metadati mancanti per ASX/XSPF rimangono limitazioni del server. Twonky potrebbe richiedere l'accesso di un nuovo fornitore dopo il riavvio; un avviso di accesso non è un catalogo musicale.

Universal Media Server 15.8.2: servizio Linux e visualizzazione dell'album

Per un servizio Linux, impostare l'ambiente su UTF-8 in modo che i percorsi musicali contenenti dieresi e altri caratteri Unicode possano essere elaborati.

Con systemctl edit DIENSTNAME.service Configura la seguente aggiunta per il tuo servizio UMS. Dopodiché systemctl daemon-reload Esegui, riavvia questo servizio e attendi la scansione della libreria.

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

La locale C.UTF-8 deve essere disponibile sul sistema. L'impostazione di Java file.encoding da sola non sostituisce la locale utilizzata per i nomi dei file. Un comando Java lanciato da una shell interattiva può utilizzare impostazioni diverse dal servizio in esecuzione.

L'accesso diretto alla cartella musicale su Linux evita le restrizioni di condivisione Windows sui nomi dei file, come i nomi contenenti un punto interrogativo.

Artisti degli album e ricerca nel database

Per informazioni complete sull'artista dell'album in UMS.conf, attiva la ricerca nel database integrata e riavvia UMS:

search_lucene_use_engine = false

L'impostazione sostituisce la ricerca full-text di Lucene con la ricerca nel database integrata.

Ordine dell'album originale

Per l'ordine dei brani originale, apri un singolo album. Un ordinamento di colonne selezionato in VirtualDJ può modificare l'ordine visibile.

UMS combina più tag di genere in un unico testo separato da "/". MusicServer Connect crea da esso nodi di genere individuali; la traccia appare sotto ogni genere elencato. Trattare con più generi.

File ASX e ricerca nel catalogo incompleta

UMS 15.8.2 può contare i file della playlist ASX come cartelle video senza restituire gli oggetti corrispondenti. La ricerca audio può anche annunciare più corrispondenze di quelle restituite e può omettere OGG dalle ricerche di classi audio. MusicServer Connect rileva queste incoerenze e integra il catalogo utilizzando cartelle di file reali. La raccolta selezionata di file audio 141 e dieci file video viene visualizzata per intero, mantenendo gli ID audio e i metadati esistenti. Non è necessaria alcuna impostazione aggiuntiva.

Il plugin scopre sottocartelle reali indipendentemente dalla ricerca SQL incompleta. Le pagine di ricerca precedentemente controllate vengono utilizzate solo per mappare gli alias. Confronta due inventari di file completi prima di accettarli e controlla nuovamente le modifiche allo stato di ricerca. Non attraversa combinazioni di filtri virtuali. Se una futura versione di UMS fornisce risultati di ricerca completi con classi multimediali corrette, il plugin utilizza nuovamente automaticamente quella ricerca diretta. I file sorgente della libreria rimangono invariati.

Questo fallback non ripara i metadati del server o le voci della playlist mancanti: ASX, WPL e XSPF sono ancora assenti come visualizzazioni della playlist. UMS ha omesso la prima traccia dai vecchi elenchi M3U/PLS controllati qui. I tre elenchi in formato misto, tuttavia, contengono tutte e sei le posizioni, comprese le voci audio e video ripetute.

Conversione audio e streaming WAV

UMS può transcodificare l'audio in 16-bit WAV a seconda del profilo del client. Quattro campioni contenevano audio completo nel controllo di follow-up, sebbene le lunghezze WAV illimitate non abbiano superato la rigorosa convalida del file. La decodifica normale e il confronto dopo la normalizzazione su 16-bit sono riusciti. Ciò non dimostra la conservazione della risoluzione 24-bit originale. Le richieste di intervallo molto piccolo potrebbero risultare vuote durante la conversione; i download normali e le richieste KiB 64 hanno funzionato.

Nascondi la cartella di transcodifica aggiuntiva

show_transcode_folder = false nasconde la cartella virtuale per impostazioni di transcodifica alternative. La transcodifica stessa e i tag multimediali salvati vengono conservati. Questa opzione di visualizzazione da sola non risolve i conteggi di pagine UPnP incoerenti.

MinimServer: BPM/Aggiornamento chiave e libreria

Leggi BPM e chiave dai file musicali

Per fornire tag aggiuntivi è necessaria una licenza MinimServer completa o di prova. I file musicali devono contenere i tag BPM e KEY o INITIALKEY.

Nella pagina di configurazione MinimServer, apri Proprietà.
Sotto itemTags i nomi BPM,KEY,INITIALKEY supplemento. Mantieni le voci esistenti; i tag devono corrispondere ai tuoi file musicali. KEY e INITIALKEY considerare: il campo MP3 TKEY viene trattato da MinimServer come INITIALKEY viene letto.
Salvare le modifiche ed eseguire il riavvio del server richiesto.
Eseguire una nuova scansione in Stato. Quindi aggiorna la libreria in MusicServer Connect.

Ulteriori informazioni: MinimServer: metadati aggiuntivi e Ambito della licenza. Advanced Mode di WiiM è una funzionalità dell'app WiiM; i requisiti di licenza completi qui riguardano i metadati aggiuntivi del server.

I valori già memorizzati in VirtualDJ possono rimanere dopo una modifica. Per rileggere i tag BPM/key incorporati, selezionare le tracce interessate e scegliere "Leggi BPM e key dal file musicale" nel menu contestuale. Per una nuova analisi audio, utilizzare "Analizza BPM e tag"; con più tracce selezionate, questa azione si trova in "Batch".

Rileggere dopo le modifiche

Eseguire nuovamente la scansione di MinimServer dopo aver modificato file musicali, tag o orari di modifica. Apri la sua pagina di configurazione, scegli la scheda Stato e fai clic su Nuova scansione. Aggiorna lo stato finché non riporta "In esecuzione", quindi aggiorna MusicServer Connect. Il riavvio da solo di MinimServer generalmente non attiva una nuova scansione.

Un indice di un server obsoleto può restituire segnaposto "Elemento modificato o eliminato" senza metadati di traccia o file audio. Questi segnaposto potrebbero comunque essere inclusi nel totale segnalato. Il plug-in mostra quindi meno tracce utilizzabili, sebbene gli artisti degli album e gli album rimangano noti dai contenitori del server esistenti.

Vedi Pagina di configurazione MinimServer ed eseguire nuovamente la scansione così come API web ufficiale per le nuove scansioni automatizzate.

Combina un album da più cartelle

Se i brani dello stesso album si trovano in più cartelle, MinimServer può fornire più album con lo stesso nome. L'impostazione in Proprietà mergeFolderAlbums su true al valore indicato, salvare e riavviare MinimServer. Il nome dell'album e l'artista dell'album devono corrispondere. Questa impostazione si applica all'intera libreria e può anche combinare altri album corrispondenti da più cartelle. I file multimediali rimangono invariati.

Nel nostro controllo, questo ha combinato "MSC Format Tests 1.3" dalle sottocartelle Audio e Video in un unico album con brani 13 riconosciuti da MinimServer. In precedenza i due gruppi contenevano undici e due brani. Quindi apri il server in WiiM Home e … → Nuova scansione del server musicale per aggiornare l'indice dell'app. L'etichetta potrebbe variare in base alla lingua dell'app. Successivamente, WiiM Home ha mostrato solo una copia dell'album di esempio nel nostro controllo.

Vedi MinimServer: album e cartelle e WiiM Home: leggere nuovamente il catalogo multimediale.

M3U/M3U8: set di caratteri e voci mancanti

MinimServer si aspetta .m3u con Windows-1252 o ISO-8859-1 e .m3u8 con codifica UTF-8. Un file UTF-8 con estensione .m3u può quindi omettere le tracce i cui percorsi contengono caratteri accentati. Utilizzare M3U8 per percorsi Unicode. Se è necessario anche M3U, salva una copia separata nella codifica appropriata. Non sostituire i caratteri che questa codifica non può rappresentare.

Nella raccolta selezionata, una nuova scansione ha riparato il riferimento obsoleto a "Betty Ford" precedentemente restituito come "Elemento modificato o eliminato" senza audio utilizzabile. La corretta codifica Windows-1252 dell'ulteriore Sven Väth M3U ha ripristinato anche il riferimento al percorso accentato a "W.I.R." Entrambi gli elenchi hanno quindi fornito tutte e quattro le tracce nell'ordine di origine, senza una ricostruzione completa del catalogo. Gli elenchi in formato misto fornivano cinque delle sei posizioni, comprese le ripetizioni; MKV è rimasto escluso perché il formato non è supportato.

Dopo la nuova scansione, aggiorna la libreria nel plugin. Fonte: MinimServer: formati di playlist e set di caratteri.

JRiver: importa playlist e consenti l'accesso in lettura

Importa playlist nella libreria JRiver. Se l'importazione automatica della musica salta una playlist, importala separatamente, quindi aggiorna la visualizzazione del plug-in.

La scrittura tramite l'interfaccia del servizio Web di JRiver richiede l'abilitazione dell'autenticazione. L'accesso in lettura anonimo deve rimanere consentito: MusicServer Connect lo utilizza per distinguere le playlist normali da quelle intelligenti. L'accesso in lettura non concede l'autorizzazione alla modifica della playlist.

Puoi mostrare o nascondere playlist intelligenti nel plug-in. I contenuti nascosti della playlist intelligente non sono richiesti durante la creazione dell'albero; vengono caricati quando li mostri. Gli elenchi vuoti e gli elenchi senza tracce audio non vengono visualizzati come playlist musicali.

Synology: imposta il server multimediale predefinito

Il server standard di Synology supporta WiiM Home Advanced Mode. Per MusicServer Connect è sufficiente anche che VirtualDJ calcoli BPM e si chiami da solo. Per i valori BPM/chiave memorizzati, è possibile utilizzare Gerbera nel contenitore . Entrambi i server possono leggere gli stessi file musicali.

Installa Media Server nel Centro pacchetti e copia la tua libreria musicale nella cartella musicale condivisa. Un pool di archiviazione e un volume devono già esistere.

Impostazioni generali: lingua del menu DMA desiderata, stile del menu DMA Stile semplice; Lascia l'intervallo di reporting SSDP sul valore predefinito.
Impostazioni di ricerca: imposta il formato di visualizzazione della musica su "Solo titolo"; consentire file di copertina aggiuntivi con "Immagine di copertina per file audio/video" e mantenere i nomi di file predefiniti.
Compatibilità DMA: lascia disattivati la transcodifica audio e i tipi MIME personalizzati. Consentire l'accesso ai dispositivi desiderati.
Dopo la copia, espellere in modo sicuro la memoria USB. Le cartelle degli album, dei singoli brani e delle playlist si trovano direttamente sotto la musica.

Il server multimediale Synology combina più tag di genere in un unico valore separato da ";". MusicServer Connect crea nodi di genere individuali, quindi ogni traccia appare sotto ogni genere elencato. Trattare con più generi.

Salva playlist con l'estensione .m3u. In File Station, rinominare un file .m3u8 in Musica/Playlist in .m3u, mantenendo il contenuto UTF-8 e i relativi percorsi. Se altri server necessitano di M3U8, crea una copia M3U separata.

FRITZ!Box: formati audio e artisti delle tracce

Configura il server multimediale

Collegare l'archivio USB contenente la libreria musicale. Nell'interfaccia FRITZ!Box, abilitare Media Server in Rete domestica → Media Server, selezionare l'archivio USB come sorgente multimediale e applicare. Crea o aggiorna l'indice dei file in Rete domestica → USB/Archiviazione o Archiviazione (NAS) e attendi l'indicizzazione. Quindi selezionare il server multimediale FRITZ!Box in MusicServer Connect.

Formati audio e metadati

FRITZ!Box può eseguire lo streaming di molti formati audio ma legge solo alcuni dei loro tag. Senza il supporto dei tag, dall'albero della libreria mancano l'artista dell'album, l'album e il genere. Con il rilevamento dell'artista della traccia abilitato, MusicServer Connect può derivare un artista dai nomi nel modello "Artista - Nome della traccia". I file rimangono accessibili tramite Tutte le tracce, cartelle e playlist supportate.

Valutazione dei tag secondo la tabella dei formati FRITZ!Box
Formati audio	Lettura dei cartellini
MP3, WMA, ASF	Sì; nessuna garanzia di tutti i singoli campi di metadati.
FLAC	No
AAC, M4A	No
WAV, AIF/AIFF, LPCM	No
Ogg Vorbis, APE, WavPack, MPC	No
3GP, AC3, MKA, MPA, MP1, MP2, Audio reale, Karaoke CDG/BIN	No

Per MP3/WMA, la documentazione del fornitore elenca titolo, artista, album, genere, numero di traccia e ID3 v2.3 o precedente. Artista dell'album, BPM e chiave non sono pertanto confermati come campi supportati. VirtualDJ o il lettore devono supportare il formato audio per la riproduzione.

Raccomandazione: utilizzare artisti della traccia

Per le librerie con FLAC o altri formati senza valutazione dei tag, anche se combinati con MP3, la vista Artista del brano se i nomi dei file seguono lo schema “Artista - Nome del titolo” corrispondere. Per farlo prima nel menu contestuale della sorgente MusicServer Connect "Determina l'artista del titolo dai nomi dei file" accendere. Quindi seleziona "Mostra artisti" e "Passa agli artisti del titolo" se questa visualizzazione non è già attiva.

Questo rilevamento è disabilitato per impostazione predefinita per le nuove connessioni al server e viene salvato per ogni connessione. Per disattivarlo, scegli "Disabilita rilevamento artista traccia dai nomi file" nello stesso menu. Lascialo disabilitato se i nomi dei file non seguono "Artista - Nome traccia": il plugin non può determinare se il testo prima di un trattino è un artista o parte del titolo.

Quando il rilevamento è abilitato, manca l'artista e il nome corrisponde allo schema, MusicServer Connect si divide al primo “-”. Ad esempio, "1st Bass - Slam Me Down" diventa artista "1st Bass" e titolo "Slam Me Down". Ulteriori trattini rimangono nel titolo; i metadati degli artisti esistenti hanno la priorità. Se disabilitata, questa suddivisione non viene eseguita e il titolo fornito dal server rimane invariato a questo scopo. Il rilevamento del remix è un'impostazione separata.

Quando si cambia, MusicServer Connect aggiorna anche la visualizzazione dei titoli salvati se il titolo e l'artista corrispondono ancora a una delle due varianti generate dal plug-in. Le altre modifiche manuali vengono conservate. Questo interruttore non modifica i valori BPM, chiave, remix o analisi.

Questo rilevamento riempie il campo dell'artista e la visualizzazione dell'artista della traccia. Non sostituisce i tag album, album-artista o genere. Se la tua libreria contiene solo MP3, WMA o ASF, è possibile utilizzare i tag forniti dal server e la visualizzazione dell'artista della traccia non è necessaria come fallback. La visualizzazione dell'artista dell'album è utile solo se il server fornisce effettivamente le informazioni richieste.

Per i formati i cui tag non vengono letti, FRITZ!Box non può nemmeno fornire i valori BPM/chiave memorizzati. VirtualDJ può calcolarli da solo. Per una navigazione completa della libreria basata su tag, utilizza un server musicale che supporti i metadati per i tuoi formati.

Playlist

Utilizzare M3U o PLS. WPL è riconosciuto ma può omettere le tracce, quindi scegli M3U o PLS per elenchi completi affidabili. M3U8, ASX e XSPF non sono riconosciuti come playlist. Mantieni il contenuto UTF-8 e i relativi percorsi musicali validi. MusicServer Connect rimuove l'estensione del file e il nome della cartella aggiunta dal nome della playlist visualizzata.

Documentazione del produttore: Formati audio, lettura di tag e formati di playlist, Ordinamento e versioni di tag così come Configura il server multimediale e crea l'indice dei file.

QNAP: esegue il server multimediale standard e Gerbera in parallelo

Il componente aggiuntivo di streaming multimediale standard di QNAP supporta WiiM Home Advanced Mode. Per MusicServer Connect è sufficiente anche se VirtualDJ calcola BPM e l'ordine della chiave e della playlist errato è accettabile. È possibile utilizzare BPM/valori chiave memorizzati, generi separati e ordine corretto della playlist Gerbera con stazione container essere integrato.

Installa la console multimediale e il componente aggiuntivo per lo streaming multimediale nell'App Center. Posiziona le cartelle musicali in Pubblico/musica. In Console multimediale → Gestione contenuti, seleziona Componente aggiuntivo streaming multimediale e aggiungi Pubblico/musica come fonte di contenuto.

Indicizzazione: Abilita Info Multimediali; Priorità normale. Per la libreria UTF-8, selezionare UTF-8 se offerto, altrimenti lasciare l'impostazione predefinita.
Apri le impostazioni del componente aggiuntivo Media Streaming separatamente. Seleziona il tuo account utente NAS e l'interfaccia di rete appropriata; utilizzare la porta predefinita 8200.
In DLNA Media Renderer, consentire l'accesso al PC o al client desiderato.
In Impostazioni di navigazione, imposta Stile menu predefinito su Tutte le categorie. In DLNA Media Renderer, seleziona anche Tutte le categorie e il tuo profilo utente per il client. Applica entrambe le modifiche.
Interrompi e avvia il componente aggiuntivo Media Streaming nell'App Center. Successivamente verificare nuovamente la versione del dispositivo e, se necessario, impostarla nuovamente.
Le playlist sono disponibili come M3U, PLS o WPL; M3U8 non è supportato. Utilizza UTF-8 e percorsi relativi validi. L'ordine delle tracce rimane errato in tutti e tre i formati.

I nomi di file contenenti un punto interrogativo possono causare problemi se copiati tramite Windows/SMB. Copiare i file interessati direttamente dall'archivio USB nella cartella musicale appropriata utilizzando QNAP File Station.

Per l'ordine degli album, conserva la musica di ciascun album in una cartella. Per più dischi, utilizzare sottocartelle come CD 1 e CD 2, con numeri di traccia positivi e univoci. QNAP utilizza solo il primo genere. L'ordine della playlist rimane errato con M3U, PLS e WPL; il passaggio da uno all'altro non risolve questo problema.

Aggiungi Gerbera per MusicServer Connect

Continua a utilizzare la libreria esistente in Pubblico/musica e Gerbera dopo seguendo le istruzioni passo passo . Quindi connettiti all'URL del dispositivo Gerbera nel plug-in e controlla tracce, tag e ordine. Mantieni il componente aggiuntivo Media Streaming in esecuzione per WiiM Home Advanced Mode o altri dispositivi, selezionando lì il server standard di QNAP. Usa Gerbera in MusicServer Connect per BPM/tasto e correggi l'ordine della playlist. Se WiiM Home necessita anche di playlist affidabili dallo stesso server, MinimServer è una soluzione condivisa adatta. Entrambi i servizi leggono gli stessi file musicali.

Note del venditore: Formato M3U, UTF-8 e relativi percorsi così come Condivisione manuale del dispositivo nel componente aggiuntivo per lo streaming multimediale.

QNAP: imposta Gerbera con la correzione WavPack passo dopo passo

Gerbera è un software server multimediale aggiuntivo per il tuo QNAP. Il vantaggio principale per MusicServer Connect è l'accesso ai valori già memorizzati nei file musicali: BPM e metadati delle chiavi musicali: Il server multimediale UPnP integrato di QNAP non fornisce queste informazioni. I passaggi seguenti configurano le mappature dei metadati richieste.

Il supporto della playlist può anche parlare di Gerbera: Il server UPnP standard QNAP qui descritto non visualizza le playlist M3U8. Per i formati M3U, PLS, ASX e WPL riconosciuti non conserva l'ordine delle tracce. La ridenominazione di M3U8 in M3U pertanto non risolve l'ordine. Gerbera è un'alternativa se hai bisogno di M3U8 o dell'ordine di riproduzione esatto.

Quando non hai bisogno di Gerbera? Se i tuoi file non hanno valori BPM/chiave memorizzati e l'ordine della playlist non è importante, non hai bisogno di Gerbera per questi scopi. VirtualDJ può calcolare BPM e la chiave musicale analizzando i file senza un server musicale. Puoi mantenere il server multimediale integrato di QNAP e lasciare che VirtualDJ li calcoli.

Il server multimediale di QNAP può continuare a funzionare insieme a Gerbera, ad esempio per WiiM Home Advanced Mode. Gerbera non supporta questa modalità WiiM. La tua musica rimane nella cartella esistente; Gerbera ottiene l'accesso in sola lettura. Questa guida consente inoltre il rilevamento automatico dei file nuovi e modificati.

Versione consigliata: Questa guida utilizza la build Git ufficiale Gerbera 3.3.0-77 dalla revisione del sorgente 245e723. L'immagine Docker è impostata con tag e checksum SHA-256; contiene le rettifiche già richieste WavPack e titoli di playlist ripetuti così come più generi in WebM/WMV e maggiore precisione BPM. Anche in caso di aggiornamento con configurazione esistente Aggiungi mappature dei lettori. Si tratta di uno stato di sviluppo secondo 3.3.0, non di una nuova versione stabile.

Gerbera 3.3.0 non è corretto durante l'importazione di WavPack: L'immagine 3.3.0 invariata può essere letta durante la lettura .wvfile. Nella build utilizzata qui, la memoria interessata viene allocata nell'heap. WavPack rimane completamente utilizzabile; non è richiesto alcuno script di patch aggiuntivo. Utilizza il riferimento immagine completo mostrato sopra.

1. Preparare cartelle, utenti e file

Accedi a QTS con un account amministratore attivo di cui conosci la password. Il conto integrato admin non deve essere attivato per questo; è sufficiente un altro account amministratore autorizzato.
Installa dentro Centro applicazioni l'applicazione Stazione container. Aprilo e completa la configurazione iniziale. La console multimediale e il componente aggiuntivo per lo streaming multimediale non sono necessari per Gerbera.
Crea sotto Pannello di controllo → Autorizzazione → Utenti → Crea l'utente gerbera . Questo utente non necessita dei diritti di amministratore. Concedigli l'accesso in lettura alla condivisione musicale, comprese le sue cartelle e file. Continua a utilizzare il tuo account amministratore per SSH.
Gli esempi utilizzano la cartella musica Public/music, sullo NAS /share/Public/music. Per un'altra condivisione, utilizza il tuo percorso effettivo. La tua musica esistente può rimanere lì. Rimuovi i caratteri illegali Windows come ? dai nomi dei file e, se necessario, regola i riferimenti alla playlist; i tag del titolo possono ancora contenere questi caratteri.
Crea dentro Stazione di archiviazione sotto Public la cartella gerbera-qnap e la sua sottocartella vuota empty .
Scarica il Componi il file come compose.yaml . Caricalo direttamente tramite File Station su Public/gerbera-qnap accanto alla cartella empty. Il nome del file deve compose.yaml senza un ulteriore .txt.

2. Abilita SSH e ottieni l'accesso root

Apri in QTS Pannello di controllo → Servizi file e rete → Telnet/SSH.
Abilita Consenti connessione SSH, lasciare il porto alle 22 e fare clic su Applicare. Se Modifica autorizzazioni di accesso viene offerto, consenti al tuo account amministratore di accedere lì. Se il firewall NAS è attivo, la porta SSH del tuo computer deve essere consentita nella rete locale.
Apri Terminale sul Windows-PC o PowerShell sul Terminale Mac. Sostituisci nel comando seguente DEIN_QTS_KONTO tramite il tuo account amministratore e NAS_IP con l'indirizzo IP QNAP.

ssh DEIN_QTS_KONTO@NAS_IP

Quando si stabilisce la connessione per la prima volta verificare l'indirizzo di destinazione visualizzato e confermare la richiesta con yes. Inserisci la password del tuo account QTS. Durante la digitazione non vengono visualizzati caratteri o asterischi. Da utilizzare se viene utilizzata una porta SSH diversa ssh -p PORTNUMMER DEIN_QTS_KONTO@NAS_IP.

Quindi passa ai diritti di root:

sudo -i
id

Se richiedi nuovamente la password, utilizza la stessa password dell'account QTS registrato. Non è necessaria una password di root speciale. L'uscita di id deve uid=0 incluso; su QNAP è presente il nome utente associato admin . Se viene visualizzato un menu di gestione, esci utilizzando l'opzione Shell o Esci. Lasciare il terminale aperto durante la configurazione: tutti i seguenti comandi del terminale vengono eseguiti sullo QNAP.

Determina gli ID dell'utente creato per l'accesso alla musica:

id gerbera

Se l'output mostra uid=1001(gerbera) gid=100(everyone) è UID 1001 e GID 100. Annota i tuoi numeri per il file di composizione.

3. Personalizza il file di composizione

Apri quello scaricato compose.yaml utilizzando un editor di testo, sostituisci i valori di esempio per UID e GID attraverso i numeri dal passaggio 2 e ricaricare il file salvato Public/gerbera-qnap alto. La mappatura musicale punta inizialmente alla cartella vuota. La musica esistente viene importata solo dopo la configurazione dei metadati.

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:

L'immagine ufficiale seleziona la variante ARM64 o AMD64 appropriata per i modelli NAS supportati. Il modello non contiene un indirizzo IP NAS fisso. --interface eth0 utilizza l'indirizzo di questa interfaccia di rete. Per i dispositivi con più porte, switch virtuali o raggruppamento di porte, sostituire eth0 attraverso l'interfaccia effettivamente utilizzata per la rete domestica. network_mode: host abilita il rilevamento UPnP nella rete NAS.

/mnt/content:ro rimane invariato come percorso contenitore e consente solo la lettura della musica. Il volume gerbera-data salva le impostazioni e il database in modo permanente. restart: unless-stopped riavvia il contenitore dopo un riavvio NAS se non è stato arrestato manualmente in precedenza.

4. Avvia l'applicazione con la libreria vuota

Aperto Container Station → Applicazioni → Crea. Usa il nome gerbera-qnap.
Aggiungi l'intero contenuto del tuo file personalizzato compose.yaml nel campo YAML. Mantieni i rientri con spazi e fai clic Convalidare.
Creare e avviare l'applicazione. Il primo download dell'immagine potrebbe richiedere del tempo. Aspetta finché gerbera-qnap viene mostrato come attivo.
Aperto http://NAS_IP:49494/ nel tuo browser. Un URL web mancante in Container Station non impedisce l'accesso diretto. In questa fase, la libreria Gerbera è intenzionalmente vuota.

5. Configura BPM, visualizzazione dei tasti e del titolo

Aperto a Gerbera Configurazione e scegli su Elenca la moda la vista Esperto. Sotto Library Options → taglib Library Options → metadati e sotto ffmpeg Library Options → Metadati le seguenti mappature. Conserva altre linee esistenti.

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	chiave	upnp:key
ffmpeg	chiaveiniziale	upnp:initialKey

Sotto Server → Nome il nome Gerbera QNAP un. In questo modo il server potrà essere successivamente distinto dagli altri server musicali.
Per AIFF di seguito Importa → Mappature → Mimetype-ContentType i due incarichi audio/x-aiff → aiff e audio/aiff → aiff supplemento. Senza queste assegnazioni, BPM, chiave e altri generi potrebbero mancare nonostante i tag esistenti. Configurazione AIFF.
Per OGV di seguito ffmpeg Library Options l'opzione streams-enabled Attivalo in modo che i tag vengano letti dalle tracce audio e video. Configurazione OGV.
Imposta il campo per taglib e ffmpeg charset su UTF-8. Inoltre filesystem-charset, metadata-charset e playlist-charset dovrebbe UTF-8 utilizzare.
Sotto UPnP → Elemento risultato titolo svuota il campo con M_ARTIST e ricevere M_TITLE. Questo fornisce il semplice titolo della traccia.
Sotto WavPack Library Options rimane Abilitato acceso.
Fare clic su Salva configurazione, riavviare il contenitore vuoto in Container Station e dopo aver riaperto la configurazione verificare che i valori siano salvati.

BPM e Key devono essere già salvati nei file musicali; Gerbera non calcola questi valori. Per MP4/M4A/M4V in quello esistente id3elemento prefer_highest_bpm_accuracy="yes" e prefer_ambigous_bpm_value="bpm_tag" secondo Configura la precisione BPM ai valori indicati. Senza la prima opzione viene mantenuto il comportamento precedente. Una normale nuova scansione potrebbe ignorare i file che sono già stati importati e non sono stati modificati. Configura queste opzioni prima di importare la musica per la prima volta. I tag di genere separati non necessitano di impostazioni aggiuntive.

6. Abilita gli aggiornamenti automatici

Gerbera monitora già automaticamente i file nuovi e modificati. Aggiungi il rilevamento delle modifiche agli attributi del file con questo blocco completo nel terminale root aperto:

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

All'inizio della sezione di output autoscan deve inotify-attrib="yes" stare in piedi. L'impostazione si trova nel volume di dati persistenti e verrà caricata al successivo avvio.

7. Montare la cartella musicale e avviare Gerbera

Arrestare il progetto o l'applicazione gerbera-qnap nella stazione dei container.
Aperto Public/gerbera-qnap/compose.yaml nella Stazione file. Sostituisci solo la mappatura delle cartelle vuote con la tua cartella musicale effettiva, ad esempio:

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

Salva il file sullo NAS, quindi copia l'intero blocco successivo nel terminale root aperto. Applica il file Compose modificato, riutilizza il volume di dati esistente e avvia Gerbera. Se il percorso del tuo progetto è diverso, modifica la prima riga cd … su. Il processo si applica anche ai file 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

Quindi aprilo http://NAS_IP:49494/ e attendi il caricamento della libreria. Puoi vedere i progressi qui sotto Stazione container → Container → gerbera-qnap → Protocollo. Continua a copiare solo i file completamente preparati nella cartella musica. Le playlist richiedono percorsi file relativi validi e codifica UTF-8.

8. Collegare MusicServer Connect

In MusicServer Connect, seleziona il server Gerbera QNAP. Utilizzare per una connessione manuale http://NAS_IP:49494/description.xml. Controlla l'inventario delle tracce, i valori BPM/chiave salvati e l'ordine delle tue playlist.

In caso di problemi di connessione, controlla lo stato del contenitore, l'IP NAS, l'interfaccia di rete e i possibili conflitti di porte. Per il rilevamento UPnP è necessario UDP 1900, per l'interfaccia web e l'accesso ai media TCP 49494 essere accessibili nella rete locale. A Permission denied controllare UID, GID e i permessi di lettura dell'utente Gerbera. Il percorso /content nel protocollo Gerbera è normale per l'immagine ufficiale.

Uscire dal terminale con exit; dopo sudo -i questo di solito è richiesto due volte. Se altrimenti non hai bisogno di SSH, rimuovilo in QTS Pannello di controllo → Servizi file e rete → Telnet/SSH la casella di controllo per Consenti connessione SSH e fare clic su Applicare.

9. Riavvii e versioni Gerbera più recenti

Per un riavvio normale selezionare Stazione container → Container → gerbera-qnap → Riavvia. Le impostazioni e il database rimangono nel volume dati denominato gerbera-data ricevuto. Quando si ricostruisce il contenitore, viene utilizzato l'eseguibile invariato dell'immagine ufficiale.

Passaggio da un'installazione 3.3.0 esistente

Utilizza il riferimento completo all'immagine di questa guida e preserva le impostazioni musicali, gli ID utente, i nomi dei progetti e i volumi di dati. Ricrea il contenitore come mostrato di seguito. Un semplice riavvio non installa un'immagine diversa. La sostituzione del contenitore rimuove qualsiasi patch binaria locale precedente.

Esegui l'upgrade a una versione stabile in un secondo momento

Scegli su pagina di rilascio ufficiale di Gerbera una versione stabile che include la correzione WavPack PR#3981 . Leggere le note sulla configurazione e sul database. Fino a quando tale versione non sarà disponibile, la versione Git esplicitamente specificata qui è una build provvisoria fissa. Non utilizzare un movimento latest- o edgeetichetta.
Aperto Public/gerbera-qnap/compose.yaml. Sostituiscilo il valore completo dopo image: attraverso gerbera/gerbera:NEUE_VERSION. Ciò include anche la rimozione di quelli precedenti @sha256:…riferimento, poiché appartiene alla vecchia immagine. Sostituisci NEUE_VERSION con il numero di versione selezionato. In alternativa, utilizzare il riferimento completo all'immagine dalla guida aggiornata. Mantieni invariate tutte le altre impostazioni.
Se necessario, abilita SSH come descritto sopra e accedi al terminale root. Scarica l'immagine selezionata:

docker pull gerbera/gerbera:NEUE_VERSION

Arresta il progetto o l'applicazione esistente in Container Station. Esegui il blocco di comandi completo Passo 7 fuori. Il volume di dati esistente non deve essere cancellato.
Attendere il completamento dell'avvio e dell'eventuale aggiornamento del database. Controllare la versione, il nome e il protocollo del server e le impostazioni BPM/chiave salvate. Collega MusicServer Connect e controlla diversi brani, file WavPack e playlist.

Guide del venditore: QNAP Container Station e modifiche YAML, Abilita SSH su QNAP, Crea utente QTS, immagine Docker ufficiale Gerbera.

Synology: imposta Gerbera con la correzione WavPack passo dopo passo

Gerbera è un software server multimediale aggiuntivo per il tuo Synology. Il vantaggio principale per MusicServer Connect è l'accesso ai valori già memorizzati nei file musicali: BPM e metadati delle chiavi musicali: Il server multimediale UPnP integrato di Synology non fornisce queste informazioni. I passaggi seguenti configurano le mappature dei metadati richieste.

Quando non hai bisogno di Gerbera? Se i file musicali non contengono valori BPM/tasti memorizzati, non è necessario Gerbera per questo scopo. VirtualDJ può calcolare BPM e la chiave musicale analizzando i file senza un server musicale. Puoi continuare a utilizzare il server multimediale integrato di Synology e lasciare che VirtualDJ li calcoli.

Il server multimediale di Synology può continuare a funzionare insieme a Gerbera, ad esempio per WiiM Home Advanced Mode. Gerbera non supporta questa modalità WiiM. La tua musica rimane nella cartella esistente; Gerbera ottiene l'accesso in sola lettura. Questa guida consente inoltre il rilevamento automatico dei file nuovi e modificati.

1. NAS e preparare gli utenti

Accedi all'interfaccia Synology DSM con un account che appartiene al gruppo amministratore sentito. Questo è un account autorizzato a gestire pacchetti e utenti. Il nome dell'account non è obbligatorio admin leggere. Se il tuo account non dispone di questi diritti, avrai bisogno della persona che gestisce NAS.
Apri questo Centro pacchi e installare Gestore dei contenitori. Se questo pacchetto non è disponibile per il tuo modello, questa guida non si applica ad esso. Per modificare il file YAML, puoi inoltre installare il pacchetto Synology Editor di testo installare.
Aperto Pannello di controllo → Utenti e gruppo → Utenti → Crea. Creare l'utente gerbera su. Non richiede diritti di amministratore. Assegnare la propria password; Continuerai a utilizzare il tuo account amministratore DSM per i seguenti comandi del terminale.
Aperto Pannello di controllo → Cartella condivisa, seleziona ad esempio la cartella della musica musice scegli Modifica → Autorizzazioni. Dare all'utente gerbera permesso Sola lettura. L'accesso deve valere anche per le cartelle e i file musicali inclusi.

Gli esempi utilizzano /volume1/music come cartella musicale e /volume1/docker per i file contenitore. Se queste cartelle si trovano su un volume diverso, utilizza i percorsi NAS effettivi nelle posizioni appropriate. I percorsi dei contenitori /mnt/content e /var/run/gerbera rimani lo stesso.

2. Crea cartelle e copia file

Aperto Stazione di archiviazione. Nella cartella condivisa, crea docker la sottocartella gerbera-synology . Se la cartella condivisa docker manca, crealo sotto Pannello di controllo → Cartella condivisa → Crea .
Crea un'altra sottocartella denominata empty su. Questa cartella rimane vuota. Serve come cartella musicale temporanea in modo che l'importazione inizi solo dopo l'impostazione dei metadati.
Scarica il Componi il file come compose.yaml al tuo computer.
Carica il file utilizzando Stazione file → Carica direttamente dentro docker/gerbera-synology accanto alla cartella empty. Il nome del file deve essere esattamente compose.yaml senza alcun ulteriore .txt essere attaccato.

La cartella del progetto contiene queste due voci:

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

3. Attiva SSH, accedi a NAS e determina i tuoi ID

È necessario l'accesso da terminale a NAS per trovare gli ID utente ed eseguire i seguenti comandi Docker. Puoi copiare i comandi mostrati qui; non è richiesta alcuna conoscenza di programmazione.

Controllare l'account e la password DSM

Apri nel DSM Pannello di controllo → Utente e gruppo → Utente. Evidenzia l'account che desideri utilizzare per accedere successivamente tramite SSH e fai clic Modifica.
L'account deve essere attivato: se necessario, rimuovere la selezione Disattiva questo account utente. Dopo il salvataggio, l'elenco degli utenti deve mostrare lo stato Normale invece Disabilitato vengono mostrati.
Sotto Gruppi di utenti a cui deve appartenere l'account amministratore gruppo. È necessaria la password di questo account per accedere e successivamente passare a root. Se non la conosci, imposta e conferma una nuova password nelle impostazioni dell'account. Salva le modifiche.

A tale scopo è possibile utilizzare l'account amministratore DSM esistente. Desideri specificamente l'account integrato admin Per utilizzarlo, attivare questo account come descritto e assegnare una password conosciuta. Il conto integrato admin non è necessario attivarlo se hai un altro account attivo del gruppo administrators utilizzare. L'utente creato nel passaggio 1 gerbera viene utilizzato esclusivamente per l'accesso alla musica e non richiede questi diritti di amministratore.

Attiva il servizio SSH sullo NAS

In DSM, apri il file Pannello di controllo e lì Terminale e SNMP. Seleziona la scheda Terminale.
Seleziona la casella di controllo per Abilita il servizio SSH. Per questa guida, lascia il porto a 22 vengono mostrati.
Fare clic su Applicare. Solo allora lo NAS accetterà le connessioni SSH. Se il firewall DSM è attivo, deve consentire la porta SSH impostata per il computer nella rete locale.

Accedi dal tuo computer e passa a root

Puoi trovare l'indirizzo IP NAS su Pannello di controllo → Rete → Interfaccia di rete. Apri sul PC Windows Terminale o PowerShell; su un Mac, l'applicazione Terminale.
Inserisci questo comando. Sostituisci DEIN_DSM_KONTO con il tuo account amministratore DSM e NAS_IP con il tuo indirizzo IP NAS. Non utilizzare l'utente appena creato gerbera.

ssh DEIN_DSM_KONTO@NAS_IP

Quando viene stabilita la connessione per la prima volta, potrebbe apparire una domanda riguardante l'identità dello NAS. Controllare l'indirizzo di destinazione visualizzato e confermare la connessione con yes. Quindi inserisci la password per il tuo account DSM. Non vengono visualizzati caratteri o asterischi durante la digitazione della password; questo è normale. Se utilizzi una porta SSH diversa, aggiungila durante la connessione. -p PORTNUMMER.

Quindi passa ai diritti richiesti per Docker con questo comando:

sudo -i

Se viene richiesta nuovamente una password, utilizza la stessa password del tuo account DSM. Non è richiesta una password speciale root. Il prompt di solito termina con #. Mantieni aperta questa finestra del terminale durante la configurazione. Tutti i seguenti comandi del terminale vengono eseguiti lì sullo NAS.

Per Connection refused Controlla innanzitutto se stai utilizzando il servizio SSH Applicare accesi e utilizzano l'indirizzo IP e il numero di porta corretti. Se la password viene rifiutata, controlla il nome dell'account, la password e lo stato Normale e l'appartenenza a amministratore. La guida di Synology all'accesso SSH con privilegi di root descrive anche questo processo.

Visualizza gli ID utente Gerbera:

id gerbera

Uscita come uid=1030(gerbera) gid=100(users) significa: UID è 1030, GID è 100. Prendi nota dei numeri del tuo output: identificano l'utente e il gruppo.

4. Personalizza il file di composizione

In File Station, aprire il file docker/gerbera-synology/compose.yaml con Editor di testo. In alternativa, modificalo sul tuo computer e caricalo di nuovo. Per UID e GID inserisci i numeri che hai appena scritto; devi sostituire i valori di esempio qui sotto. Se necessario, adattare il percorso NAS alla cartella del progetto vuota. Salvare il file.

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 consente il rilevamento nella rete domestica senza indirizzo IP fisso in YAML. La fine :ro Gerbera consente solo la lettura della cartella musicale. In volume gerbera-synology-data Le impostazioni e il database vengono salvati in modo permanente. restart: unless-stopped consente al contenitore NAS di riavviarsi dopo il riavvio di NAS, a condizione che non lo si sia arrestato manualmente in anticipo.

5. Inizia il progetto con una libreria vuota

Aperto Gestione contenitori → Progetto → Crea. Utilizza esattamente questo nome di progetto: gerbera-synology e la cartella preparata come percorso docker/gerbera-synology.
Scegli quello preparato compose.yaml come file Compose esistente. Se la finestra di dialogo offre un editor YAML, puoi inserire il contenuto lì.
Per Impostazioni del portale Web rimane Configurare il portale web tramite Web Station spento. Fare clic su Avanti e creare e avviare il progetto. Il primo download dell'immagine potrebbe richiedere del tempo.
Sotto Contenitore → gerbera-synology deve essere lo stato Correre o Correre apparire.
Apri nel browser http://NAS_IP:49494/, per esempio http://192.168.1.10:49494/. Sostituisci l'indirizzo di esempio con il tuo IP NAS. Vedi la superficie di Gerbera; la libreria musicale è intenzionalmente vuota a questo punto.

6. Configura BPM, visualizzazione dei tasti e del titolo

Aperto a Gerbera Configurazione e seleziona la vista Esperto. Sotto Library Options → taglib Library Options → metadati così come sotto ffmpeg Library Options → Metadati aggiungi le seguenti righe, mantenendo altre mappature esistenti.

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	chiave	upnp:key
ffmpeg	chiaveiniziale	upnp:initialKey

Sotto Server → Nome il nome Gerbera Synology un. In questo modo il server potrà essere successivamente distinto dagli altri server musicali.
Per AIFF di seguito Importa → Mappature → Mimetype-ContentType i due incarichi audio/x-aiff → aiff e audio/aiff → aiff supplemento. Senza queste assegnazioni, BPM, chiave e altri generi potrebbero mancare nonostante i tag esistenti. Configurazione AIFF.
Per OGV di seguito ffmpeg Library Options l'opzione streams-enabled Attivalo in modo che i tag vengano letti dalle tracce audio e video. Configurazione OGV.
Imposta il campo charset per taglib e ffmpeg a UTF-8. Inoltre filesystem-charset, metadata-charset e playlist-charset dovrebbe UTF-8 utilizzare.
Sotto UPnP → Elemento risultato titolo svuota il campo con M_ARTIST e ricevere M_TITLE. Il nome puro del titolo viene trasferito come titolo invece di “Artista – Titolo”.
Sotto WavPack Library Options rimane Abilitato acceso.
Fare clic su Salva configurazione, riavviare il contenitore in Container Manager e verificare che i valori vengano salvati dopo aver riaperto la configurazione Gerbera.

BPM e Key devono essere già salvati nei file musicali; queste impostazioni non calcolano i valori. Per MP4/M4A/M4V in quello esistente id3elemento prefer_highest_bpm_accuracy="yes" e prefer_ambigous_bpm_value="bpm_tag" secondo Configura la precisione BPM ai valori indicati. Senza la prima opzione viene mantenuto il comportamento precedente. Quindi importa nuovamente i file interessati.

7. Abilita gli aggiornamenti automatici

Gerbera monitora già automaticamente i file nuovi e modificati. Con il blocco seguente è possibile aggiungere il rilevamento delle modifiche agli attributi dei file. Copia l'intero blocco nel terminale NAS ancora aperto:

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

Nell'output deve trovarsi all'inizio della sezione di scansione automatica inotify-attrib="yes" stare in piedi. Il file si trova nel volume dati permanente. L'impostazione verrà caricata con la cartella musicale quando la avvierai successivamente.

8. Montare la cartella musicale e avviare Gerbera

Arrestare il progetto o l'applicazione gerbera-synology in Gestione contenitori.
Aperto docker/gerbera-synology/compose.yaml nella Stazione file. Sostituisci solo la mappatura delle cartelle vuote con la tua cartella musicale effettiva, ad esempio:

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

Quindi aprilo http://NAS_IP:49494/ e attendi il caricamento della libreria. Puoi vedere i progressi qui sotto Gestione contenitori → Contenitore → gerbera-synology → Protocollo. Continua a copiare solo i file completamente preparati nella cartella musica. Le playlist richiedono percorsi file relativi validi e codifica UTF-8.

9. Connettiti con MusicServer Connect

In MusicServer Connect, seleziona il server Gerbera Synology. Se è necessario un URL del dispositivo, utilizzare http://NAS_IP:49494/description.xml. Controlla i tuoi brani, album e playlist e apri alcuni brani con BPM e valori chiave salvati.

Se l'interfaccia non è accessibile o il server non viene trovato, controllare prima lo stato del contenitore e l'IP NAS. Se il firewall DSM è attivato TCP 49494 e per il rilevamento UPnP UDP 1900 dalla tua rete locale. Se il registro riporta Permission denied per la cartella musica, controlla i permessi di lettura dell'utente gerbera e UID e GID dal passaggio 3. Il percorso /content nel protocollo è normale per l'immagine ufficiale; si riferisce alla cartella musicale integrata.

Successivamente, esci dal terminale con exit andarsene; dopo sudo -i di solito è due volte exit necessario. Se altrimenti non hai bisogno di SSH, apri in DSM Pannello di controllo → Terminale e SNMP → Terminale, deseleziona la casella di controllo per Abilita il servizio SSH e fare clic su Applicare.

10. Riavvii e versioni Gerbera più recenti

Per un riavvio normale selezionare Gestione contenitori → Contenitore → gerbera-synology → Riavvia. Le impostazioni e il database rimangono nel volume dati denominato gerbera-synology-data ricevuto. Quando si ricostruisce il contenitore, viene utilizzato l'eseguibile invariato dell'immagine ufficiale.

Passaggio da un'installazione 3.3.0 esistente

Esegui l'upgrade a una versione stabile in un secondo momento

Scegli su pagina di rilascio ufficiale di Gerbera una versione stabile che include la correzione WavPack PR#3981 . Leggere le note sulla configurazione e sul database. Fino a quando tale versione non sarà disponibile, la versione Git esplicitamente specificata qui è una build provvisoria fissa. Non utilizzare un movimento latest- o edgeetichetta.
Aperto docker/gerbera-synology/compose.yaml. Sostituiscilo il valore completo dopo image: attraverso gerbera/gerbera:NEUE_VERSION. Ciò include anche la rimozione di quelli precedenti @sha256:…riferimento, poiché appartiene alla vecchia immagine. Sostituisci NEUE_VERSION con il numero di versione selezionato. In alternativa, utilizzare il riferimento completo all'immagine dalla guida aggiornata. Mantieni invariate tutte le altre impostazioni.
Se necessario, abilita SSH come descritto sopra e accedi al terminale root. Scarica l'immagine selezionata:

docker pull gerbera/gerbera:NEUE_VERSION

Arresta il progetto o l'applicazione esistente in Container Manager. Esegui il blocco di comandi completo Passo 8 fuori. Il volume di dati esistente non deve essere cancellato.
Attendere il completamento dell'avvio e dell'eventuale aggiornamento del database. Controllare la versione, il nome e il protocollo del server e le impostazioni BPM/chiave salvate. Collega MusicServer Connect e controlla diversi brani, file WavPack e playlist.

Guide del venditore: Progetti di gestione dei contenitori, Modelli NAS disponibili per Container Manager, Accesso SSH con diritti di amministratore, Immagine ufficiale Gerbera.

WiiM Home: libreria multimediale ampliata

WiiM Home Advanced Mode fornisce la propria visualizzazione della libreria con categorie di album, artista e traccia. I server supportati includono MinimServer, il server standard di Synology, il server standard di QNAP e Serviio. Gerbera attualmente fornisce la visualizzazione delle cartelle in WiiM Home.

In Advanced Mode, WiiM importa i metadati del server nel proprio indice, quindi crea visualizzazioni uniformi di album, artista, traccia, playlist e genere e la propria ricerca. In Legacy Mode, mostra invece la navigazione del server. Questi termini descrivono le modalità operative di WiiM Home.

Raccomandazione per la condivisione

I server Synology e QNAP standard supportano WiiM Home Advanced Mode, che non necessita di BPM o di metadati chiave. L'ordine errato della playlist di QNAP rimane una limitazione anche in WiiM Home.

Se VirtualDJ calcola BPM e imposta la chiave da solo, il server multimediale standard di Synology è sufficiente per MusicServer Connect. Lo stesso vale per QNAP se l'ordine errato della playlist è accettabile. In questi casi non è necessaria un'ulteriore installazione di Gerbera.

Per utilizzare i valori BPM/tasto memorizzati o preservare l'ordine della playlist QNAP in MusicServer Connect, puoi aggiungere Gerbera con la correzione WavPack in Docker. Seleziona Gerbera nel plugin e il server standard in WiiM Home Advanced Mode. Entrambi possono leggere la stessa libreria musicale. MinimServer rimane una soluzione a server singolo che copre questi requisiti e WiiM Home Advanced Mode; necessita ancora della configurazione aggiuntiva BPM/key tag. L'esecuzione di Gerbera su Synology richiede un Container Manager disponibile.

Ulteriori informazioni: WiiM Home: libreria multimediale e server supportati.

Ampache 7/8: legge video e file playlist

Un catalogo musicale non importa i video in Ampache. Per la videoteca, un ulteriore catalogo locale con la tipologia media Video e scansionalo. I percorsi del catalogo non devono sovrapporsi. La nostra configurazione utilizza quindi un'ulteriore visualizzazione della directory Linux di sola lettura che punta agli stessi file video; i file della libreria condivisa rimangono invariati.

Importa esplicitamente playlist basate su file. Il comando CLI ufficiale è php bin/cli run:updateCatalog -i "Katalogname"; utilizzare la versione PHP e l'account di servizio appropriati per la propria installazione. Una nuova scansione dei metadati da sola non è sufficiente. Entrambe le versioni hanno fornito voci audio con ripetizioni nel nostro confronto; le voci video erano assenti nelle playlist di file misti.

Consegna MP3 invariato

Se la conversione automatica MP3 è consentita ma non è configurato alcun convertitore, Ampache 8 potrebbe restituire HTTP 500 durante lo streaming. Per consegna invariata nella configurazione esistente, transcode_mp3 = "false" al valore indicato. In alternativa, configurare un transcoder funzionante. Con la conversione MP3 disabilitata, sia lo streaming che il download sono stati verificati byte per byte durante i nostri controlli.

LMS: playlist con brani dello stesso album

Nelle impostazioni LMS sotto Varie l'opzione Salta le playlist che contengono brani dello stesso album se vuoi che queste playlist vengano visualizzate. Quindi ricaricare la libreria. Il confronto ha confermato che le tracce audio ripetute sono state fornite nel loro ordine originale.

Asset UPnP: cartelle multimediali e playlist

Nell'interfaccia web delle risorse all'indirizzo Cartelle → Cartelle multimediali aggiungi la cartella della libreria. Sotto Cartelle di playlist specificare ciascuna cartella con i file della playlist individualmente; Le cartelle delle playlist subordinate non vengono incluse automaticamente qui. Questi sono in fase di test /srv/music/Playlists e /srv/music/Format-Test-1.3/Playlists.

Sotto Opzioni → Impostazioni schermo Disattiva i prefissi per i numeri delle tracce, gli artisti prima delle tracce della compilation e gli artisti dopo i titoli delle playlist se desideri nomi di tracce semplici. Queste impostazioni modificano il display, non i file musicali. Il fornitore di asset utilizza il ramo integrato Playlist per le playlist di file. Questa query non attraversa in modo ricorsivo combinazioni di filtri dinamici o radio Internet. È possibile mantenere la navigazione predefinita selezionata, inclusa la navigazione dinamica. Le visualizzazioni di catalogo, artista, album e genere sono state verificate senza errori di recupero dopo questa modifica. Asset fornisce M3U, M3U8 e PLS; I titoli delle tracce PLS restituiti dal server possono contenere un prefisso artista.

Guida alle risorse

Jellyfin 12.2.0: DLNA e profilo client

Jellyfin richiede quello ufficiale per MusicServer Connect Plug-in DLNA. Installalo dal catalogo plugin ufficiale nell'amministrazione del server e riavvia Jellyfin. DLNA 14.0.0.0 è stato controllato. Nelle sue impostazioni, scegli l'account le cui librerie dovrebbero essere esposte tramite DLNA. MusicServer Connect utilizza UPnP/DLNA, indipendentemente dall'accesso all'interfaccia web di Jellyfin.

Librerie e metadati

File audio come tipo di libreria Musica, video come Video musicali come biblioteche. Rendi leggibili le cartelle multimediali e playlist pertinenti, quindi scansiona entrambe le librerie. Per utilizzare solo i tag dei file, disabilita i metadati esterni e i fornitori di immagini; controlla anche le impostazioni globali dell'artista e dell'album. Mantieni abilitati i titoli incorporati e le immagini locali. La nostra configurazione accede alla libreria musicale condivisa in sola lettura.

Profilo cliente per MusicServer Connect

Il Scarica un profilo client DLNA verificato e come MusicServer Connect.xml Salvare nella cartella del profilo utente del plug-in DLNA. Questo è inferiore per l'installazione nativa di Debian /var/lib/jellyfin/plugins/configurations/dlna/user/; per le altre installazioni, utilizzare la directory dei dati Jellyfin effettiva. Il servizio Jellyfin deve essere in grado di leggere il file. Riavvia Jellyfin, quindi aggiorna la libreria dei plugin.

Il profilo identifica MusicServer Connect tramite il suo User-Agent. Fornisce URL di risorse stabili e tipi di media corretti per l'audio M4A e il video OGV, mantenendo le visualizzazioni degli album accessibili e questi formati visibili nel catalogo. Viene memorizzato separatamente dai profili di sistema forniti.

Restrizioni rimanenti

Tutte le sorgenti audio e video e le visualizzazioni dei plug-in 195 sono state recuperate senza errori nel controllo con i file 125. Su DLNA, Jellyfin non fornisce BPM/chiave e ridimensiona in modo errato i bitrate. ASX/XSPF sono assenti; M3U, M3U8, PLS e WPL perdono le tracce ripetute. Anche alcuni elenchi M3U/M3U8 meno recenti sono incompleti. Alcuni artisti degli album sono assegnati in modo errato e le cartelle di musica flat potrebbero non avere una visualizzazione nativa dell'album. A WMA manca il secondo genere; i video mancano di artista, album e genere. Il profilo cliente non risolve queste limitazioni.

Installazione ufficiale Linux · Documentazione ufficiale DLNA

WiiM Home, Mezzmo e Windows Media Player

Con questi server Windows, MusicServer Connect utilizza automaticamente la traccia verificata o le cartelle di file per evitare risposte di ricerca globali errate o molto lente. Non è necessaria alcuna impostazione aggiuntiva del plug-in. Le ricerche dei plugin vengono quindi eseguite sul catalogo importato.

Le risposte UPnP possono richiedere fino a 30 secondi o 60 secondi per Windows Media Player. Le richieste restano annullabili. Le pagine non valide o in modifica vengono comunque rifiutate; attendere più a lungo non può fornire file o metadati mancanti.

WiiM Home Media Server 0.2.10.5

I server musicali e VirtualDJ possono essere eseguiti sullo stesso PC Windows, inclusi più server contemporaneamente. L'elenco dei server combina il normale rilevamento UPnP con un controllo aggiuntivo per i server locali supportati. Identifica le porte effettive aperte e verifica le descrizioni dei dispositivi UPnP. I diversi ID dispositivo rimangono separati; più endpoint per un server non creano voci duplicate. Non sono richiesti i diritti di amministratore.

Il normale rilevamento UPnP di Windows non ha trovato WiiM Home sullo stesso PC nel nostro controllo, sebbene la descrizione del dispositivo fosse accessibile. La scoperta supplementare del plugin lo trova come WiiM Home: LaptopAcer - su un altro PC, usa invece il suo nome. Nella finestra di dialogo di connessione, fare clic su Cerca di nuovo e seleziona il server WiiM. Questa connessione UPnP non richiede nome utente o password. WiiM Home, Mezzmo e Windows Media Player sono stati controllati simultaneamente.

Per una versione precedente del plugin, è possibile salvare temporaneamente l'indirizzo completo della descrizione URL del server qui. Ad esempio, il percorso locale controllato è http://127.0.0.1:22346/upnp/DeviceDescription.xml. La porta e il percorso devono appartenere al server in esecuzione; il plugin non presuppone una porta fissa. Su questo computer, anche la porta 22345 ha esposto lo stesso server WiiM. Il nome host scritto localhost ha restituito HTTP 404 tramite assegno diretto e non è stato accettato come sostituto equivalente. L'errore di rilevamento non può essere attribuito in modo definitivo né a WiiM Home né a Windows.

Aggiungi la cartella musicale al catalogo multimediale locale e attiva la condivisione DLNA. Nel test è stata utilizzata la fonte originale \\smbserver\music . Questa interfaccia non fornisce né playlist né video basati su file; Assenti anche AAC ADTS, Opus e WavPack. Le playlist salvate nell'app WiiM non dimostrano il supporto per l'importazione di file di playlist esterne.

Mezzmo 6.0.6.0

Aggiungi la cartella Libreria incluse le sottocartelle. Playlist di file esterni separate tramite Crea playlist → Playlist connessa . "Aggiungi file da una playlist esterna" importa i media di riferimento ed è un'operazione diversa. Per preservare i tag del file originale, lasciare il recupero e la scrittura automatici dei metadati Internet disabilitati.

Offerta delle proprietà della cartella Controlla le cartelle per i nuovi file ogni. Gli elenchi già collegati hanno risultati separati. Il solo monitoraggio delle cartelle non creava elenchi collegati da file di playlist, anche con estensioni di playlist aggiuntive configurate. L'aggiornamento di un collegamento esistente e la scoperta di nuovi file di playlist sono funzionalità diverse. Gli elenchi controllati separatamente perdono ripetizioni con M3U/PLS/WPL; M3U8/XSPF rimangono vuoti ed entrambi gli esempi ASX riportano conteggi di pagine incoerenti. Le playlist intelligenti non possono sostituire un ordine esterno fisso con ripetizioni.

Il filtro predefinito include .aif ma non .aiff. L'aggiunta di *.aiff ha indicizzato l'esempio solo come tipo di file sconosciuto senza flusso, quindi questa modifica è stata annullata. Inoltre, WavPack non è stato mostrato come riproducibile al client controllato. Una voce nel database da sola non dimostra la giocabilità.

Windows Media Player Legacy/Condivisione 12.0

Sotto Pannello di controllo → Centro connessioni di rete e condivisione → Opzioni di streaming multimediale su Consenti tutto fare clic e con OK salvare. In questo modo i dispositivi nella rete locale, incluso WiiM e il cellulare con WiiM Home, hanno accesso al catalogo multimediale. A Accesso negato Controlla l'approvazione di questo dispositivo: l'accesso al plug-in funzionante sullo stesso PC non significa che i dispositivi esterni siano consentiti.

Abilita lo streaming multimediale per la rete locale e aggiungi cartelle di musica e video locali alle loro librerie Windows. È possibile disattivare il recupero e la scrittura automatici dei metadati Internet per preservare i file di origine. Il confronto locale completo ha restituito file multimediali reali 146 e ha decodificato completamente tutti i campioni di formato offerti da 20. Assenti OGG, Opus, WavPack, WebM e OGV; BPM e chiave non sono stati forniti. Dopo aver ricostruito il catalogo WMP, sono state restituite sei playlist non vuote. Alcuni nomi differiscono dagli elenchi importati; due elenchi M3U più vecchi perdono una traccia a causa della codifica dei caratteri. I loro equivalenti WPL contengono tutte e quattro le tracce.

Ad esempio, utilizza nomi di playlist senza punti MSC Misto 1-3 invece MSC Misto 1.3. Nel confronto mirato tra WPL, M3U e M3U8, WMP ha troncato i nomi delle copie di importazione salvate al primo punto; il nome abbreviato è apparso anche su UPnP. Un trattino conservava il nome completo.

Per WMP, il plug-in richiede elenchi di sola struttura con un piccolo filtro di metadati. I metadati completi della traccia, le risorse e i contenuti della playlist vengono comunque letti, mantenendo i controlli di impaginazione e coerenza. Per questa libreria, la pulizia e l'ottimizzazione del plugin hanno ridotto la prima richiesta di catalogo misurata da circa 22 secondi a 4.3–4.6 secondi. Questa è una misura del fornitore per la libreria selezionata, non una promessa generale per l'interfaccia di VirtualDJ o per librerie più grandi.

Se la tua raccolta contiene anche file di playlist, aggiungi solo le sottocartelle audio effettive alla libreria musicale Windows e aggiungi le cartelle video separatamente. Importa esplicitamente le playlist in WMP. L'aggiunta dell'intera cartella principale ha fatto sì che WMP esponesse alcuni file di playlist come tracce audio o elenchi vuoti. Le importazioni ripetute hanno creato ulteriori copie WPL nella cartella Windows Musica → Playlist. Prima della ricostruzione, eseguire il backup del catalogo WMP e archiviare le vecchie copie di importazione chiaramente identificate all'esterno delle cartelle monitorate; la sola ricostruzione del database li indicizzerebbe nuovamente. I media e le playlist originali vengono conservati.

I file multimediali sulla condivisione SMB non hanno funzionato come libreria WMP DLNA nel nostro test, anche tramite l'unità di rete Y:. Il servizio poteva leggere un file originale e Samba ne consentiva già la lettura e la scrittura, ma il catalogo multimediale condiviso rimaneva vuoto. Questo risultato si applica all'origine di rete verificata qui, non a tutte le configurazioni SMB. I file locali sono coperti dal controllo locale separato.

Windows I file offline non sono stati utilizzati poiché creano una copia locale sincronizzata. Dopo aver riavviato il servizio, la descrizione del dispositivo WMP e UPnP root sono stati nuovamente accessibili in circa tre secondi nel nostro controllo. Una voce del server inizialmente mancante non richiede automaticamente la ricostruzione della libreria.

Documentazione del produttore

Configurazione Gerbera

Gonic: cartelle musicali

MinimServer: Configurazione

MariaDB: modifica le colonne del database

Navidrome: raggruppa gli album indipendentemente dalla data di uscita

Navidrome: preferire le copertine incorporate

Ampache e LMS: accesso con chiave API

Ampache 7.10.2: importa titoli senza artisti dei titoli

Sintomo e causa

Ambito

Cosa è cambiato

Correzione generale del database

Requisiti

Importa i file mancanti e controlla il risultato

Funzionamento e aggiornamenti successivi

Gonic 0.22.0: un album per cartella musicale

Sintomo e causa

Struttura delle cartelle consigliata

Controllo dopo la modifica

Fornire playlist basate su file per l'utente

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

MP4, M4A e M4V: preferiscono il tag BPM più preciso

AIFF: BPM, chiave e lettura di più generi

OGV: adotta tag dalle tracce audio e video

WebM e WMV: adotta più generi con il lettore giusto

Rileva automaticamente le modifiche a file e attributi

Notifica nel contenitore ufficiale Gerbera

Gerbera 3.3.0-77: nomi di titoli puri nei risultati di ricerca

Gerbera: visualizzazioni e importazione della playlist

Perché la stessa playlist appare più volte

Controlla le importazioni di playlist incomplete

Riferimenti a playlist deprecate e set di caratteri M3U

MiniDLNA / ReadyMedia 1.3.3: estensioni dei file della playlist

Raccomandazione: rinominare M3U se possibile

Alternativa: conservare una sorgente M3U8 condivisa

Autorizzazioni della cache durante la ricostruzione

Condividi audio e video

Serviio 2.5: rilascio delle visualizzazioni richieste

Ordine dei brani

Diversi artisti degli album salvati

Se sono presenti più tag di genere, viene adottato solo il primo.

Leggi anche i video

Twonky Server 8.5.2: recupero completo di traccia e album

Universal Media Server 15.8.2: servizio Linux e visualizzazione dell'album

Artisti degli album e ricerca nel database

Ordine dell'album originale

File ASX e ricerca nel catalogo incompleta

Conversione audio e streaming WAV

Nascondi la cartella di transcodifica aggiuntiva

MinimServer: BPM/Aggiornamento chiave e libreria

Leggi BPM e chiave dai file musicali

Rileggere dopo le modifiche

Combina un album da più cartelle

M3U/M3U8: set di caratteri e voci mancanti

JRiver: importa playlist e consenti l'accesso in lettura

Synology: imposta il server multimediale predefinito

FRITZ!Box: formati audio e artisti delle tracce

Configura il server multimediale

Formati audio e metadati

Raccomandazione: utilizzare artisti della traccia

Playlist

QNAP: esegue il server multimediale standard e Gerbera in parallelo

Aggiungi Gerbera per MusicServer Connect

QNAP: imposta Gerbera con la correzione WavPack passo dopo passo

1. Preparare cartelle, utenti e file

2. Abilita SSH e ottieni l'accesso root

3. Personalizza il file di composizione

4. Avvia l'applicazione con la libreria vuota

5. Configura BPM, visualizzazione dei tasti e del titolo

6. Abilita gli aggiornamenti automatici

7. Montare la cartella musicale e avviare Gerbera

8. Collegare MusicServer Connect

9. Riavvii e versioni Gerbera più recenti

Passaggio da un'installazione 3.3.0 esistente

Esegui l'upgrade a una versione stabile in un secondo momento

Synology: imposta Gerbera con la correzione WavPack passo dopo passo

1. NAS e preparare gli utenti

2. Crea cartelle e copia file

3. Attiva SSH, accedi a NAS e determina i tuoi ID

Controllare l'account e la password DSM

Attiva il servizio SSH sullo NAS

Accedi dal tuo computer e passa a root

4. Personalizza il file di composizione

5. Inizia il progetto con una libreria vuota