Couchside

A fast, lightweight media server for your movies, shows and live TV.

Download Source on GitHub
Couchside's home page: the newest title, library counts and Continue Watching

Fast and light

One small binary with its database built in. Runs on a NAS, a Pi or k3s.

Local only

No cloud account, no telemetry. Everything it fetches is cached on your server.

Live TV and DVR

HDHomeRun guide, series recordings, commercial skipping, and channels made from your library.

Phones, browsers and TVs

A web app that works on phones, a full-screen player with quality presets, and a Roku app.

Also: TMDB matching with cast and artwork, GPU transcoding (VAAPI in the container, NVENC and Quick Sync on Windows), HDR tone mapping, and profiles for the whole household.

A look around

The Movies library as a grid of posters

Your library, with its artwork

Point it at a folder and it finds every film and show, matches them on TMDB and fetches posters, backdrops, cast and plots. Browse by genre, year, rating or what's unwatched.

A film's page: poster, details, the file and where you left off

Everything about a title, at a glance

Details, versions and extras, seasons and episodes, and where you left off. Fix a wrong match or edit the details yourself.

The full-screen player, paused partway through a film

Plays what you have

Direct when the browser can, converted when it must, with GPU transcoding and HDR tone mapping. Subtitles, audio tracks and quality presets, in a player that gets out of the way.

The live TV guide, with channels made from the library

Live TV, and channels of your own

An HDHomeRun guide with series recordings and commercial skipping. Or make channels from your own library: a movie night, a show on repeat, a kids' channel.

Home on a phone A film's page on a phone

From the couch, or the phone in your hand

The same library on every screen in the house: a web app that fits a phone, and a Roku app for the TV.

Choosing who's watching from the household's profiles

One server, the whole household

Profiles with their own progress, lists and rating limits, so the kids see what's theirs and nobody loses their place.

Run it

docker run -d --name couchside -p 8080:8080 \
  -v couchside-data:/data -v couchside-cache:/cache \
  -v /path/to/media:/media \
  ghcr.io/timothydodd/couchside:latest

Open http://localhost:8080 and add a library. For live TV, add -e COUCHSIDE_HDHOMERUN=<tuner IP> and -v couchside-recordings:/recordings. Docker Compose, zips, Helm and more in the install guide.