Add Movies (VOD)

A movie in XUI.live is a file or a URL plus its metadata, delivered on demand. You can add one title with full control, or point the panel at a folder or an M3U and let it build the library for you.

Open Movies → Add Movie.

One movie, by hand

Details. Name and source — a path on your server or a URL. Type a title into the TMDB search and the panel fills the rest.

Movie information. Everything a player app shows comes from here: poster and backdrop, plot, cast, director, genre, country, release date, runtime, rating and a trailer. With a TMDB match it is all fetched for you, in the metadata language you choose; anything can be overridden by hand, and disable TMDB keeps your edits from being refreshed away.

Advanced. The options that decide how the file is treated:

• Direct source hands players the URL untouched — no processing, no transcoding. Direct proxy relays it through your server instead, hiding the origin.
• Symlink serves a local file from where it already sits instead of copying it into the panel’s storage — the right choice for large libraries on mounted storage.
• Transcode profile and target container re-encode the file once, at add time — unlike a live stream, a movie is encoded ahead of delivery, not per viewer.
• Subtitles — upload subtitle files for the title, or remove subtitles to strip embedded tracks before encoding (hardcoded subtitles cannot be removed).

Servers. The same tree as everywhere else — the movie is delivered from every enabled server.

A whole library at once

Add Movie → Import offers two routes:

Folder scan — point it at a directory on a server and it walks the files (optionally recursively), matches each against TMDB, and creates finished entries: name, poster, plot, the lot. Ignore no match decides what happens to files TMDB does not recognise — skip them, or add them bare for you to fill in later.

M3U — feed it a playlist file or URL and the panel creates an entry per item.

Both land in the review queue first, where categories and bouquets are confirmed before anything goes live. For a library that grows continuously, watch folders do this automatically as files arrive — no import step at all.

Encoding, visibly

When a movie needs encoding, the Movies list shows live progress as a percentage badge on the row, so a bulk import’s state is readable at a glance. The list also filters by status — encoded, encoding, ready, down, direct — plus codec and resolution.

After adding

Movies join bouquets like any content, show up in player apps with full artwork and detail pages, and are served on demand — a title nobody is watching costs nothing but disk.

Series work the same way with seasons and episodes on top; both are driven programmatically by the API, including create_movie and bulk imports.