Skip to content

VOD catalog

The VOD section is a cluster asset catalog: files that sit on the streamers and play on request. Unlike a stream, an asset has no source and no placement by the layouter; it simply sits where it was uploaded and is served from there.

There are four tabs: Catalog, Uploads, Storages and Upload tokens. This page is about the catalog; uploading and storage are on VOD uploads.

For the catalog to have somewhere to live, the streamer needs at least one VOD root — set it in the streamer settings.

Asset, key and files

The unit of the catalog is an asset. An asset has:

  • Key — the path-like name it is found by: movies/2026/blade.mp4. Keys form folders, and the catalog shows them as a tree.
  • Asset id — an immutable identifier. The key can be renamed, the asset id cannot, so links by asset id survive a rename.
  • Revision — increments on every change to the set of files.
  • Files — one asset may consist of several files: video and separate audio tracks, for instance.

The VOD catalog: the key tree and the columns of a level

The list columns are Name, Status, Files, Size, Asset id, Updated. The status is playable or not playable: an asset whose media info could not be read is served only as a raw file.

The tree shows at most 1000 folders per level — on a longer list it says Only the first 1000 folders are shown — narrow with the filter. The Filter this level… field filters the current level, and Load more pulls in more assets.

Where an asset sits

The Placement block shows which storages hold the asset and at which revision:

  • origin — the primary placement, where the asset was uploaded.
  • replica — a copy on another storage.

Next to it you may see storage unavailable. It means exactly what the hint says: Playback 503; deletion works, cleanup deferred. That is, the catalog stays manageable even while the machine holding the files is down.

Asset files

The file table: File, Media info, Hash, Actions. A file whose media info could not be read is marked media error and is available as a raw file.

The asset card: placement, revision and files with their playback links

The HLS, DASH and RAW buttons copy the playback link of the respective kind, and Copy hash copies the file checksum.

Renaming a key

Rename key changes metadata only: files stay in place; saved links by AssetId keep working. Renaming a folder rewrites the prefixes of every key underneath it at once. If the new key is taken, the operation is rejected — This key is already taken.

Deleting

Deletion works at three levels:

  • Delete file — one file leaves the asset and the asset revision will increment. If it was the last one, the asset is deleted with it.
  • Delete asset — with a confirmation stating the number of files.
  • Delete folder — every asset under that prefix. The console first collects the list (Collecting assets: N), then queues them and shows the progress: Deleting assets: N/N, N failed, Deleted N assets.

Deletion always acts on the catalog, not on the disk: the message Deleted from catalog — node cleanup deferred means the record is gone at once, while the files are removed by the streamer when it can. That is exactly why deletion is available even with a storage unavailable.

What next

  • VOD uploads — how to upload files, where to look at storages and how to issue a portal upload token.