First run
From a fresh container to a playing episode.
1. Sign in
Open the instance and you land on the sign-in screen. Use the email and password of your Nuvio account, or Sign up to create one; the sign-up screen talks to the same Nuvio API the mobile app does, so an account made here works on your phone and vice versa.
The session is stored in an httpOnly cookie and refreshed transparently on the
server when the upstream access token expires. Signing out clears it.
2. Pick a profile
Nuvio accounts have up to six profiles, each with its own library, watch progress, history and addon set. After sign-in you get the profile picker; the choice is remembered in a second cookie, and everything the app shows afterwards is scoped to it.
You can switch profile from the avatar menu in the header at any time. Switching re-scopes the sync store, so the library and continue-watching rows change with it.
3. Add an addon
An account with no addons has nothing to show. Nuvio Web renders catalogs, metadata and streams that addons return; without one the home screen is empty by construction.
If your account already has addons (from the mobile app, say), they are there already and you can skip this. Otherwise go to Settings → Addons and either:
- paste an addon's manifest URL into Add addon and confirm the preview, or
- browse an addon catalog, if one of your installed addons serves an
addon_catalogresource, and install from the list.
Addons are shared with your Nuvio account, so what you install here shows up on mobile too. See Addons for ordering, enabling and diagnosing them.
4. Find something
The home screen fills in behind skeletons: a hero spotlight, continue watching,
your library, then one row per catalog. Discover is the full catalog browser
with genre filters and pagination, Search fans out across every addon that
serves a search catalog, and ⌘K / Ctrl-K opens the command palette from
anywhere.
5. Play it
Open a title, pick an episode if it is a series, and the source drawer lists every stream your addons returned, annotated with quality, codec, size and release details parsed out of the addon's own label. Pick one, or set a preferred resolution in Settings → Playback and let auto-pick do it.
The player streams in the tab. From there you can switch audio track and subtitles, skip an intro, cast to a TV, or hand the stream to an external player on mobile. See The player, which also lists the keyboard shortcuts.
If something is wrong
The usual first-run failure is not this app: it is ORIGIN. If pages render but
nothing you change ever saves, read Configuration. For anything
else, Troubleshooting.
This guide lives in the project repo: edit it there, and this page follows within a day.