Get started

Welcome to Wren TV

Wren TV is a fast, ad-free personal media server. These docs cover watching, running a server and building on it.

Wren TV plays your movies and shows exactly as they were made. Dolby Vision and Atmos pass through untouched, and the server only transcodes when a device really can't play the file. It runs as one small program on Docker, Linux, macOS or Windows, and you watch in your browser at watch.wrentv.com or in the apps.

There are no ads, no rentals and no telemetry. Your server, your files, your watch history.

#What to read first

I want to watch something someone shared with me. Sign in (or create a Wren TV account) with the email address you were invited at, in the web player. Shared servers appear on their own.

I want to run my own server. Start with the quick start. It takes you from nothing to playing a movie in about ten minutes. Then read how Wren TV works to understand what talks to what.

I want the app for my TV, phone or Mac. See the apps: Android TV, iPhone and iPad and Mac.

I'm building something on Wren TV. The client API covers browsing and playback. The integration API lets services manage libraries and receive webhooks.

#The guides

#Apps

• Android TV and Google TV: install, sign in with your phone, the remote, Play Next and the screensaver.
• iPhone and iPad, through TestFlight.
• Mac.

#Watching

• The web player: signing in, choosing a server and what "needs an HTTPS address" means.
• Browsing your library: Home, libraries, genres, collections and search.
• Playback: versions, audio and subtitles, skipping intros, up next and keyboard shortcuts.
• Downloads: save movies and episodes to watch offline.
• Your account and shared servers: language settings and leaving a server.

#Running a server

• Install on Docker, Linux, macOS or Windows.
• First run and claiming the server with your Wren TV account.
• Libraries, naming your files and metadata.
• Collections: hand-picked, rule-based and from TMDB.
• Users and sharing with family and friends.
• Remote access: automatic HTTPS addresses, no domain needed.
• Transcoding and hardware acceleration.
• Intro and credits detection.
• Streaming with debrid: search and play any movie or show through TorBox, AllDebrid or Real-Debrid.
• Dashboard and stats, updating and the full configuration reference.

#Project status

Wren TV used to be called Haven. If you ran Haven, your data carries over: see Upgrading from Haven.

Stuck? Try troubleshooting and the FAQ.