> An unofficial web client for Nuvio. Your profiles, addons, library and watch progress in a browser, with a player that streams, casts, or hands off.
> Source: https://orochibraru.com/nuvio-web/docs · Site index: https://orochibraru.com/llms.txt

# Nuvio Web documentation

An unofficial web client for Nuvio. Your profiles, addons, library and watch progress in a browser, with a player that streams, casts, or hands off.

The Markdown in [the project repo](https://github.com/orochibraru/nuvio-web/tree/main/docs) is the source of truth;
these pages are generated from it.

- [Nuvio Web](https://orochibraru.com/nuvio-web/docs/readme.md): Unofficial implementation of the Nuvio API in a web UI (since there is none, yet).
- [Contributing](https://orochibraru.com/nuvio-web/docs/contributing.md): The long-form documentation lives in docs/ and is published at <https://orochibraru.com/nuvio-web>. This file is the short version: what you need to get a…
- [Introduction](https://orochibraru.com/nuvio-web/docs/introduction.md): Nuvio Web is an unofficial web UI for the Nuvio API. Nuvio ships a mobile app and a public API but no browser client, so this is one: sign in with the account…
- [Install](https://orochibraru.com/nuvio-web/docs/install.md): Nuvio Web is distributed as a multi-arch Docker image (orochibraru/nuvio-web) for linux/amd64 and linux/arm64. There is no database to provision, but mount a…
- [Configuration](https://orochibraru.com/nuvio-web/docs/configuration.md): There is no configuration file. The container is configured entirely through environment variables, and exactly one of them matters for a normal install.
- [First run](https://orochibraru.com/nuvio-web/docs/first-run.md): From a fresh container to a playing episode.
- [Browsing](https://orochibraru.com/nuvio-web/docs/browsing.md): Everything you can browse comes from an addon. With no addons installed, the home feed is empty and says so; see Addons.
- [The player](https://orochibraru.com/nuvio-web/docs/player.md): The source drawer lists every stream the addons returned for this title, with quality, codec, size and release details parsed out of each addon's stream label…
- [Downloads and offline](https://orochibraru.com/nuvio-web/docs/downloads.md): Nuvio Web installs as an app and downloads titles so you can watch them without a connection: on a plane, on a train, or anywhere the Wi-Fi gives up.
- [Addons](https://orochibraru.com/nuvio-web/docs/addons.md): An addon is an HTTP service that publishes a manifest and answers requests for catalogs, metadata, streams and subtitles. Nuvio Web speaks the Stremio addon…
- [Library and sync](https://orochibraru.com/nuvio-web/docs/library-and-sync.md): Library, watch progress and history are kept per profile on your Nuvio account, so they follow you between devices and between the web app and mobile.
- [Profiles and settings](https://orochibraru.com/nuvio-web/docs/profiles-and-settings.md): Profiles are your Nuvio account's profiles, with the same avatars you see on mobile. Picking one is required before the app will show you anything: library…
- [The admin page](https://orochibraru.com/nuvio-web/docs/admin.md): It is the only part of the app with server-owned state.
- [Your data and Nuvio](https://orochibraru.com/nuvio-web/docs/sync.md): Library, watch progress and history live on this server, in its SQLite database, per Nuvio account and per profile. That copy is the source of truth: every page…
- [Troubleshooting](https://orochibraru.com/nuvio-web/docs/troubleshooting.md): Almost always ORIGIN.
- [Architecture](https://orochibraru.com/nuvio-web/docs/architecture.md): SvelteKit 3 on Svelte 5 runes, Tailwind 4 and shadcn-svelte, running on Bun and compiled to a single binary.
- [Services and the container](https://orochibraru.com/nuvio-web/docs/services.md): Each is a class taking its collaborators as constructor arguments, registered against a token and resolved from a Container.
- [The addon pipeline](https://orochibraru.com/nuvio-web/docs/addon-pipeline.md): From "this profile has some addon URLs" to "this page has rows".
- [The sync store](https://orochibraru.com/nuvio-web/docs/sync-store.md): Components read sync.ready ? sync.X : data.X and write through sync.. No page calls toggleLibrary / saveProgress / deleteHistory directly any more.
- [Security](https://orochibraru.com/nuvio-web/docs/security.md): Running this on the public internet is on you: put it behind HTTPS and whatever access control you would give any other self-hosted app. What follows is what…
- [Development](https://orochibraru.com/nuvio-web/docs/development.md): Installing dependencies runs prek install, which wires three shims: pre-commit runs the fixers and checks, commit-msg enforces Conventional Commits, and…
- [Testing](https://orochibraru.com/nuvio-web/docs/testing.md): Three levels, each with a different job.
- [The Nuvio API spec](https://orochibraru.com/nuvio-web/docs/nuvio-api.md): Nuvio publishes its public API as prose markdown, not as a machine-readable document. Two scripts bridge the gap, and a daily CI job watches for drift.
