Medusa Panel › VOD › Add Movie
The Movies screens let you publish single video-on-demand titles through the Medusa Streaming Engine. A movie points at one media file on a selected server, carries catalogue metadata (optionally filled from TMDB), and is published to one or more bouquets so that subscribers can see it. This article covers the Add Movie form, the metadata fields, the built-in file browser, and the Manage Movies list.
/movie/add). To edit an existing title, open Manage Movies (/movie/manage) and choose Settings on the row; that loads the same form at /movie/{id}/settings.Core details
The top of the form holds the fields that identify the movie and decide where it lives.
- Name — the title shown to subscribers. Required. The magnifier button beside the field runs a TMDB search for this name (see the next section).
- Category — a single VOD category the movie is filed under. The drop-down lists the categories you have defined; leave it blank for none. A category that no longer exists is shown as
Unavailable category (name)so you can spot and correct it. - Bouquets — a multi-select of the bouquets the movie is published to. Type in the search box to filter, and use the select-all / deselect-all controls for bulk changes. A movie must be in at least one bouquet for subscribers of that bouquet to receive it.
- Server — the server that stores and serves the media file. Required. The list of files shown by the file browser comes from the server chosen here.
- Source — the absolute path of the media file on the selected server, for example
/storage/movies/example-title.mp4. Type it directly, or press the folder button to pick it with the file browser.
TMDB metadata
Below the core details is the metadata block. You can type every value by hand, or let a TMDB lookup fill them for you.
When a TMDB API Key is configured on the System Settings page, the magnifier beside Name searches TMDB for the current name and opens a TMDB Search dialog. Results appear as cards with the poster, title and release date; clicking a card fills the metadata fields below. The lookup fills everything except the Name itself, which you keep control of.
- TMDB ID — the numeric identifier of the matched title on TMDB, for example
27205. - TMDB Language — the language used for the TMDB search and details, such as
en-US(the default) orde-DE. The list is searchable. - Original Name — the title in its original language.
- Genres — a comma-separated list, for example
Action, Thriller. - Release Date — the release date, for example
2010-07-16. - Rating — a score from
0to10(fractional values accepted), for example8.3. - Country — the country of origin, for example
US. - Poster URL — a link to the poster image, for example
https://example.com/posters/example-title.jpg. - Backdrop URL — a link to the wide backdrop image.
- Director — the director name(s).
- Actor — the cast, typically comma-separated.
- Overview — the synopsis shown to subscribers.
The file browser
Pressing the folder button next to Source opens the File Browser. It lists files and folders on the server you selected, so you can pick the media file without typing the full path.
- Server — switch the server whose files are listed, if needed.
- Path — the current directory. Type a path and press
Enteror Go to open it; a trailing slash is added automatically. The arrow buttons move to the parent directory, step back to the previous directory, and refresh the listing. - Filter files — narrows the visible entries as you type.
- Add — confirms the highlighted file and writes its path into the Source field. Cancel closes the dialog without changing anything.
Saving
Use Save to create or update the movie, or Cancel to return to Manage Movies without saving. After saving, the engine queues the title for processing on the chosen server.
Managing movies
The Manage Movies list (/movie/manage) shows one row per title with the columns ID, Name, Category, Server, Genres, Release Date, Rating, Country, Connections, Progress and Status. You can search and sort by column.
The Status column reflects where the media is in the pipeline:
Pending— queued, not started yet.Processing— the engine is preparing the file.Completed— ready for playback.Failed— preparation did not finish; check the log.
Each row has a Settings button that reopens the form, plus a menu with:
- Player — opens the title in a pop-out player window.
- Log — shows the processing log for the title.
- Delete — removes the movie after a confirmation.
Select rows with the checkboxes to use the toolbar Mass Action menu, which includes Mass Delete for removing several titles at once.