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-hostedI tuoi media vivono sul tuo hardware — Quven non ospita i tuoi file.
Native-firstLe app native premium guidano; un web client curato è il fallback universale.
Gratis per casaL'esperienza locale completa non costa nulla, per sempre.
Profili householdProfili 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.msiWindows 10 e 11. Installer one-click con aggiornamenti automatici.
macOS.pkgPer macOS 13 e successivi su Intel (x64) o Apple silicon (ARM64). Firmato e notarizzato da Apple.
LinuxAppImageAppImage server-only x64 e ARM64 disponibili; ARM64 è rilasciata senza test su hardware nativo. 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 per phone e tablet, nello scope del lancio v1 con QA su device completata. I gate di closed test e accesso alla produzione Play restano aperti. Android TV / Fire TV segue con la v1.1.

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. Resta nello scope del lancio v1 con i gate di distribuzione App Store aperti; Apple TV (tvOS) segue con la v1.1.

Su una subnet diversa o VPN? Inserisci l'indirizzo del server manualmente invece di affidarti alla scoperta automatica. Le app mobile native Android e Apple escono insieme a desktop e web; Android TV / Fire TV e Apple TV (tvOS) seguono con la v1.1, e i wrapper Smart TV con la v1.2.

Librerie e scansione

Aggiungi una cartella, scegli un tipo e lascia che Quven la abbini su TMDb. 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 su TMDb dal suo nome. Una disambiguazione AI opzionale risolve i casi difficili. Se un abbinamento è sbagliato, apri l'elemento e usa Correggi abbinamento per scegliere il titolo giusto.

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 — la pagina di dettaglio mostra un selettore Sorgenti per scegliere al play.

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 (SRT, ASS, VTT) e tracce immagine (PGS) — burn-in quando uno stream non può trasportarle.
  • 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ù gli extra Max in arrivo — la traduzione sottotitoli AI on-demand arriva con la v1.4; editor di sottotitoli, temi personalizzati e programmazione DVR seguono nelle release successive.

Founders. La finestra è aperta ed è limitata a 100 account. I nuovi account idonei ricevono Pro fino al 31 dicembre 2026, poi mantengono uno sconto Founder permanente. 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.

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; tracce immagine PGS in burn-in quando serve. 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. La pagina di dettaglio mostra un selettore Sorgenti per scegliere la variante al momento della riproduzione.

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.

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.

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ì. L'esperienza self-hosted locale completa — client nativi, transcodifica hardware, abbinamento libreria, varianti multi-file, profili illimitati e accesso remoto fai-da-te — è gratuita per uso domestico, per sempre. Il web client hosted e il relay gestito richiedono Pro; gli altri tier a pagamento aggiungono servizi che girano sul cloud di Quven e hanno un costo reale.

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 e il web client hosted Pro sono disponibili oggi. macOS è firmato e notarizzato per Intel e Apple silicon, mentre Linux v1 è server-only per x64 e ARM64; ARM64 è rilasciata senza test su hardware nativo. Il client desktop Linux è previsto dopo la v1. I client nativi Android e iPhone/iPad restano in preparazione al lancio, con i gate di closed test/accesso alla produzione Play e distribuzione App Store ancora aperti; Android TV / Fire TV e Apple TV seguono con la v1.1, i wrapper Smart TV con la v1.2.

Posso spostare la mia libreria da un altro media server?

La struttura delle cartelle è la stessa idea: punta Quven sulle cartelle dei media esistenti e le scansiona e abbina. Watchlist e valutazioni vengono aggiunte nuovamente in Quven invece di essere importate nella v1.

E per musica e foto?

La v1 si concentra su Film, Serie TV e Documentari. La musica arriva in una versione successiva; le foto sono ancora più avanti.

Ancora bloccato?

Vai al supporto