Skip to content

Play your first title

With the connections configured and TMDBHelper set up, you're ready to stream.

Start playback

  1. Open TMDBHelper and browse to a movie or TV episode.
  2. Start playback (or choose Play with NZB-DAV if prompted for a player).
  3. NZB-DAV searches your providers and shows the source picker.

Choose a source

The picker is a full-screen list of every release that passed your filters, ranked by your chosen sort order. Each row shows the release name, resolution, HDR format, video codec, audio format, source type, container, file size, age, indexer, and release group.

NZB-DAV results picker

  • A green DL tag marks a release that's already downloaded on your backend, so it can play almost immediately.
  • The status bar shows how many sources passed your filters.
  • Select a row to download and play it. Press C for a context menu, or Esc to go back.

If you turn on Auto-select best match in settings, NZB-DAV skips the picker and plays the top-ranked result automatically.

Reuse a completed season pack

When a completed backend job contains multiple reliably named episodes, NZB-DAV remembers the episodes in that job. A later request for one of them shows Already downloaded season pack — Episodes … first in the picker (or prefers it when auto-select is enabled). Selecting that row reuses the completed download without submitting another NZB.

Before playback, NZB-DAV rechecks the exact backend job and its original completed folder, inventories it again, and selects the requested season/episode from the filename. A missing requested episode never falls back to a differently named episode. If the job or folder was conclusively removed, the saved row becomes stale; temporary network, authentication, or server errors leave it saved for a later attempt while normal online results remain available.

Watch the download progress

After you pick a source, NZB-DAV submits it to your backend and shows a progress dialog that reflects the real download state:

Stage What it means
Submitting NZB… The NZB is being sent to nzbdav.
Queued… Accepted, waiting to start.
Fetching NZB… nzbdav is retrieving and parsing the NZB.
Waiting for propagation… Waiting for article availability.
Downloading… n% Actively downloading.
Paused The backend paused the job.

Playback starts automatically as soon as enough of the file is ready. If the release turns out to be a placeholder or has missing article bodies, NZB-DAV detects it and moves on rather than playing a broken file.

Resume where you left off

If you've watched part of a title before, NZB-DAV offers Kodi's native Resume from… / Start from beginning prompt when you replay it. Resume points are tracked per release, so they survive even though the underlying stream URL changes each session.

One-time seeking setup for large files

The first time NZB-DAV needs the remux tier for a large file, it may show a dialog about advancedsettings.xml. Setting Kodi's cache memory size to 0 lets large files stream in direct pass-through mode with full seeking. This is optional but recommended on low-memory or 32-bit devices. See advancedsettings.xml and seeking for the exact steps.

What happens behind the scenes

If you're curious how a pick becomes a playing stream — search, submission, polling, the local proxy, and mid-playback recovery — read How it works.

Something didn't work?

See Troubleshooting for the most common setup, search, WebDAV, and playback issues.