Vai al contenuto

Documentazione

Usa Quven dall'installazione alla riproduzione.

Installa il server, connetti i dispositivi e trasmetti la tua libreria come l'hai configurata. Tutto ciò che segue descrive quanto è disponibile oggi e indica ciò che è ancora in programma.

Panoramica

Quven è un media server self-hosted per film, serie TV, documentari, musica e libri. Lo installi su un tuo computer, indichi le cartelle, accedi con un Quven Account gratuito e trasmetti alle app desktop, web e mobile native sui tuoi dispositivi, a casa e, se vuoi, da ovunque. I tuoi file multimediali restano sul tuo hardware.

Self-hosted I tuoi contenuti restano sul tuo hardware: Quven non ospita i tuoi file.
Nativo in primo piano Le app native offrono l'esperienza completa; il client web, incluso in Pro, copre ogni altro schermo.
Gratis per uso personale Riprodurre la tua libreria non costa nulla, per sempre.
Profili di famiglia Profili illimitati con ogni piano, con lo stato personale sincronizzato su Quven Account.

Installa il server

Scarica l'installer per la tua piattaforma da quven.tv/download. Il pacchetto include tutto il necessario.

Windows .msi Windows 10 e 11. Programma di installazione con un clic e aggiornamenti automatici.
macOS .pkg Per macOS 13 e successivi su Intel (x64) o Apple silicon (ARM64). Firmato e notarizzato da Apple.
Linux AppImage AppImage server-only x64 e ARM64 disponibili, ARM64 verificata su Raspberry Pi 4. Un client desktop per Linux è in programma.
  1. Installa e avvia. Il server si avvia automaticamente in secondo piano.
  2. Accedi o registrati. I client Quven partono da Quven Account su accounts.quven.tv .
  3. Collega il server. Al primo avvio, collega il server al tuo account; quell'account ne diventa il proprietario.
  4. Aggiungi una libreria. Indica a Quven le cartelle dei tuoi contenuti e avvia una scansione (vedi sotto).
  5. Scegli un profilo. Crea i profili di famiglia, aggiungi PIN opzionali, poi scegli chi sta guardando.

Connetti i dispositivi

Accedi prima, poi scegli un server locale scoperto sulla LAN o un server remoto già collegato al tuo account. Le app native offrono l'esperienza completa; il client web resta l'alternativa curata per un accesso rapido o dal computer di un'altra persona.

App desktop nativa

L'app desktop nativa funziona su Windows e macOS, con pacchetti macOS firmati e notarizzati per Intel e Apple silicon; su Linux Quven funziona come server, e un'app desktop per Linux è in programma. Direct play completo, decodifica hardware, audio HD intatto e sottotitoli avanzati.

Client web

Si apre in qualsiasi browser moderno dopo l'accesso a Quven Account ed è incluso in Pro. È adatto al computer di un'altra persona o a un accesso rapido senza installazione, con interfaccia cinematografica e riproduzione via HLS.

App Android nativa

Disponibile su Google Play. Una sola scheda copre telefono, tablet e Android TV: layout touch che si adattano allo schermo che si tiene in mano e navigazione pensata per il telecomando sul televisore. La stessa app è pubblicata per Fire TV sull'Amazon Appstore.

App nativa per iPhone e iPad

Un'app nativa per iPhone e iPad, non derivata dal web né adattata dal desktop: layout pensati per l'iPad, controlli che seguono il puntatore, scorciatoie da tastiera, widget, Picture in Picture e AirPlay. È disponibile sull'App Store per iOS e iPadOS 17 e successivi; un'app per Apple TV è in programma.

Su una subnet diversa o in VPN? Inserisci l'indirizzo del server manualmente invece di affidarti alla scoperta automatica. L'app iPhone e iPad è sull'App Store; quella Android è su Google Play per telefono, tablet e Android TV, e sull'Amazon Appstore per Fire TV; le app per Apple TV e per le Smart TV sono in programma.

Librerie e scansione

Aggiungi una cartella, scegli un tipo e Quven ne abbina i contenuti su quattro cataloghi. Le scansioni partono quando le avvii tu, oppure automaticamente con Pro.

Aggiungi una libreria

Nelle impostazioni del server, crea una libreria, scegliendone il tipo tra Film, Serie TV, Documentari, Musica, Libri e gli altri proposti, e indicale una cartella sulla macchina server. Avvia una scansione; l'avanzamento è visibile in tempo reale e una scansione annullata può essere ripresa.

Abbinamento e metadati

Ogni file viene abbinato dal suo nome su TMDb, TVDB, OMDb e AniDB. Una disambiguazione AI opzionale risolve i casi difficili. Se un abbinamento è sbagliato, apri l'elemento e usa Cambia abbinamento per scegliere il titolo giusto. Ogni catalogo ha la propria scheda, e ogni risultato indica il catalogo che ha risposto.

Nomi che vengono abbinati con affidabilità
  • Avatar (2009).mkv, con l'anno
  • Breaking Bad/Season 1/S01E01.mkv, episodi per stagione
  • Inception/Inception.2010.2160p.mkv + Inception.2010.1080p.mkv, varianti di un titolo

Più file per titolo. 4K + 1080p, lingue audio diverse, versioni cinematografiche ed estese convivono sotto un'unica voce, e Edizioni alternative indica cosa cambia tra loro e riproduce quella che scegli.

Riproduzione

Quven riproduce il file originale intatto ogni volta che il client può gestirlo, e transcodifica solo quando è necessario.

Direct play

Trasmette la sorgente così com'è sulla rete, con latenza minima e nessuna transcodifica. Usato quando il client supporta nativamente video, audio, container e sottotitoli, cosa che le app desktop fanno per molti più formati dei browser.

Transcodifica hardware

Quando il direct play non è possibile, il server transcodifica al volo, usando la tua GPU dove disponibile (NVIDIA, Intel, AMD, Apple). Le sorgenti HDR vengono adattate a SDR per i client che ne hanno bisogno.

  • Sottotitoli: tracce testuali e a immagine incorporate, più i file di sottotitoli esterni accanto ai media, e una traccia generata dal parlato quando il file non ne ha.
  • Audio HD: l'audio originale arriva intatto ai player nativi; telefoni e tablet puntano sulla copertura di formati, sottotitoli e HDR.
  • Tone mapping HDR: sorgenti HDR10 adattate a SDR con accelerazione GPU dove supportata.
  • Ripresa: riprende da dove avevi lasciato, per utente, incluso l'episodio successivo di una serie.

Account e piani

Quven Account è l'identità unica per desktop, web e client mobile nativi. Un account copre tutta la famiglia, i suoi profili e ogni server collegato.

Free

Riprodurre la tua libreria, per sempre: client nativi, transcodifica hardware, abbinamento, varianti multi-file, profili illimitati e accesso remoto fai-da-te.

Pro

Tutto ciò che include Free, più il client web ospitato e il relay gestito senza configurazione per l'accesso da ovunque, i sottotitoli scritti dall'audio, la scansione automatica, i film 3D tenuti come edizione a sé, l'edizione completa degli ebook, l'abbinamento AI gestito, il backup cloud della libreria, i controller di gioco sul desktop Windows, il server condiviso con un massimo di 25 persone, una capacità maggiore sul servizio metadati Quven e il supporto email prioritario entro 48 ore lavorative.

Max

Tutto ciò che include Pro, più l'editor delle battute dei sottotitoli e la traduzione AI dei sottotitoli su richiesta, da testo, immagine o audio, l'elenco dei personaggi senza anticipazioni, le correzioni private e la lettura misurata negli ebook, una copia riparata di un file audio o di un EPUB che la scansione non riesce a leggere, il video a 360° sul desktop, il server condiviso con un massimo di 50 persone, o di 150 con Lifetime, la capacità più alta sul servizio metadati Quven e il supporto entro 24 ore lavorative; più avanti, TV in diretta con HDHomeRun ed EPG, registrazioni programmate e temi predefiniti.

Founders. Il programma è chiuso: tutti i 100 posti sono stati assegnati. Gli account Founder mantengono il prezzo promesso di €69 per Lifetime Max fino al 31 dicembre 2026. Vedi i piani per il dettaglio completo.

Accesso remoto

Il server si raggiunge da fuori casa in due modi: uno gestito da te, l'altro gestito da Quven.

Fai-da-te · Free

Apri una porta, usa un reverse proxy o un tunnel come Tailscale. Raggiungere il proprio server in questo modo è gratuito su ogni piano.

Relay gestito · Pro

Accedi con il tuo account e il client raggiunge il tuo server attraverso il relay di Quven, senza port forwarding né DNS, anche dietro un NAT restrittivo. Si applica un limite di banda per un uso corretto del servizio.

API di integrazione · Free

Collega Homepage, Grafana o uno script al tuo server con una chiave in sola lettura, che non può modificare nulla. Riferimento e documento OpenAPI.

Formati supportati

I client nativi fanno direct play di un'ampia gamma; i browser ricevono uno stream transcodificato quando non possono decodificare la sorgente.

Container

MKV, MP4, WebM e altri, serviti così come sono ai client nativi, remuxati o transcodificati in HLS per i browser.

Video

H.264, HEVC, AV1, VP9 in direct play sui client nativi. I browser ricevono H.264 (o HEVC dove supportato) via transcodifica. Le sorgenti VVC si riproducono via transcodifica.

Audio

AAC, AC3, EAC3, DTS, TrueHD e FLAC sui client nativi, serviti intatti; i browser ripiegano su stereo/AAC quando non possono decodificare una traccia.

Sottotitoli

Tracce testuali SRT, ASS e VTT, più i file di sottotitoli esterni accanto ai media, incluse le coppie .idx e .sub. Le tracce immagine DVD, VobSub e PGS vengono disegnate dalle app native oppure impresse quando serve a un browser. Lo stile ASS avanzato è preservato sui client nativi.

Il DRM dei servizi di streaming (Widevine, PlayReady, FairPlay) non è previsto: Quven riproduce i tuoi file.

Privacy e diagnostica

I dati restano in locale per scelta di progetto. La diagnostica è dichiarata, priva di dati personali e attiva per impostazione predefinita, con la possibilità di disattivarla.

  • Account richiesto: il primo accesso e il rinnovo periodico del token richiedono una connessione a internet; senza connessione il funzionamento è garantito per sette giorni.
  • Dati personali rimossi: se abilitati, i report di crash e riproduzione rimuovono percorsi di file, indirizzi ed email prima dell'invio.
  • I media restano locali: i tuoi file e le cartelle della libreria restano sul tuo server; i dati di profilo come liste, valutazioni, recensioni e posizioni di ripresa si sincronizzano tramite Quven Account.

Lingue

Le app e i metadati localizzati sono disponibili oggi in cinque lingue.

EnglishItalianoFrançaisEspañolDeutsch

Guide passo dopo passo

Guide pratiche con i comandi da eseguire, dall'installazione del server all'accesso da fuori casa.

Gestire il media server dalla riga di comando Avvia, controlla, collega e aggiorna da terminale, con esempi di script. Media server in Docker: avvio con Docker Compose File Compose, profili GPU, aggiornamenti e verifica della firma. Media server Linux headless su x64 o ARM64 chmod, avvio e collegamento dell'account da terminale. Media server macOS su Intel e Apple silicon Scegli il pacchetto, installalo e collega il server. Media server Windows con client desktop nativo Scegli il pacchetto, verifica la firma e collega il server. Come organizzare film e serie su hard disk per un media server Cartelle, nomi, edizioni e sottotitoli nel posto giusto. Come preparare una libreria di audiolibri sul proprio media server Cartelle, capitoli, ASIN e ascolto su più dispositivi. DVD e Blu-ray in una libreria self-hosted Remux in MKV, nomi e sottotitoli nel browser. Migrare una libreria su un nuovo server senza mettere a rischio i file Un campione, la scansione, poi la cronologia dei visti. Spostare la libreria su un nuovo disco senza perdere la cronologia Mantieni il percorso o lascia che la scansione segua i file. Tenere due copie di un film senza vederlo due volte in libreria Versioni sotto un solo titolo, edizioni con una scheda propria. Come generare i sottotitoli per un film che non ne ha Avvia dal player, lascia che il server scarichi il modello, usa il risultato. Come tradurre i sottotitoli con l'AI Scegli la traccia di partenza e traduci dal player. Monitorare il media server con Prometheus e Grafana Emetti una chiave, leggi le sei rotte, collega Prometheus. Raggiungere il media server self-hosted fuori casa Per indirizzo o relay: passaggi, test da fuori e condivisione. Guardare la tua libreria su Android TV senza transcodifica Due impostazioni, la verifica delle statistiche e i casi limite. Quale NAS transcodifica il 4K e come verificarlo Leggi il processore, trova il nodo di rendering, provalo con un film. Transcodifica HDR e tone mapping sul media server Quando converte il server, quale backend, cosa dice il log.

Risoluzione problemi e FAQ

Le risposte alle domande più frequenti.

Configurazione e librerie

Perché una scansione non ha trovato i miei file o ha abbinato il titolo sbagliato?

Controlla prima il nome: includi l'anno, es. "Avatar (2009).mkv", e per gli episodi usa "Nome Serie S01E01.mkv" o cartelle per stagione. Assicurati che l'account che esegue il server possa leggere la cartella. Se un elemento ha abbinato il titolo sbagliato, apri la pagina di dettaglio e usa Cambia abbinamento per scegliere il risultato corretto. Se nessun account Pro sorveglia la cartella, una scansione parte quando la avvii tu, quindi riavviala dopo aver rinominato.

Leggi la guida all'organizzazione della libreria
Ho lo stesso film in 4K e 1080p: avrò due voci separate?

No. Più file per lo stesso titolo (4K e 1080p, lingue audio diverse, versione cinematografica ed estesa) convivono sotto un'unica voce in libreria. Edizioni alternative, nel menu del titolo, indica ogni versione per ciò che la distingue davvero, cioè durata, risoluzione, gamma dinamica, configurazione audio e codec video, e riproduce quella che scegli.

Quven continua a scansionare le cartelle in secondo piano?

Solo se glielo hai chiesto. La sorveglianza delle cartelle e le scansioni programmate si trovano nella scheda Scansione automatica delle Impostazioni e sono incluse in Pro o superiore. Con un account Free nessuna operazione riguarda i tuoi dischi finché non avvii tu una scansione; l'avanzamento viene mostrato in tempo reale in entrambi i casi, e una scansione annullata può essere ripresa.

Un cruscotto o uno script possono leggere il mio server?

Sì. Crea una chiave di integrazione dalle Impostazioni, su desktop o nel browser, e inviala a ogni richiesta. La chiave è di sola lettura: nessun endpoint che modifica qualcosa la accetta, e una chiave non può emetterne un'altra. Riporta il server, le librerie con i loro conteggi e le sessioni in corso. Non riporta mai le cartelle in cui si trovano le librerie, né chi sta guardando. La guida all'integrazione copre gli endpoint e i due modi di inviare la chiave.

Leggi la guida al cruscotto e all'API

Riproduzione

Il mio browser non riesce a riprodurre un file: c'è un problema?

No. I browser non decodificano tutti i container e codec, quindi quando la riproduzione diretta non è possibile il server transcodifica il file al volo in uno stream HLS compatibile con i browser. Le app native desktop coprono la catena di uscita desktop con audio HD intatto; le app native Android e iPhone/iPad puntano su ampia compatibilità codec e sottotitoli sui dispositivi mobile.

Scopri come funziona la riproduzione nativa
Qual è la differenza tra direct play e transcodifica?

Il direct play trasmette il file originale intatto, con latenza minima e senza carico aggiuntivo sul processore. Viene usato quando il client gestisce video, audio, container e sottotitoli così come sono (le app native gestiscono molto più dei browser). Quando non è possibile, il server transcodifica con FFmpeg usando l'accelerazione hardware dove disponibile.

Un film non ha alcun sottotitolo: Quven può crearne uno?

Sì. Un amministratore chiede un sottotitolo nel player, sul desktop o nel client web, e il server trascrive il parlato da solo, poi salva il risultato come una traccia normale che ritrovi la volta successiva. L'audio non lascia mai la tua macchina, e il riconoscimento gira sul tuo processore o sulla tua GPU. La richiesta di un sottotitolo è inclusa in Pro; una volta che la traccia esiste, la riproduce ogni piano e ogni profilo. Un amministratore installa il modello vocale una volta, su richiesta; pesa circa mezzo gigabyte e viene scaricato solo quando serve davvero.

Leggi la guida alla generazione dei sottotitoli
Perché la riproduzione si interrompe per il buffering quando guardo fuori casa?

La riproduzione remota è limitata dalla velocità di upload della tua connessione domestica. Abbassa la qualità nelle impostazioni del player, o guarda sull'app nativa che può fare direct play invece di transcodificare. Il relay gestito (Pro) elimina la configurazione di rete, ma la banda è comunque legata alla tua connessione.

Leggi la guida all'accesso remoto

Account, piani e privacy

Ho bisogno di un account per usare Quven?

Sì. Quven Account è l'unico punto di accesso per desktop, web e client mobile nativi. Accedi o registrati prima, poi scegli un server trovato sulla LAN, connettiti a uno remoto collegato al tuo account, o completa la configurazione di un nuovo server self-hosted.

Quven è davvero gratuito?

Sì. Riprodurre la tua libreria è gratuito per uso personale, per sempre, e questo comprende client nativi, transcodifica hardware, abbinamento, varianti multi-file, profili illimitati e accesso remoto fai-da-te. Pro aggiunge i servizi gestiti, la scansione automatica e i sottotitoli scritti dall'audio; Max aggiunge la traduzione dei sottotitoli, l'editor delle battute e la riparazione dei file danneggiati. La pagina dei piani elenca le funzioni gratuite, che non cambiano. Per uso personale si intendono te, la tua famiglia e gli ospiti che inviti; la licenza non consente di vendere ad altri l'accesso alla tua libreria.

Quanto costano Pro, Max e Lifetime?

Pro e Max seguono questo percorso: fino al 6 ottobre 2026: Pro €2,99 al mese o €29,99 all'anno, Max €5,99 al mese o €59,99 all'anno; dal 7 ottobre 2026 al 15 novembre 2026: Pro €3,49 al mese o €34,99 all'anno, Max €6,99 al mese o €69,99 all'anno; dal 16 novembre 2026 al 31 dicembre 2026: Pro €3,99 al mese o €39,99 all'anno, Max €7,99 al mese o €79,99 all'anno; dal 1 gennaio 2027: Pro €4,99 al mese o €49,99 all'anno, Max €9,99 al mese o €99,99 all'anno. Lifetime include tutte le funzioni di Max con un pagamento unico: €99 fino al 6 ottobre 2026, poi €129 fino al 15 novembre 2026, poi €149 fino al 31 dicembre 2026, poi €199 fino al 30 giugno 2027. Il prezzo successivo al 30 giugno 2027 non è ancora stato annunciato. Negli Stati Uniti si applicano le stesse cifre in dollari. Tutti i posti Founder sono assegnati, quindi il prezzo Founder da €69 è chiuso ai nuovi account; i cento che ce l'hanno lo mantengono. Gli acquisti sono aperti.

Quali dati raccoglie Quven su di me?

Quven Account memorizza l'identità, i server collegati e i dati di profilo necessari per sincronizzare liste, valutazioni, recensioni e posizioni di ripresa. I tuoi file multimediali e le cartelle della libreria rimangono sul tuo server. La diagnostica è attiva per impostazione predefinita come misura di sicurezza e stabilità, con avviso chiaro e la possibilità di disattivarla nelle impostazioni; le segnalazioni di crash e di riproduzione rimuovono percorsi di file, indirizzi ed email.

Leggi cosa resta in locale

Piattaforme e roadmap

Esistono app per mobile e TV?

I client desktop Windows e macOS, il client web ospitato (Pro), l'app nativa per iPhone e iPad e l'app Android nativa per smartphone, tablet e Android TV e l'app per Fire TV sull'Amazon Appstore sono disponibili oggi. macOS è firmato e notarizzato per Intel e Apple silicon, mentre su Linux Quven funziona come server per x64 e ARM64, come AppImage o immagine Docker firmata, con ARM64 verificata su Raspberry Pi 4, e un client desktop per Linux è in programma. Una sola scheda Google Play copre tutti e tre i tipi di dispositivo Android, e la stessa app per la TV è pubblicata per Fire TV; le app per Apple TV e per le Smart TV sono in programma.

Leggi la guida per Android TV
Posso spostare la mia libreria da un altro media server?

Sì. La struttura delle cartelle resta valida: indica a Quven le cartelle dei media esistenti, che vengono scansionate e abbinate. Da un server Plex o Jellyfin esistente Quven importa anche la tua cronologia direttamente: trova la sorgente, mostra cosa sta per portare, poi trasferisce stato di visione e playlist, abbinando i titoli per identità di catalogo invece che per struttura delle cartelle. Legge il vecchio server senza modificarlo, quindi puoi importare mentre l'installazione precedente è ancora attiva.

Leggi la guida alla migrazione
E per la musica?

La musica è arrivata con la 1.2.0 ed è gratis su ogni piano. Su Desktop indichi a Quven le cartelle degli album: i tag vengono prima, i nomi delle cartelle completano ciò che manca e copertine e testi possono arrivare dai file o dai contenuti salvati accanto. Fra un brano e l'altro la riproduzione è continua, ma un browser che deve ricodificare può aggiungere una pausa udibile. Ascoltare su Desktop tramite VPN o reverse proxy propri resta gratis anche fuori casa; il client web ospitato e il relay gestito richiedono Pro.

Serve altro aiuto?

Vai al supporto