Skip to content

Documentation

Run Quven from install to playback.

Install the server, connect your devices, and stream your library the way you set it up. Everything below reflects what is available now, and marks what is still to come.

Overview

Quven is a self-hosted media server for your movies, TV shows, documentaries, music and books. You install it on a machine you own, point it at your folders, sign in with a free Quven Account, and stream to desktop, web, and native mobile apps on your devices, at home and, if you want, from anywhere. Your media files stay on your hardware.

Self-hosted Your media lives on your hardware. Quven does not host your files.
Native-first Premium native apps lead; the web client, included with Pro, covers any other screen.
Free for personal use Playing your own library costs nothing, forever.
Household profiles Unlimited profiles on every tier, with personal state synced to Quven Account.

Install the server

Download the installer for your platform from quven.tv/download. Everything is included, so nothing else needs to be installed.

Windows .msi Windows 10 and 11. One-click installer with automatic updates.
macOS .pkg For macOS 13 and later on Intel (x64) or Apple silicon (ARM64). Signed and notarised by Apple.
Linux AppImage Server-only x64 and ARM64 AppImages available, ARM64 verified on a Raspberry Pi 4. A Linux desktop client is planned.
  1. Install and launch. The server starts automatically in the background.
  2. Sign in or register. Quven clients start from Quven Account at accounts.quven.tv .
  3. Link the server. On first run, attach the server to your account; that account becomes the owner.
  4. Add a library. Point Quven at your media folders and run a scan (below).
  5. Pick a profile. Create household profiles, optionally add PINs, then choose who is watching.

Connect your devices

Sign in first, then pick a local server the app found on your network, or a remote server already linked to your account. The native apps give you the best playback; the web client is there for quick access and guest machines.

Native desktop app

The native desktop app runs on Windows and macOS, with signed and notarised macOS packages for Intel and Apple silicon; on Linux, Quven runs as a server, and a Linux desktop app is planned. Full direct play, hardware decoding, untouched HD audio and advanced subtitles.

Web client

Opens in any modern browser once you have signed in to your Quven Account, and comes with Pro. It suits a guest's computer or quick access with nothing installed, with a cinematic interface and playback over HLS.

Native Android app

Available on Google Play. One listing covers phone, tablet and Android TV: touch layouts that adapt to the screen in your hand, and navigation designed for the remote on the television. The same app is published for Fire TV on the Amazon Appstore.

Native iPhone and iPad app

A native app for iPhone and iPad, with layouts designed for the iPad, controls that follow the pointer, keyboard shortcuts, widgets, picture-in-picture and AirPlay. Available on the App Store for iOS and iPadOS 17 and later; an Apple TV app is planned.

On a different subnet or VPN? Enter the server address manually instead of relying on automatic discovery. The iPhone and iPad app is on the App Store; the Android app is on Google Play for phone, tablet and Android TV, and on the Amazon Appstore for Fire TV; apps for Apple TV and for Smart TVs are planned.

Libraries & scanning

Add a folder, choose a type, and Quven matches its contents against four catalogues. Scans start when you ask for them, or automatically with Pro.

Add a library

In server settings, create a library, choosing its type among Movies, TV Shows, Documentaries, Music, Books and the other kinds offered, and point it at a folder on the server machine. Run a scan; progress shows live and a cancelled scan can be resumed.

Matching & metadata

Each file is matched from its name against TMDb, TVDB, OMDb and AniDB. Optional AI disambiguation resolves tricky cases. If a match is wrong, open the item and choose Change match to pick the right title. Each catalogue gets its own tab, and every result names the catalogue that answered.

File names that match reliably
  • Avatar (2009).mkv: include the year
  • Breaking Bad/Season 1/S01E01.mkv: episodes by season
  • Inception/Inception.2010.2160p.mkv + Inception.2010.1080p.mkv: variants of one title

Multiple files per title. 4K + 1080p, different audio languages, theatrical and extended cuts all live under one entry. Alternate editions names what differs between them and plays the one you choose.

Playback

Quven plays the original file untouched whenever the client can handle it, and transcodes only when it must.

Direct play

Streams the source as it is over the network, with the lowest latency and no transcoding. Used when the client supports the video, audio, container and subtitles natively, which the desktop apps do for far more formats than browsers.

Hardware transcoding

When direct play is not possible, the server transcodes on the fly, using your GPU where available (NVIDIA, Intel, AMD, Apple). HDR sources are tone-mapped to SDR for clients that need it.

  • Subtitles. Embedded text and image tracks plus sidecar files next to your media, and a track generated from the dialogue when the file has none.
  • HD audio. The original audio is served untouched to the native players; phone and tablet clients focus on format, subtitle and HDR coverage.
  • HDR tone-mapping. HDR10 sources are mapped to SDR with GPU acceleration where supported.
  • Resume. Picks up where you left off, per user, including the next episode of a show.

Account & plans

Quven Account is the single identity for desktop, web, and native mobile clients. One account covers the household, its profiles and every server linked to it.

Free

Playing your own library, forever: native clients, hardware transcoding, matching, multi-file variants, unlimited profiles and do-it-yourself remote access.

Pro

Everything in Free, plus the hosted premium web client and zero-config managed relay for access from anywhere, subtitles written from the audio, automatic scanning, 3D films kept as their own edition, the complete ebook edition, managed AI matching, a cloud backup of the library, game controller support on the Windows desktop, a server shared with up to 25 people, more capacity on the Quven metadata service and priority email support within 48 working hours.

Max

Everything in Pro, plus the subtitle cue editor and on-demand AI subtitle translation from a text, image or audio source, a spoiler-free who's who, private corrections and your reading measured in the ebooks, a repaired copy of an audio file or an EPUB the scan could not read, 360° video on the desktop, a server shared with up to 50 people, or 150 with Lifetime, the most capacity on the Quven metadata service and support within 24 working hours; later, HDHomeRun/EPG live TV with scheduled recordings and supported theme presets.

Founders. The programme is closed: all 100 places were claimed. Founder accounts keep the promised €69 Lifetime Max price through 31 December 2026. See the plans for the full breakdown.

Remote access

There are two ways to reach your server from outside your home: one you manage yourself and one Quven manages for you.

Do-it-yourself · Free

Open a port, use a reverse proxy, or a tunnel such as Tailscale. Reaching your own server this way is free on every plan.

Managed relay · Pro

Sign in with your account and the client dials your server through Quven's relay, with no port-forwarding and no DNS, and it works behind strict NAT. A fair-use bandwidth allowance applies.

Integration API · Free

Connect Homepage, Grafana or a script to your server with a read-only key that cannot modify anything. Reference and OpenAPI document.

Supported formats

Native clients direct-play a wide range; browsers receive a transcoded stream when they cannot decode the source.

Containers

MKV, MP4, WebM and more, served as they are to native clients, and remuxed or transcoded to HLS for browsers.

Video

H.264, HEVC, AV1, VP9 direct-play on native clients. Browsers get H.264 (or HEVC where supported) via transcode. VVC sources play through transcode.

Audio

AAC, AC3, EAC3, DTS, TrueHD and FLAC on native clients, served untouched; browsers fall back to stereo/AAC when they cannot decode a track.

Subtitles

SRT, ASS and VTT text tracks, plus sidecar files stored beside the media, including .idx and .sub pairs. DVD, VobSub and PGS image tracks are drawn by the native apps or burned in when a browser needs them. Advanced ASS styling is preserved on native clients.

Streaming DRM (Widevine, PlayReady, FairPlay) is out of scope. Quven serves your own files.

Privacy & diagnostics

Local-first by design. Diagnostics are disclosed, scrubbed and default-on with an opt-out.

  • Account required. First login and periodic token refresh need the internet; offline grace is seven days.
  • Scrubbed. If enabled, crash and playback reports have file paths, addresses and emails removed before sending.
  • Media stays local. Your files and library folders stay on your server; profile data such as watchlists, ratings, reviews and resume points sync through Quven Account.

Languages

The apps and localized metadata ship in five languages today.

EnglishItalianoFrançaisEspañolDeutsch

Step-by-step guides

Practical guides with the commands to run, from installing the server to reaching it away from home.

Control a media server from the command line Start, check, link and update from a terminal, with script examples. Run a headless media server on Linux x64 or ARM64 chmod, start and account link from a terminal. Run a media server in Docker with Compose Compose files, GPU profiles, upgrades and signature check. Run a media server in Portainer as a stack A stack from the official Compose file, the one variable and updates. Run a media server on macOS, Intel or Apple silicon Choose the package, install it and link the server. Run a media server on Windows with a native desktop client Choose the package, check the signature and link the server. DVD and Blu-ray in a self-hosted media library Remux to MKV, names and subtitles in the browser. How to organise films and TV shows for a media server Folders, names, editions and subtitles in the right place. How to set up an audiobook library on your own media server Folders, chapters, ASIN and listening across devices. Keep two copies of a film without the library showing it twice Versions under one title, editions on cards of their own. Move a media library to a new server without risking the files One sample, the scan, then your watch history. Move your media library to a new drive without losing watch history Keep the path, or let the scan follow the files. Read ebooks and comics from your media server A Books library, calibre records, ComicInfo.xml and the reader. How to generate subtitles for a film that has none Start from the player, let the server fetch the model, use the result. How to translate subtitles with AI Pick the source track and translate from the player. Monitor your media server with Prometheus and Grafana Issue a key, read the six routes, connect Prometheus. Reach a self-hosted media server outside your home By address or relay: steps, an outside test and sharing. HDR transcoding and tone mapping on a home media server When the server converts, which backend, what the log says. Watch your media library on Android TV without transcoding Two settings, the stats check and the edge cases. Which NAS can transcode 4K, and how to check yours Read the processor, find the render node, prove it with one film.

Troubleshooting & FAQ

Answers to the most common questions.

Setup & libraries

Why did a scan miss my files or match the wrong title?

Start with the names. Put the year in, as in "Avatar (2009).mkv", and for episodes use "Show Name S01E01.mkv" or season folders. Then check that the account the server runs as can actually read the folder. If one item matched the wrong title, open its detail page and use Change match to pick the right result from the search. Unless a Pro account watches the folder, a scan runs when you start it, so after renaming anything, run one again.

Read the guide to organising a library
I have the same movie in 4K and 1080p. Will I get two entries?

No. Several files for the same title, whether 4K and 1080p, different audio languages, or a theatrical and an extended cut, all sit under one library entry. Alternate editions on the title's menu names each version by what actually differs between them (length, resolution, dynamic range, audio layout, video codec) and plays the one you pick.

Does Quven keep scanning my folders in the background?

Only if you have asked it to. Folder watching and scheduled scans sit in the Automatic scanning card under Settings and come with Pro or higher. On a Free account nothing touches your disks until you start a scan yourself; the progress is shown live either way, and a scan you cancel can pick up where it left off.

Can a dashboard or a script read my server?

Yes. Issue an integration key from Settings, on the desktop or in the browser, and send it with each request. The key can only read: no route that changes anything accepts one, and a key cannot issue another key. What it reports is the server, the libraries with their counts, and the sessions in progress. By design, it never reports which folders your libraries live in or who is watching. The integration guide covers the endpoints and both ways of sending the key.

Read the dashboard and API guide

Playback

My browser cannot play a file. Is something broken?

No. A browser cannot decode every container and codec, so when it cannot play the file directly the server transcodes it on the fly into an HLS stream the browser understands. The native desktop apps drive a desktop-class output chain with the HD audio untouched, and the Android and iPhone/iPad apps concentrate on broad codec and subtitle playback on a phone or tablet.

See how native playback works
What's the difference between direct play and transcoding?

Direct play sends the original file untouched, which gives you the lowest latency and costs the server no extra CPU. It happens whenever the client can handle the video, the audio, the container and the subtitles as they are, and the native apps can handle far more than a browser. When the client cannot, the server transcodes with FFmpeg and uses hardware acceleration where it has some.

A film has no subtitles at all. Can Quven make one?

Yes. An administrator asks for a subtitle in the player, on the desktop or in the web client, and the server transcribes the dialogue itself, then saves the result as an ordinary track that will be there next time too. The audio never leaves your machine, and the recognition runs on your own processor or GPU. Asking for one comes with Pro; once a track exists, every plan and every profile can play it. An administrator installs the speech model once, when asked; it is close to half a gigabyte, so it is downloaded only the first time it is needed.

Read the subtitle generation guide
Why does playback buffer when I watch away from home?

Away from home, the ceiling is your home upload speed. Lower the quality in the player settings, or watch in the native app, which can play the file directly where a browser would need a transcode. The managed relay (Pro) takes the network setup off your hands, but it cannot provide more bandwidth than your connection has.

Read the remote access guide

Accounts, plans & privacy

Do I need an account to use Quven?

Yes. Every client, on desktop, web and mobile, starts from a Quven Account. Sign in or register first, then pick a server the app found on your network, connect to a remote server linked to the account, or finish setting up a new one.

Is Quven really free?

Yes. Playing your library is free for personal use, forever: the native clients, hardware transcoding, library matching, several files per title, unlimited profiles, and remote access you set up yourself. Pro adds the managed services, automatic scanning and subtitles written from the audio; Max adds subtitle translation, the cue editor and the repair of damaged files. The plans page lists that free floor, which does not move. Personal use means you, your family and the guests you invite; the licence does not allow selling other people access to your library.

What do Pro, Max and Lifetime cost?

Pro and Max follow this published path: through 6 October 2026: Pro €2.99 a month or €29.99 a year, Max €5.99 a month or €59.99 a year; from 7 October 2026 through 15 November 2026: Pro €3.49 a month or €34.99 a year, Max €6.99 a month or €69.99 a year; from 16 November 2026 through 31 December 2026: Pro €3.99 a month or €39.99 a year, Max €7.99 a month or €79.99 a year; from 1 January 2027: Pro €4.99 a month or €49.99 a year, Max €9.99 a month or €99.99 a year. Lifetime includes every Max capability for a single payment: €99 through 6 October 2026, then €129 through 15 November 2026, then €149 through 31 December 2026, then €199 through 30 June 2027. Its next price after 30 June 2027 has not been announced. In the United States, the same figures are charged in dollars. Every Founder seat is taken, so the €69 Founder price is closed to new accounts; the hundred that hold it still do. Purchases are open.

What does Quven collect about me?

Quven Account keeps your identity, your linked servers, and the profile data it needs to sync watchlists, ratings, reviews and resume points. Your media files and library folders stay on your server. Diagnostics are on by default, for stability and security, with the disclosure up front and an opt-out in settings, and crash and playback reports have file paths, addresses and emails stripped before they go anywhere.

Read what stays local

Platforms & roadmap

Are there mobile and TV apps?

The Windows and macOS desktop clients, the hosted Pro web client, the native iPhone and iPad app, the native Android app for phone, tablet and Android TV, and the Fire TV app on the Amazon Appstore are available today. macOS ships signed and notarized for Intel and Apple silicon, while on Linux Quven runs as a server for x64 and ARM64, as an AppImage or a signed Docker image, with ARM64 verified on a Raspberry Pi 4, and a Linux desktop client is planned. One Google Play listing covers all three Android form factors, and the same television app is published for Fire TV; apps for Apple TV and for Smart TVs are planned.

Read the Android TV guide
Can I move my library from another media server?

Yes. The folder layout works the same way, so point Quven at the media folders you already have and it scans and matches them. If the old server is Plex or Jellyfin, Quven can also import your history straight from it: it finds the database, shows what it is about to bring over, then transfers watched state and playlists. Titles are matched by catalogue identity, so a library reorganised since then still lines up. The old server is only read, never changed, so the import can run while the old server keeps running.

Read the migration guide
What about music?

Music arrived in 1.2.0 and is free on every plan. On Desktop you point Quven at your album folders: tags come first, with folder names filling in what a file leaves out, and covers and lyrics can come from the files or their sidecars. Playback between tracks is continuous, although a browser that needs to re-encode can add audible padding. Desktop listening over your own VPN or reverse proxy stays free, even away from home; hosted Web and the managed relay require Pro.

Need further help?

Visit support