Files

Native media metadata for one file

Header-bounded native probe: images via ImageIO (a properties read, never a full decode), audio/video via AVFoundation track format descriptions (the moov read). Video dimensions are DISPLAY dimensions (the track's preferredTransform applied), so rotated phone video reads portrait; images apply EXIF orientation the same way. Every fact field is optional — a file the probe cannot parse (a text file, a .ply) answers just the echoed path, never an error. Refuses credential-store paths and any symlinked component (403), like every filesystem route.

post/v1/filesystem/metadata

Request

  • Base URL: http://localhost:9998
  • URL: http://localhost:9998/v1/filesystem/metadata
  • Auth: HTTP bearer

Request body

pathstring required

Absolute path (tilde expanded) of the file to probe

Response

Probe result; an absent field means the probe had no answer

pathstring required

The probed path (server-expanded), echoing the request

pixelWidthinteger

Display pixel width (video applies preferredTransform; images apply EXIF orientation)

pixelHeightinteger

Display pixel height

codecstring

Human codec name (HEVC, H.264, AAC, PNG…); the raw FourCC when unmapped

frameRatenumber

Video nominal frame rate, fps

sampleRateinteger

Audio sample rate, Hz

channelsinteger

Audio channel count

colorModelstring

Image color model (RGB, Gray, CMYK…)

bitDepthinteger

Image bits per component

Changes

No recorded changes to this operation across all 1 revision of this API.