A Stremio Client Built for Adventure!

Offering things like a native player, a stream ranking engine, Wikidata, watch parties, PiP, DVR, Live TV, anime, a theme engine, and much more. Check out our website at www.harbor.site for an immersive experience.

         

Why Harbor · Features · Install · Configuration · Architecture · FAQ · Contributing

_{Harbor on launch: a rotating hero, Continue Watching, and full width rails. Works on Cinemeta out of the box; richer with a free TMDB key.}

Thank you so much for making this project better!

Harbor is a self contained desktop client for the Stremio ecosystem. Out of the box it runs on Cinemeta. Add a free TMDB key and it blossoms into your ultimate companion for discovering and watching content. Harbor was built around the Stremio addon ecosystem with deep native integration of popular services and features into the UI.

• A native player. libmpv decodes virtually any codec and container, with HDR passthrough, skip intro/outro, Anime4K upscaling shaders, and more. Delivering the same quality you are used to, but on a native custom player.
• Customize it your way. Harbor is built in rust and tauri, allowing full on demand customization of the entire application. Harbor does not inject into stremio web, it is its own from scratch shell, layered over the stremio ecosystem, allowing you to go beyond the traditional themeing. Customize the player's UI, your fonts, seek bar, colors or the entire thing!
• Theme Studio & Editor Noob friendly theme studio lets anyone create their own custom theme with no code. Those that want control over every file can use a built in code editor for your themes.
• Intelligent stream ranking. A pure Rust engine (compiled to WASM, with a TypeScript fallback) that parses every stream, filters out scams and fakes, and ranks high quality sources first.
• Corpus Engine. During the initial release of In-cinema movies, Harbor gates the results based on heuristic factors like file size, average quality consensus, year and metadata ranking and other factors to deliver you a cleaner experience during the period of a fresh release. Harbor will surface the most likely CAMS, TeleSyncs/Telecines and other reasonable options without you needing to do anything.
• Go Deep. Dive deep into your favorite shows, actors, genres and more. View lists of award recipients for the Oscars, BAFTA, Cannes, SAG, and more. Anime cast and award metadata, along with Episode/Season Deduplication and Merge. Your rows learn from your watch history and likes, to always suggest you your next best watch.
• Robust Appstore. Harbor allows you to configure and install addons without leaving the desktop client by allowing you to natively install third party addons via a built in viewport. Easily manage your installed Addons and Browse for new ones in a bespoke experience that merges the Stremio Community addons API with the Stremio-addons.net API, giving you wide coverage and custom reccomendations.
• Stremio-addons.net Integration. The first platform with direct community ratings, top trending, and manifest feed to the Stremio-addons.net API
• Watch together, on your own relay. A synced watch party with live on screen cursors and drawing, on a relay that deploys to your own Cloudflare account in one click. No central server.
• Live TV and Multiview. Bring M3U or Xtream playlists and get a real EPG grid guide, favorites, catchup, and up to four channels at once in a grid. Missed the show? play a rerun or record the next episode using built in DVR. Switch channels while in the live player at any time with the TV Guide
• Stream switcher In player switcher allows you to hop streams if you get served a bad one without leaving the player and going through results again. Play next episodes with ease on the player UI controls or in a full "Next Up" sidebar.
• Casts across the room. DLNA/UPnP, Chromecast, AirPlay, and Roku via a bundled Rust cast server and a web cast receiver.
• Integrations. Feature rich discord rich presence integration, webhooks for Discord and Telegram, Trakt Sync, and native integrations to TMDB, OMDB, Fanart.Tv, RPDB and more! Customize the location and what badges are shown.
• And much more! (seriously this would be very long)

▲ back to top

Detail page · ratings from IMDb, Rotten Tomatoes, and MAL, award laurels, cast and crew, episodes, and region aware Watch on chips.	Discover · up to 14 rotating daily rails tuned by what you open, play, and save, plus a daily Critics Pick.
Player · native libmpv, trickplay seek previews, skip intro/outro, and a customizable seek bar.	Live TV · M3U and Xtream playlists rendered as a real EPG grid guide with favorites and catchup.
Multiview · one, two, three, or 2x2 streams at once, with independent audio focus per tile.	Together · synced playback, a live chat overlay, on screen cursors, and collaborative drawing.
Themes · eleven presets and a full visual studio. Colors, fonts, card and button shapes, backgrounds, and the entire nav layout.

Harbor is organized into ten primary rooms, each with its own cinematic hero and curated rails, plus per title flows layered on top.

Per title flows add Detail, Person, Award, Service, and Filter views on top of the rooms above, each with full backdrops, clickable award laurels, drill down modals, and per key scroll memory.

▲ back to top

When you press play, Harbor collects stream offers from every installed addon in parallel and runs them through a four stage pipeline. Inside the desktop app this runs in harbor-core, a pure Rust crate compiled to WASM and invoked from the UI, with a TypeScript fallback if it is ever unavailable.

parse  ->  trust  ->  score  ->  rank

Debrid services are checked live and uniformly: Real-Debrid, AllDebrid, Premiumize, Debrid-Link, and TorBox. Cache hints embedded by popular addons are read directly, and every torrent hash is cross checked against your debrid library to catch what the cache API misses. No debrid is required: Harbor can stream torrents directly through the bundled Stremio Server engine. All keys stay on your device.

▲ back to top

A native libmpv player, with HLS and MPEG-TS engines for live and broadcast sources, and an Auto mode that picks the right backend per source.

▲ back to top

Send any playback across the room through a bundled Rust cast server and a web cast receiver.

• Chromecast via Harbor's own CAF receiver (HLS, MP4, and unknown formats). (Visit harborstremio/cast-receiver-chrome)
• DLNA / UPnP with vendor aware handling for Samsung, Sony, LG, Panasonic, and Hisense.
• AirPlay discovery and playback.
• Roku via the ECP protocol, with guidance for network access and Media Assistant. (Pre and post roku update) Does require Roku tv addons
• An optional "always re-encode" path pipes streams through ffmpeg (H264 + AAC + MPEGTS) for maximum receiver compatibility, and playback resumes locally when casting stops.

▲ back to top

• Create or join a room with a six character code; invite by link.
• Synced play, pause, and seek with RTT adjusted clock alignment so everyone stays together.
• Live chat, on screen cursors with named colors, and collaborative drawing over the video.
• A host can summon everyone to a view or a title and send play invites that late joiners receive on connect.
• The relay deploys to your own Cloudflare account in one click (deploy, check, and delete from inside Harbor). There is no central Harbor server in the loop.

▲ back to top

▲ back to top

Anime is a first class room with its own metadata stack. Metadata comes from Kitsu and AniZip for cross database ID mapping and per episode detail, with TMDB matching for logos and backdrops. Award winners from the Crunchyroll Awards, TAAF, JMAF, r/anime, and Animation Kobe are surfaced first and badged. Detail pages show MAL scores, streaming service chips (Crunchyroll, HIDIVE, Funimation and more), and an award corner. AniSkip drives skip intro/outro, and Anime4K shaders sharpen playback.

▲ back to top

The Addons room is a full browser and installer for the Stremio ecosystem.

• Discover trending and top community addons via the stremio-addons.net index.
• Browse by category and open an addon's detail page with related and recommended addons.
• Install from the catalog, add by URL, or follow a harbor:// / stremio:// deep link.
• Configure addons that require setup: Harbor opens the addon's own configuration view rather than installing without it.
• Manage installed addons, which also sync to your Stremio account collection.
• An age gate keeps adult addons behind an explicit opt in.

▲ back to top

Harbor's theme engine changes more than colors. A theme can reshape the entire navigation layout.

▲ back to top

Awards laurels surface across detail pages, covering Oscar, Emmy, BAFTA, Golden Globe, SAG, Cannes, Berlin, Critics Choice, and Annie/Kobe honors.

▲ back to top

• Multiple profiles, each with its own parental settings, content hiding, and PIN. Switching profiles resets unlocks.
• Parental controls that PIN gate any room and hide Anime or Live TV per profile.
• A player layout editor with drag and drop placement of the on screen HUD.
• Languages with 26 options and reordering.
• Hotkeys with a rebind UI and conflict detection.
• Bandwidth controls including a cap and a built in speed test.
• Library repair for your Stremio library.
• Region awareness across 40+ regions, driving theatrical windows and streaming availability.
• Notifications via Discord webhooks and Telegram, with calendar sources, media type filters, and per rule routing.
• Discord Rich Presence with poster art, live progress, and watch party size.
• A built in bug reporter that auto collects safe diagnostics (no secret values).
• Backup and restore of your full setup to a .harbx file.
• Classic Stremio home mode that renders every addon catalog row.
• Deep links for harbor:// and stremio://, with single instance focus.
• Custom CSS, JS, and HTML overlays for power users.
• Trickplay scrub previews decoded on the fly for torrents and local files, so the seek bar shows the exact frame you are hovering.

_{Trickplay seek previews, generated live for torrents and local files.}

_{Discord Rich Presence, cycling live as you browse and watch.}

▲ back to top

Harbor is built to keep your data on your machine.

• No telemetry. Harbor collects no analytics and sends nothing home.
• Your keys stay local. TMDB, RPDB, OMDB, Trakt, and debrid credentials live on your device.
• No central server. Watch party relays deploy to your own Cloudflare account, and casting runs on your own network. Nothing is routed through a Harbor operated backend.
• A built in privacy blocker at the WebView level, with a live counter.
• You choose your sources. What metadata and streams Harbor sees is entirely determined by the addons and services you configure.

▲ back to top

Download the latest build for macOS or Windows from the Releases page, or open Harbor in your browser.

_{Harbor running natively on Linux, in a Together watch party.}

Linux is up and running natively, and it is in active testing right now. We decided to take a couple extra weeks so the native player feels great for full time Linux users before we call it ready. Coming soon.

Out of the box, Harbor works on Cinemeta. You can browse, play, and cast immediately. Adding a free TMDB key in Settings is optional and unlocks the richer trending, theaters, per service, and Watch on experiences described above. Your installed Stremio addons merge in automatically when you sign in, deduplicated against the built in rails.

▲ back to top

All keys and preferences live in Settings and persist locally. Nothing is sent to a Harbor server.

▲ back to top

Harbor is a Tauri 2 app: a React + TypeScript frontend and a Rust shell, with the stream engine living in the harbor-core Rust crate.

Prerequisites

• Node.js 20+ and pnpm
• The Rust toolchain (stable)
• The Tauri 2 system prerequisites for your OS
• wasm-pack (only needed to rebuild the WASM stream core)

pnpm install
pnpm tauri dev

pnpm dev

pnpm install
pnpm tauri build

cargo test --manifest-path harbor-core/Cargo.toml
wasm-pack build harbor-core --target web

▲ back to top

flowchart TD
  subgraph Window["Harbor window (WebView2)"]
    UI["React 19 + TypeScript + Tailwind v4"]
    Core["harbor-core (Rust to WASM)<br/>parse to trust to score to rank"]
    UI --> Core
  end

  subgraph Shell["Tauri 2 Rust shell"]
    Player["libmpv player"]
    Cast["Cast server (DLNA / Chromecast / AirPlay / Roku)"]
    Sidecars["Sidecars: stremio-server, yt-dlp"]
  end

  subgraph Net["Open ecosystem and services"]
    Stremio["Stremio addons + Cinemeta"]
    Meta["TMDB / RPDB / OMDB / Fanart"]
    Anime["Kitsu / AniZip"]
    Trakt["Trakt"]
    Debrid["Debrid: RD / AD / PM / DL / TorBox"]
    Relay["Your Cloudflare relay (Together)"]
  end

  UI --> Shell
  UI --> Stremio
  UI --> Meta
  UI --> Anime
  UI --> Trakt
  Core --> Debrid
  UI --> Relay

src/                 React frontend (views, chrome, components, lib)
src-tauri/           Rust shell, player, casting, sidecars
  src/               cast.rs, dlna.rs, roku.rs, airplay.rs, transcode.rs, discord_rp.rs, ...
harbor-core/         pure Rust stream engine (parse, trust, score) -> WASM
cast-receiver/       web cast receiver app
docs/media/          logos and screenshots

▲ back to top

Directional, not a set of promises. Priorities shift with feedback.

• Native libmpv player with trickplay and skip segments
• Rust stream ranking core (harbor-core) compiled to WASM
• Watch parties with cursors and drawing on a self hosted relay
• Live TV EPG guide and Multiview
• First class anime room with Kitsu and AniZip
• Theme studio with custom layouts
• macOS, Windows, and web launch builds
• Native Linux build (in testing, a couple weeks of native player polish to go)
• Expanded casting device matrix (AirPlay 2, more Roku and Chromecast targets)
• More translations
• A growing theme gallery

▲ back to top

Does Harbor provide content? No. Harbor hosts and indexes nothing. It is a client for the Stremio addon protocol, and what you can browse or play depends entirely on the addons and services you configure.

Do I need a TMDB key? No. Harbor works out of the box on Cinemeta. A free TMDB key is recommended because it unlocks trending rails, in theaters, top rated, per service rows, and Watch on chips.

Is Harbor affiliated with Stremio? No. Harbor is an independent open source client built on the open Stremio addon protocol, by someone who loves the ecosystem.

Why Tauri instead of Electron? Tauri uses the system WebView and a Rust backend, which keeps the app small and lets the stream ranking core run as compiled WebAssembly.

Do I need a debrid account? No. You can stream torrents directly through the bundled Stremio Server engine. A debrid service is optional and adds cached, instant playback.

▲ back to top

Contributions are very welcome, whether that is code, a bug report, a theme, or a docs fix.

Getting started

1. Fork the repo and clone your fork.
2. Follow Build from source to get a dev build running.
3. Create a branch, make your change, and run pnpm build to verify the frontend compiles.
4. Open a pull request with a clear description of what changed and why, with screenshots for UI work.

Filing issues

• Found a bug? Open an issue with steps to reproduce. Harbor also has a built in Report a Bug form in Settings that attaches safe diagnostics for you.
• Have an idea? Start a discussion or open a feature request issue.

We aim to respond to issues and pull requests promptly. Be kind, be specific, and assume good faith. We are glad you are here.

▲ back to top

▲ back to top

Harbor stands on the shoulders of a generous open ecosystem and the people who build it.

• The Stremio addon protocol and the Stremio team, for an open, well designed standard worth building on.
• The Stremio-addons.net Team for providing an excellent service (please consider supporting them).
• @stass_motion for the lottie animations, he is fantastic consider supporting him.
• Cinemeta and the wider addon community, whose work makes the experience possible out of the box.
• TMDB, Trakt, OMDB, Fanart.tv, RPDB, Kitsu, and AniZip for the metadata that brings catalogs to life.
• libmpv for a world class playback engine, and the Anime4K project for its upscaling shaders.
• Tauri, React, Vite, Tailwind CSS, Rust, and Lucide for the foundation.
• OpenSubtitles, Wyzie, AniSkip, and TheIntroDB for subtitles and skip data.

Thank you to everyone, named and unnamed, whose open work Harbor builds upon.

▲ back to top

MIT © 2026 Harbor contributors. Free Speech!

_{Built with care for the people who love good cinema and an open web. ▲ back to top}