hyve
Self-hosted · version 0.2.0

Track what you watch.
Play what you own.

hyve is a media tracker and streaming guide you run yourself. Start with Discover and your lists—no files required. When you are ready, point hyve at folders on your NAS or PC and those titles become available for Instant Play on your network.

Free software. No ads. No analytics in the app.

Illustration — My hyve home (Continue Watching and Next Up)

How it works

Tracker first. Library when you want it.

Most people begin with the guide and their lists. Add media folders only when you want playback from your own copies.

Discover and decide

Browse the full catalog—trending, genres, search—and see where each title streams in your country. Your watchlist and favorites work with or without local files.

Track your place

Continue Watching and Next Up keep movies and shows in motion. Progress, lists, and ratings stay on your server, per profile.

Instant Play (optional)

Add library folders and hyve indexes them. Titles on disk show an Instant Play badge and play in the browser—direct when possible, transcoded when needed.

Streaming guide

One catalog. Every way to watch.

Discover covers the whole TMDB catalog—not only what you own. Owning a file does not hide or reorder search results; it adds an on-server play path when you have one.

  • Where to stream — subscription, free, and ad-supported options for your region (TMDB + JustWatch data).
  • Trending, new releases, networks, studios, genres, trailers, and scores.
  • Rows informed by your favorites, watch history, and watchlist—stored locally on your server.

hyve does not sell or bundle streaming subscriptions. You bring your own TMDB API key; trailers load from YouTube only when you press play.

Watch tracker

Pick up where you left off.

My hyve is built around two rows: what you have started, and what is next for the shows you follow. Everything is per profile—personal or shared.

  • Continue Watching — resume movies and in-progress episodes.
  • Next Up — the next catalog episode for shows you follow, even when you do not own the file yet.
  • Watchlist, Favorites, Watched marks, and Playlists.
  • Optional in-app notifications when something on your lists becomes available for Instant Play.
Your files (optional)

Libraries for Instant Play.

Point hyve at movie and TV folders. It scans names, matches metadata, and plays from your server. You can run a great tracker with zero libraries, or grow into a full home cinema.

  • Direct play when the browser handles the file; HLS transcode or remux when it does not.
  • Hardware acceleration on Intel, NVIDIA, Apple, and AMD where available.
  • Sidecar subtitles and embedded text tracks; image-based subs can burn in during transcode.
  • Optional library optimize schedules—remux to MP4 and add a stereo AAC track so more clients play smoothly (you opt in per library).
Connected hyves

Share with people you trust.

Link your server to friends or family. When a title you want exists on their hyve, you can request a copy—verified by checksum—into your library.

  • Private connections only; no public library directory.
  • Per-connection API keys with browse and download permissions you control.
  • Playback can start while a transfer is still finishing when enough of the file has arrived.
  • HTTPS required off your home network unless you explicitly allow LAN HTTP.
Profiles

Everyone gets their own view. Together, too.

Personal profiles for each person, plus shared profiles for the couch. PINs and content ratings keep kids’ screens appropriate.

Personal profiles

Separate progress, lists, and recommendations for each account member.

Shared profiles

Watch as “Family” with sync rules you choose—history, lists, or playlists.

PINs and ratings

Lock profiles and cap content from Kids through Unrestricted.

Live TV (optional)

Your channels in one guide.

Households can enable Live TV: IPTV playlists, HDHomeRun tuners, XMLTV guide data, recordings, and personal virtual channels—all optional.

  • Channel lineup you curate—logos, numbers, categories, and favorite channels per profile.
  • Virtual channels — playlist-backed channels in the same guide.
  • Record from the guide where your sources support it; recordings library for playback later.
  • Capabilities depend on source and setup (timeshift and scheduling vary). Advanced DVR features continue to ship in updates.
Every screen

Browser today. Built for the living room.

hyve ships as a modern web app—desktop, phone, or TV browser. Pair a TV with a short code from a phone you already signed in on; no typing passwords with a remote.

Dedicated native apps for TV, phone, and tablet are planned; today’s experience is install-free in the browser.

Web app

Full UI in Chrome, Safari, Firefox, and Edge. Responsive layout from phone to TV browser.

TV sign-in

Open /tv on the big screen, enter the code on your phone, pick a profile—done.

Sync across devices

Progress and lists follow the profile you chose—not the device.

Plays what you have

Instant Play from your libraries with direct play or transcoding and subtitles.

Private by design

Your server. Your data.

Accounts, history, and settings live in a database on hardware you control. Media stays in folders you choose.

No ads or in-app trackingThe hyve application does not include advertising or analytics SDKs.
Self-hostedDocker image or Node.js 24 on a NAS, mini PC, or home server.
Strong sign-inTwo-step verification by default. Passkeys and OpenID Connect supported.
Trusted home networkPick LAN ranges where the profile picker can open without a password.
BackupsExport and restore server settings and data from Admin (not your video files).
Metadata you provideTMDB for catalog; optional OMDb for extra scores; YouTube for trailers on demand.
Get started

Run hyve 0.2.0 at home.

Early access is still by invitation while we polish onboarding. If you already have access, deploying with Docker takes a few minutes.

Production Docker (recommended):

# Authenticate to GitHub Container Registry once (private image; use a PAT with read:packages)
docker login ghcr.io

# In your hyve deploy folder — copy .env.example to .env, set HYVE_DATA and HYVE_MEDIA_ROOT
docker compose pull
docker compose up -d --no-build

# Open http://YOUR_SERVER:8787 — first account becomes admin; enroll MFA, then add libraries

Pin the image to ghcr.io/cellio-dev/hyve:v0.2.0 for predictable upgrades. Back up your data directory before updating. Developers can also build from source with Node.js 24 and FFmpeg.

Questions

Does hyve include movies, shows, or streaming subscriptions?

No. hyve is software you run. It shows where titles stream so you can decide, and it plays media files you add. Nothing is bundled or sold.

Do I need a library of my own files?

No. Discover, lists, and tracking work without one. Add folders when you want Instant Play from your own copies.

Is hyve free?

Yes—the application is free to self-host. Optional sponsorship tiers (coming) will pay for connected services like DDNS and remote settings backup, not for content.

What do I need to run it?

A machine that can run Docker or Node.js 24 and FFmpeg. A modest CPU is fine; a GPU helps if you transcode often.

Are there native mobile or TV apps?

Not yet. Use the web app in a browser today; sign in on a TV with a device code. Native apps are on the roadmap.