first five minutes

Get started

Sipario is a browser-native media player. Drop a file, paste a URL, or add a Stremio-protocol addon — and play. No native app. No extension. No server transcoding. The sections below get you from a fresh visit to a playing stream in under five minutes.

step 1

Play a local file or URL

The home page accepts drag-drop of any media file and paste of a direct video URL. Both bypass the catalog and go straight to the player. Files never upload — the browser reads them from disk via URL.createObjectURL. URLs you paste are fetched directly (or through your proxy if configured).

Supported audio: AAC, AC3, EAC3, DTS Core, DTS-HD MA core, TrueHD, MP3 — decoded in-browser via a 290 KB hand-trimmed FFmpeg WASM build, no server side.

step 2

Add a metadata key (optional but recommended)

For browse-style use (films, series, channels), Sipario uses TMDB for posters, titles, cast, and metadata.

Get a free key at themoviedb.org/settings/api.
Open Settings → TMDB API key and paste it.

The key is stored in your browser only. Sipario never logs it, never sends it to telemetry. Read /privacy for the full posture.

step 3

Add a stream source

Sipario doesn't ship default content sources. You add them as Stremio-protocol addon manifest URLs. Common patterns:

Live channels. Open /channels and add an M3U playlist URL or Xtream Codes account in Settings → Channels.
Films / series catalog. Open Settings → Sources and paste the manifest URL of any Stremio-protocol addon you want to use.
Debrid. Sipario does not store debrid credentials. Install a third-party addon that handles debrid (e.g. AIOStreams) and configure your debrid API key inside that addon's URL or its own configuration page.

Sipario is not an addon directory. The choice of which addons to trust is yours; Sipario does not vet, recommend, or endorse any third-party addon.

step 4

Set up a proxy if your sources need one

Most debrid CDNs refuse direct browser fetches because they don't send the right CORS headers. The fix is a small byte-proxy you run yourself. Sipario's proxy is one Bun file (< 200 lines), no transcoding, just byte forwarding.

Open Settings → Connection.
Pick a deploy path: Fly.io (~$2/mo, 5 minutes, recommended), self-host via Cloudflare Tunnel (free, requires home Docker), or Oracle Always-Free (truly free, slowest path).
Paste your proxy's URL into Settings → Connection, click Test, then Save.

If you hit a "Couldn't fetch the stream" error after that, see /help/cors-blocked.

step 5

Add Sipario to your Home Screen (mobile)

On iOS Safari and Android Chrome, Sipario installs as a Progressive Web App — full-screen, with its own icon, no browser chrome. Audio works in the background; the lock screen shows the poster + scrubber.

iOS Safari: Share → Add to Home Screen.
Android Chrome: menu → Install app, or accept the in-page install prompt.

If something goes wrong

The watch-page error banner now links to a help page for any recognised failure mode. The current help pages are:

/help/cors-blocked — host blocks direct browser fetches; you need a proxy.
/help/no-proxy — proxy not configured; same fix.
/help/decode-failed — browser's video decoder rejected the stream after a seek. Pick another quality or source.

Bug not in that list? Open an issue on GitHub. Diagnostic logs are tagged [diag *] — open the browser console, reproduce, copy the relevant block, paste it into the issue.

Privacy at a glance

Nothing leaves your device by default. Watch progress, addon URLs, preferences, even the cluster cache for streams you've watched — all stored in your browser only. Two opt-in pools transmit SHA-256-hashed hostnames (never raw URLs); any future telemetry requires the OFF-by-default toggle in Settings → Diagnostics & privacy. Read /privacy for the full posture.

Sipario · MMXXVI · the show is about to begin.