Documentazione

Usa Quven dall'installazione al playback.

Installa il server, connetti i dispositivi e trasmetti la tua libreria come l'hai configurata. Tutto qui sotto riflette lo stato corrente e segnala chiaramente superfici al lancio e post-lancio.

Panoramica

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

Self-hosted I tuoi media vivono sul tuo hardware — Quven non ospita i tuoi file.
Native-first Le app native premium guidano; un web client curato è il fallback universale.
Gratis per casa L'esperienza locale completa non costa nulla, per sempre.
Profili household Profili illimitati su ogni tier, con lo stato personale sincronizzato su Quven Account.

Installa il server

Scarica l'installer per la tua piattaforma da quven.tv/download. C'è già tutto — nient'altro da installare.

Windows .msi Windows 10 e 11. Installer one-click con 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. Client desktop previsto post-v1.
  1. Installa e avvia. Il server parte automaticamente in background.
  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. Punta Quven sulle tue cartelle media e avvia una scansione (sotto).
  5. Scegli un profilo. Crea profili household, 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 sono il percorso premium; il web client resta il fallback curato per accesso rapido e macchine ospiti.

App desktop nativa

Windows e macOS oggi, con pacchetti macOS firmati e notarizzati per Intel e Apple silicon. Linux v1 è server-only, con il client desktop previsto post-v1. Direct play completo, decodifica hardware, audio HD intatto e sottotitoli avanzati.

Web client

Si apre in qualsiasi browser moderno dopo l'accesso a Quven Account — il fallback universale per macchine ospiti o accesso rapido senza installare. UI cinematografica, con riproduzione gestita via HLS.

App Android nativa

Client Kotlin e Jetpack Compose, live su Google Play. Una sola scheda copre phone, tablet e Android TV: layout touch adattivi in mano, focus remote-first e navigazione TV sul televisore. La stessa build è verificata su Fire TV, la cui scheda sull'Amazon Appstore segue.

App iPhone e iPad esclusiva

Un'esperienza Quven Apple-native esclusiva in SwiftUI, non wrappata dal web né riciclata dal desktop — layout iPad dinamici, controlli pointer-aware, scorciatoie tastiera, widget, PiP e handoff AirPlay. È disponibile sull'App Store per iOS e iPadOS 17 e successivi; Apple TV (tvOS) segue dopo il lancio.

Su una subnet diversa o 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 phone, tablet e Android TV; Fire TV e Apple TV (tvOS) seguono, e i wrapper Smart TV dopo di loro.

Librerie e scansione

Aggiungi una cartella, scegli un tipo e lascia che Quven la abbini su quattro cataloghi. Le scansioni sono sempre avviate da te.

Aggiungi una libreria

Nelle impostazioni del server, crea una libreria di tipo Film, Serie TV o Documentari e puntala a una cartella sulla macchina server. Avvia una scansione; il progresso è live 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 Correggi abbinamento per scegliere il titolo giusto — ogni catalogo ha la propria scheda, e ogni risultato indica il catalogo che ha risposto.

Nomi che si scansionano puliti
  • Avatar (2009).mkv — includi 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 extended convivono sotto un'unica voce — <b>Edizioni alternative</b> 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 — latenza minima, 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 immagine embedded, più i file sidecar accanto ai media, e una traccia generata dal parlato quando il file non ne ha.
  • Audio HD — l'audio originale è servito intatto ai player nativi; phone e tablet puntano su copertura formati, sottotitoli e HDR.
  • Tone mapping HDR — sorgenti HDR10 adattate a SDR con accelerazione GPU dove supportata.
  • Resume — 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 la household, i suoi profili e ogni server collegato.

Free

L'esperienza self-hosted locale completa, per sempre: client nativi, transcodifica hardware, abbinamento, varianti multi-file, profili illimitati e accesso remoto fai-da-te.

Pro

Tutto in Free, più il web client premium hosted e il relay gestito zero-config per l'accesso da ovunque.

Max

Tutto in Pro, più l'editor delle battute dei sottotitoli e la traduzione sottotitoli AI on-demand da sorgente testo, immagine o audio; più avanti, TV live HDHomeRun/EPG con registrazioni programmate e preset di tema supportati.

Founders. Disponibilità live, cap globale e date dei vantaggi sono confermati nella pagina piani. Gli account Founder hanno il prezzo promesso di €69 per Lifetime Max fino al 31 dicembre 2026. Vedi i piani per il dettaglio completo.

Accesso remoto

Raggiungi il tuo server da fuori casa in due modi — uno lo gestisci tu, uno lo gestiamo noi.

Fai-da-te · Free

Apri una porta, usa un reverse proxy o un tunnel come Tailscale. Quven non ti fa mai pagare per raggiungere il tuo server — questo resta gratis.

Relay gestito · Pro

Accedi con il tuo account e il client compone il tuo server attraverso il relay di Quven — niente port-forwarding, niente DNS, funziona dietro NAT rigido. Si applica un'allocazione di banda fair-use.

API di integrazione · Free

Punta Homepage, Grafana o uno script sul tuo server con una chiave in sola lettura che non può scrivere nulla. <a href="/api/integration/v1/">Riferimento e documento OpenAPI</a>.

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 sidecar accanto ai media, incluse le coppie .idx e .sub. Le tracce immagine DVD, VobSub e PGS vengono impresse quando serve oppure riconosciute in testo. Lo stile ASS avanzato è preservato sui client nativi.

Il DRM di streaming (Widevine, PlayReady, FairPlay) è fuori scope. Quven serve i tuoi file.

Privacy e diagnostica

Local-first per design. La diagnostica è dichiarata, ripulita e attiva per impostazione predefinita con opt-out.

  • Account richiesto — il primo accesso e il refresh periodico del token richiedono internet; la grazia offline è di circa sette giorni.
  • Ripuliti — 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 watchlist, valutazioni, recensioni e posizioni di ripresa si sincronizzano tramite Quven Account.

Lingue

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

EnglishItalianoFrançais

Risoluzione problemi e FAQ

Le risposte rapide alle cose che capitano più spesso.

Configurazione e librerie

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 Correggi abbinamento per scegliere il risultato corretto. Le scansioni sono sempre avviate da te — riavvia la scansione dopo aver rinominato.

Ho lo stesso film in 4K e 1080p — avrò due voci separate?

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

Quven continua a scansionare le cartelle in background?

No. Le scansioni sono avviate dall'utente, quindi niente tocca i tuoi dischi finché non lo chiedi. Avvia una scansione dopo aver aggiunto file; il progresso viene mostrato in tempo reale e una scansione annullata può essere ripresa.

Un cruscotto o uno script possono leggere il mio server?

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

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.

Qual è la differenza tra direct play e transcodifica?

Il direct play trasmette il file originale intatto — latenza minima, nessuna CPU aggiuntiva. 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ì. Chiedi un sottotitolo nel player 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 la generazione è gratuita. Un amministratore installa il modello vocale una volta, su richiesta; pesa circa mezzo gigabyte e viene scaricato solo quando serve davvero.

La riproduzione va in buffer quando guardo dall'esterno di 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.

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ì. Il playback self-hosted locale completo — client nativi, transcodifica hardware, abbinamento libreria, varianti multi-file, profili illimitati e accesso remoto fai-da-te — è gratuito per uso domestico, per sempre. Pro aggiunge servizi gestiti; Max aggiunge anche power tool premium dichiarati, e quello che la pagina dei piani elenca come gratuito resta dov'è.

Quanto costano Pro, Max e Lifetime?

Pro e Max seguono questo percorso: fino al 30 settembre 2026: Pro €2,99 al mese o €29,99 all'anno, Max €5,99 al mese o €59,99 all'anno; dal 1 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 ti dà Max con un solo pagamento: €99 fino al 30 settembre 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. Gli account Founder possono acquistare Lifetime Max a €69 fino al 31 dicembre 2026. Gli acquisti aprono il 15 settembre 2026. Gli sconti newsletter valgono solo sui prezzi pieni annuali o Lifetime e non si sommano al prezzo Founder.

Quali dati raccoglie Quven su di me?

Quven Account memorizza l'identità, i server collegati e i dati di profilo necessari per sincronizzare watchlist, 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 opt-out nelle impostazioni; i report di crash e riproduzione rimuovono percorsi di file, indirizzi ed email.

Piattaforme e roadmap

Esistono app per mobile e TV?

I client desktop Windows e macOS, il web client hosted Pro, l'app nativa iPhone e iPad e l'app Android nativa per phone, tablet e Android TV sono disponibili oggi. macOS è firmato e notarizzato per Intel e Apple silicon, mentre Linux v1 è server-only per x64 e ARM64 — come AppImage o immagine Docker firmata — con ARM64 verificata su Raspberry Pi 4; il suo client desktop è previsto dopo la v1. Una sola scheda Google Play copre tutti e tre i fattori di forma Android. La stessa build ten-foot è verificata su Fire TV e arriva più avanti sull'Amazon Appstore; l'app Apple TV segue dopo il lancio, e i wrapper Smart TV dopo di essa.

Posso spostare la mia libreria da un altro media server?

Sì. La struttura delle cartelle è la stessa idea: punta Quven sulle cartelle dei media esistenti e le scansiona e abbina. 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 in piedi.

E per la musica?

La musica è in preparazione per la prossima release e sarà gratis su ogni piano. Non è ancora nei download. Su Desktop potrai indicare 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. Cosa succede fra i brani? La riproduzione è continua, ma un browser che deve ricodificare può aggiungere padding udibile. Ascoltare su Desktop tramite VPN o reverse proxy propri resta gratis anche fuori casa; il web hosted e il relay gestito richiedono Pro.

Ancora bloccato?

Vai al supporto