Se hai cercato di capire come mostrare una cartella in emby su roku e nulla appare indipendentemente da ciò che provi, non sei solo. Questo è uno dei mal di testa più comuni di Emby — e la soluzione di solito non è dove ti aspetteresti. Il problema quasi sempre si riduce a tre cose separate: configurazione della libreria lato server, un interruttore all'interno dell'app Roku di cui nessuno ti parla, e permessi per utente che bloccano silenziosamente i contenuti. Questa guida copre tutte e tre, oltre ai casi limite che la maggior parte degli articoli salta completamente.

Perché le cartelle non vengono sempre visualizzate in Emby su Roku

Visualizzazioni predefinite di Emby vs. visualizzazione della cartella grezza

Emby Server non ti mostra un albero di directory grezzo per impostazione predefinita. Organizza i contenuti in "visualizzazioni" curate — Film, Serie TV, Musica — in base al tipo di libreria che hai assegnato durante l'impostazione. Ciò che appare nell'app Roku è una presentazione filtrata e arricchita di metadati di quel contenuto. Non la struttura effettiva della cartella su disco.

La navigazione delle cartelle grezze è una funzionalità completamente separata che deve essere abilitata in due posti: sul server e nel client Roku. Salta uno dei due passaggi e la cartella semplicemente non apparirà — oppure vedrai la libreria ma non la gerarchia delle directory al suo interno.

Visibilità della libreria per account utente

Emby ha un controllo degli accessi alla libreria per utente. Ogni profilo utente ha un elenco di caselle di controllo delle librerie che possono vedere. Se l'amministratore ha creato una nuova libreria ma non ha concesso accesso al tuo specifico account utente, l'app Roku non la mostrerà. Nessun messaggio di errore. Semplicemente non appare. Questo è il passaggio che la maggior parte delle guide salta, e colpisce più persone di qualsiasi altro problema.

Comportamento di caching dell'app Roku

L'app Roku Emby memorizza nella cache l'elenco delle librerie in modo aggressivo. Anche dopo aver sistemato tutto sul server, l'app Roku potrebbe ancora mostrare la vecchia visualizzazione.Hai bisogno di riavviare esplicitamente il canale — non basta chiuderlo — affinché le modifiche abbiano effetto. Su Roku OS 13+: premi Home, naviga all'icona del canale Emby, premi il* tasto, quindi seleziona "Riavvia canale."

Configura prima la libreria su Emby Server

Prima di toccare il Roku, la cartella deve essere configurata correttamente come libreria sul server. Qui è dove iniziano la maggior parte dei problemi.

Aggiungi una nuova libreria con tipo di contenuto 'Misto' o 'Cartella'

Apri la dashboard di Emby Server (di solito ahttp://your-server-ip:8096), vai aLibreria, e cliccaAggiungi Libreria Multimediale. Per la navigazione delle cartelle grezze, imposta il tipo di contenuto suContenuto Misto. Questo dice a Emby di non assumere che tutto ciò che è all'interno sia un film o un episodio TV, e sblocca l'opzione di visualizzazione della cartella che non appare sotto altri tipi di contenuto.

Se imposti il tipo di contenuto su "Film" o "Serie TV," Emby cercherà di abbinare i file ai metadati e di mostrarli come una griglia curata. Non otterrai la visualizzazione della cartella in quel modo.

Imposta l'opzione 'Visualizza come cartella'

Dopo aver selezionato Contenuto Misto, cerca l'opzione etichettata"Visualizza questa libreria utilizzando la sua struttura di cartelle". Abilitala. Questo è ciò che fa sì che Emby presenti il vero albero delle directory invece della visualizzazione dei metadati appiattita. L'etichetta esatta è cambiata leggermente tra Emby 4.7, 4.8 e 4.9, ma l'opzione è sempre lì — controlla semplicemente le impostazioni avanzate della libreria se non la vedi immediatamente.

Conferma i percorsi delle cartelle e i permessi

Aggiungi il percorso della tua cartella nella schermata di configurazione della libreria:

• Windows:D:\Media\Custom
• Linux:/mnt/media/custom
• NAS (SMB):\\NAS\Media\Custom o un percorso montato localmente come/mnt/nas/media

L'account del servizio Emby ha bisogno di accesso in lettura a quel percorso. Su Linux, l'emby utente ha bisogno almeno dir-x sulla directory er-- sui file. Su Windows, verifica che il servizio "Emby Server" sia in esecuzione come un account con permessi di lettura effettivi su quella cartella, non solo come Sistema Locale.

Esegui Emby in Docker? La cartella deve essere montata in binding all'interno del contenitore. Un errore molto comune: inserisci/mnt/media/custom come percorso della libreria, ma quel percorso non è mai stato mappato nel contenitore. All'interno di Docker è vuoto — Emby non vede nulla. Risolvilo aggiungendo-v /mnt/media/custom:/mnt/media/custom:ro al tuodocker run comando o l'equivalente in Compose.

I percorsi SMB con spazi o caratteri speciali nel nome della condivisione sono anche un problema ricorrente. Se la tua condivisione è\\NAS\My Media Files, mappala a un punto di montaggio pulito (/mnt/mymedia) e punta Emby lì invece.

Attiva una scansione della libreria

Dopo aver salvato, fai clic sul menu a tre punti sulla libreria e selezionaScansiona i file della libreria. Aspetta che completi. Per una ricostruzione completa dei metadati, usaAggiorna metadati con "Sostituisci esistenti" selezionato — più lento, ma cattura tutto ciò che la scansione iniziale ha perso.

Abilita la visualizzazione delle cartelle nell'app Roku Emby

Qui è dove la risposta effettiva su come mostrare le cartelle in emby su roku diverge dalla documentazione standard di Emby. La configurazione del server da sola non basta — il client Roku ha il proprio interruttore separato.

Accedi con il corretto utente Emby

Conferma di essere connesso all'app Roku con l'account utente Emby che ha accesso alla libreria. Se più utenti Emby condividono un dispositivo Roku, cambiare profilo non ricarica automaticamente l'elenco della libreria. Devi riavviare completamente il canale Roku dopo aver cambiato account affinché i permessi abbiano effetto.

Apri Impostazioni all'interno dell'app Roku

All'interno del canale Emby stesso — non nelle impostazioni del sistema Roku — naviga all'icona ingranaggio/Impostazioni, poiVisualizzazione. Stai cercando un'impostazione specificamente all'interno dell'app Emby, non da nessuna parte nei menu di sistema di Roku.

Attiva 'Visualizza cartelle' o 'Mostra visualizzazione cartella'

Trova l'impostazione chiamataVisualizza cartelle oMostra Vista Cartella e abilitalo. Questa è un'impostazione client per dispositivo. Influisce solo su questo Roku. Altri client Emby (browser web, app per telefoni, app per TV) hanno le proprie impostazioni separate e non verranno modificate.

Riavvia il canale Roku per aggiornare

Dopo aver abilitato l'impostazione, riavvia il canale. Premi Home, evidenzia Emby, premi*, scegli Riavvia. Premere semplicemente Indietro o uscire alla schermata principale non svuota la cache — è necessario un riavvio completo del canale affinché la struttura della libreria venga ricaricata correttamente.

Controlla i Permessi della Libreria per il Profilo Utente

Ancora niente? Questa sezione tratta la soluzione che risolve probabilmente il 40% dei casi in cui tutto il resto sembra corretto.

Emby Server → Utenti → Accesso alla Libreria

Nel dashboard di Emby Server, vai aUtenti, fai clic sull'account utente pertinente e scorri verso il basso fino aAccesso alla Libreria. Vedrai un elenco di tutte le librerie con caselle di controllo. Se la casella per la tua libreria personalizzata non è selezionata, quell'utente non può vederla da nessuna parte — né su Roku, né sul web, né nell'app per telefoni. È completamente invisibile per loro.

Seleziona la casella, salva le impostazioni dell'utente, quindi riavvia il canale Roku. La cartella apparirà.

Librerie nascoste vs. librerie bloccate

C'è una differenza significativa qui. Una libreria impostata su "Nascosta dalla vista principale" viene semplicemente rimossa dalla schermata principale ma è ancora accessibile tramite navigazione per cartelle e navigazione diretta. Una libreria bloccata tramite permessi utente significa che quell'utente non può vederla affatto. Se hai impostato una libreria su nascosta-dalla-vista-principale durante la configurazione e te ne sei dimenticato, questo spiega perché manca dalla schermata principale ma potrebbe ancora essere raggiungibile tramite la modalità di navigazione per cartelle.

Controlli parentali e filtri di valutazione dei contenuti

I controlli parentali possono silenziosamente eliminare contenuti. Se hai un filtro di valutazione dei contenuti sul profilo utente — bloccando contenuti non classificati, ad esempio — qualsiasi media senza valutazioni di metadata appropriate scompare semplicemente dalla vista. Controlla le impostazioni di controllo parentale dell'utente nel dashboard di Emby e disabilita i filtri o assicurati che i tuoi media abbiano valutazioni assegnate tramite una scansione dei metadata.

Risoluzione dei problemi: Cartella ancora non visibile

Hai esaminato tutto quanto sopra e sei ancora bloccato? Ecco come diagnosticare effettivamente cosa sta andando storto invece di indovinare.

Forza una scansione completa della libreria

Dashboard → Librerie → menu a tre punti →Aggiorna Metadata → Sostituisci esistente. Questo costringe Emby a rileggere ogni percorso di file da zero. Cattura problemi di temporizzazione in cui la scansione iniziale è avvenuta prima che la cartella fosse completamente scritta, e aggiorna anche i metadata che potrebbero filtrare contenuti dalla vista.

Svuota la cache dell'app Roku o reinstalla il canale

Roku OS 13+: Impostazioni → Sistema → Impostazioni di sistema avanzate → Dati e archiviazione del canale → svuota la cache per Emby. Se non è disponibile per canale, rimuovi completamente il canale Emby (Home → evidenzia → * → Rimuovi canale), quindi riaggiungilo dallo Store dei Canali. Non perderai i dati del server — basta reinserire l'indirizzo del server e le credenziali dopo la reinstallazione.

Controlla i log di Emby Server per errori di percorso

I log di Emby mostrano esattamente quali percorsi sono stati scansionati e perché hanno fallito. Posizioni dei log:

• Windows:%ProgramData%\Emby-Server\logs\
• Linux:/var/lib/emby/logs/
• Docker: controlla il tuo volume di log mappato, o eseguidocker logs emby-server

Cerca nel log il tuo percorso della cartella. "Accesso negato" o "Percorso non trovato" significa un problema di permessi. Percorso trovato ma 0 file? O la cartella è vuota, c'è un problema di montaggio Docker, o i file vengono filtrati da regole di tipo di contenuto.

Verifica che la condivisione di rete sia montata all'avvio del server

Questo colpisce costantemente gli utenti NAS. La condivisione SMB o NFS si monta bene manualmente, Emby la scansiona, tutto funziona — poi il server si riavvia. La condivisione non è montata all'avvio, quindi Emby vede una directory vuota o un percorso mancante. Correzione: aggiungi il montaggio a/etc/fstab su Linux, o usa un'unità di montaggio systemd con_netdev ex-systemd.automount opzioni. Su Windows, mappa l'unità di rete a una lettera, impostala per riconnettersi all'accesso e esegui il servizio Emby come un account utente di dominio/locale che ha accesso — non come Sistema Locale, che non può vedere le unità mappate.

Conferma che Roku e server siano sulla stessa rete o che Emby Premiere sia attivo per l'accesso remoto

Il processo per mostrare la cartella in emby su roku presuppone che entrambi i dispositivi siano sulla stessa rete locale. Se il tuo Roku è su una VLAN diversa dal server Emby, la scoperta mDNS non attraverserà il confine — dovrai inserire manualmente l'IP del server nelle impostazioni del server dell'app Roku. Per lo streaming al di fuori della tua LAN, è necessario Emby Premiere per la transcodifica; senza di esso, funzioneranno solo i file che vengono riprodotti direttamente su Roku, e tutto il resto fallirà con un errore generico.

Best Practices per organizzare le cartelle per la riproduzione su Roku

Far apparire la cartella è metà della battaglia. Far sì che le cose vengano riprodotte senza problemi è l'altra metà.

Struttura di cartelle consigliata per film e TV

Per un abbinamento affidabile dei metadati, attenersi a questi schemi:

• Film:Nome del Film (Anno)/Nome del Film (Anno).mkv
• Serie TV:Nome dello Show/Stagione 01/Nome dello Show S01E01.mkv

Emby si abbina a TheTVDB e TMDb. I nomi che non seguono lo schema previsto spesso corrispondono in modo errato o non corrispondono affatto. Gli elementi non abbinati appaiono comunque nella vista della cartella ma non mostrano manifesti, descrizioni o dati sugli episodi. Non è un problema insormontabile, ma vale la pena correggerlo.

Compatibilità di contenitore e codec con Roku

Cosa gestisce Roku nativamente senza richiedere transcodifica:

• Video: H.264 (tutti i modelli Roku), H.265/HEVC (solo modelli capaci di 4K — Roku Ultra, Streaming Stick 4K, Express 4K+)
• Audio: AAC, AC3/Dolby Digital, EAC3 sulla maggior parte dei modelli attuali
• Contenitori: MP4, MKV, MOV

L'audio DTS è scadente su Roku — non verrà riprodotto nativamente su nessun modello attuale. Emby deve transcodificare la traccia audio in AC3 prima di inviarla. Se vedi video riprodotti in silenzio o ricevi errori di "media incompatibile", è quasi certamente colpa del DTS. Assicurati che Emby Server abbia abbastanza CPU o che l'accelerazione hardware (Intel Quick Sync, NVENC) sia abilitata per gestire la transcodifica audio in tempo reale.

Per contenuti 4K, qualsiasi cosa sopra circa 40 Mbps farà scattare su Wi-Fi. Il Roku Ultra ha una porta Ethernet fisica — usala per file di grandi dimensioni. I modelli Streaming Stick sono solo Wi-Fi, quindi i remux 4K ad alta bitrate saranno un problema indipendentemente da quanto sia buono il tuo router.

Quando funziona la riproduzione diretta vs. quando inizia la transcodifica

La riproduzione diretta significa che Emby invia il file originale non modificato e Roku lo decodifica nativamente. Questo è sempre il percorso migliore — zero carico CPU sul server, nessuna perdita di qualità, latenza inferiore. La transcodifica inizia quando il codec non è supportato nativamente da Roku, il bitrate stimato supera il limite di Roku, o i sottotitoli richiedono l'inserimento (i sottotitoli ASS/SSA attivano sempre la transcodifica; SRT e PGS di solito vengono riprodotti direttamente senza problemi).

Nel dashboard di Emby Server sottoTranscodifica, abilitare l'accelerazione hardware riduce drasticamente il carico della CPU quando la transcodifica è inevitabile. Vale la pena configurarlo se il tuo server lo supporta.