Media library

Browse and inspect files managed under Insight's media root. Paths are relative to that root; destructive operations reject traversal and clear source assignments that would otherwise reference deleted media.

📄️List media files as a folder tree

Returns the complete visible media-library hierarchy using relative paths that can be passed directly to inspection, assignment, preview, and deletion APIs. Hidden entries and macOS archive metadata are omitted so the result matches what users see in Insight.

📄️Delete a media file or directory

Permanently deletes a file or directory beneath the media root. If the deleted path is assigned to a media-source slot, Insight clears that assignment to avoid leaving stale playback state. Prefer stopping active sources first, and always obtain the relative path from the media tree rather than sending an absolute host path.

📄️Inspect a media file

Probes one media-library file and returns normalized metadata suitable for deciding how it can be previewed or streamed. Images report dimensions, mode, and format; videos report track codec, normalized codec, duration, frame rate, and dimensions when available.

📄️Stream an MJPEG preview for a media file

Transcodes or relays a media-library file as a long-lived multipart MJPEG response for lightweight browser preview. This is a preview transport rather than a downloadable file; clients must handle an open-ended stream and close it when the preview is no longer visible.

📄️Download or preview a media file

Serves the original bytes for a relative path beneath the media root using the detected content type. Browsers may display supported media inline; automation can use the same route to download the file. Missing paths return `404` and traversal outside the library is not permitted.