Reference
Table of Contents
Validation Messages
Before a session can start, evrExpanse continuously validates the current configuration. Problems are surfaced in two places, depending on what they refer to:
- Inline card alerts — shown as an orange sub-line directly under the affected path card (Source, Offload, Transcode, or an additional destination). These point at a specific folder or volume.
- Bottom-bar messages — shown along the bottom of the Workflow tab for problems that are global to the session or tied to the Transcode / Export options rather than to a single card.
Almost every message listed below prevents the session from starting until it is resolved: the Start button stays disabled while any of these conditions is active. The few purely informational cases are called out explicitly.
Inline card alerts
These appear under the relevant path card and always refer to that card's folder or volume.
| Message | Card | Cause |
|---|---|---|
| Duplicate volume name — verify the correct disk. | Source / Offload / Transcode / Additional | Two or more mounted volumes share the same name, so the target disk is ambiguous |
| Insufficient disk space. | Offload / Transcode / Additional | The destination does not have enough free space for the operation |
| Source folder is empty. | Source | Offload is active and the source folder contains no files |
| No compatible media in source folder. | Source | The source folder contains no files matching the enabled media formats |
| Offloading to source folder. | Offload | The offload destination is the same folder as the source |
The disk-space and duplicate-volume alerts use the same wording on every card; the card the alert sits under identifies which folder is affected.
Path not set or not found
When a required folder is not yet chosen, evrExpanse shows a guidance hint rather than an error, and the Start button stays disabled:
| Message | Cause |
|---|---|
| Select a source folder to continue. | No source folder chosen for an active Offload, Transcode, or Export workflow |
| Select an offload destination to continue. | Offload is active but no primary destination is set |
| Select a transcode destination to continue. | Transcode is active but no destination is set |
If a folder was chosen but no longer exists on disk (renamed, unmounted, or moved), the card instead shows an invalid-path alert:
| Message | Cause |
|---|---|
| Source folder is invalid. | The configured source path no longer exists |
| Offload destination folder is invalid. | The configured offload destination no longer exists |
| Transcode destination folder is invalid. | The configured transcode destination no longer exists |
| Extra destination +N folder is invalid. | An additional destination (+2, +3, or +4) no longer exists |
Transcode option messages
Shown in the bottom bar when a Transcode option is incompatible with the selected mode or workflow. The control that needs attention is also outlined in orange in the Transcode card.
| Message | Cause |
|---|---|
| HEVC codec supported only in Manual Mode. | An HEVC codec is selected while Smart or Rewrap mode is active |
| Audio Passthrough not supported in Smart Mode. | Copy (Passthrough) audio is selected while Smart mode is active |
| Invalid HEVC bitrate. Enter a value between 500 and 200000. | The custom HEVC bitrate is empty, non-numeric, or outside 500–200000 |
| 3D LUT supported only in Manual Mode. | A 3D LUT is selected while Smart or Rewrap mode is active |
| Burn-in metadata supported only in Manual Mode. | Burn-in metadata is enabled while Smart or Rewrap mode is active |
| Downscale resolution supported only in Manual Mode. | A downscale resolution is selected while Smart or Rewrap mode is active |
| Smart Mode requires ProRes or HEVC for FCP compatibility. | Optimize for Final Cut Pro is on in Smart mode with a non-ProRes, non-HEVC codec |
| No compatible LUT file found (.cube required). | The selected LUT file is missing or is not a .cube file |
| LUT folder missing or contains no valid .cube files. | The selected LUT folder is missing or contains no .cube files |
Workflow compatibility
Shown when Transcode and Export are chained but the chosen output or export option cannot be combined.
| Message | Cause |
|---|---|
| EXR and DPX are not supported with Transcode+Export. | An EXR or DPX output is selected while Export is chained — these are image sequences and cannot feed the Export engine |
| This workflow doesn't support Sony Real Time Metadata Export. | Sony RTMD export is enabled while Transcode and Export are chained |
| This workflow doesn't support Extract LUT File from Media. | Extract LUT File is enabled while Transcode and Export are chained |
Environment and tooling
| Message | Cause |
|---|---|
| FFmpeg not found. Check Preferences. | The ffmpeg binary was not found at the configured or default path |
| FFmpeg is not functioning correctly. Check Preferences. | ffmpeg was found but returns an error on launch |
| FFmpeg version mismatch. Required: 8.0. Check Preferences. | The installed ffmpeg version is not 8.0 |
Export configuration
| Message | Cause |
|---|---|
| SCRATCH Project name is empty. | SCRATCH export is enabled but no project name is entered in Preferences |
| SCRATCH Watch folder not found. | The SCRATCH Watch Folder path in Preferences does not exist |
In addition, the Start button stays disabled if Export is active but no export format is selected. Choose at least one format in the Export card to proceed.
Supported Cameras
evrExpanse extracts and maps camera-specific metadata for the following manufacturers:
Panasonic · Sony Alpha · Sony XDCAM · Canon · Nikon · Fujifilm · ARRI · Z Cam · Kinefinity · Atomos Ninja & Inferno · McPRO24fps · GoPro · Apple iPhone · FiLMiC Pro · Blackmagic Camera App
For the complete and up-to-date compatibility table including specific camera models and supported metadata fields, see the Camera Compatibility page.
Supported File Formats
Metadata Export and Apply Finder Tags
Default formats are always processed. The way optional formats are handled depends on the workflow:
- Metadata Export processes an optional format only when it is enabled in the Source Formats section (Workflow tab) or in Preferences → Metadata Export.
- Apply Finder Tags always processes every optional format, regardless of the Source Formats selection. This ensures no file is left untagged simply because its format was disabled for a different workflow.
| Format | Default | Optional |
|---|---|---|
| MOV | ✓ | |
| MP4 | ✓ | |
| MXF | ✓ | |
| JPG / JPEG | ✓ | |
| PNG | ✓ | |
| TIF | ✓ | |
| MKV | ✓ | |
| NEV (Nikon RAW) | ✓ | |
| R3D (as Nikon RAW) | ✓ | |
| HEIC | ✓ | |
| DNG | ✓ | |
| AVIF | ✓ | |
| ARW (Sony RAW) | ✓ | |
| CR2 (Canon RAW) | ✓ | |
| CR3 (Canon RAW) | ✓ | |
| NEF (Nikon RAW) | ✓ | |
| RAF (Fujifilm RAW) | ✓ | |
| RW2 (Panasonic RAW) | ✓ |
Transcode Input
MOV · MP4 · MKV · MXF
Transcode Output Containers
MOV · DPX · EXR
Export Format Field Reference
This section documents the exact field layout written by each export format. Column order is fixed and matches the order shown below. Empty fields are written as empty values, not omitted — every row always contains every column.
Camera-specific availability varies: a field is populated only when the source camera records that metadata. The example values below are representative of a typical cinema/mirrorless clip and are illustrative only.
evrExpanse TSV (.tsv)
Tab-separated. The master format — contains the full field set and is the recommended input for Apply Finder Tags. One header row, one row per clip.
| # | Column | Example value |
|---|---|---|
| 1 | e.File_Name_Ext | A001_C012_0823.mov |
| 2 | e.Date_Recorded | 2026-06-07 21:07:41 |
| 3 | e.TC_Start | 14:32:18:04 |
| 4 | e.TC_End | 14:32:51:11 |
| 5 | e.Clip_Dir | /Volumes/A001/Clips |
| 6 | e.Clip_Name | A001_C012 |
| 7 | e.Reel_Number | A001 |
| 8 | e.Scene | 14 |
| 9 | e.Take | 3 |
| 10 | e.Camera_Number | A |
| 11 | e.Camera_FPS | 23.976 |
| 12 | e.Avg_Bitrate | 240 Mbps |
| 13 | e.Video_Codec | ProRes 422 HQ |
| 14 | e.Video_BitDepth | 10 |
| 15 | e.Video_Gamma | LogC3 |
| 16 | e.Color_Spaces | ARRI Wide Gamut |
| 17 | e.Camera_Maker | ARRI |
| 18 | e.Camera_Serial | 12345 |
| 19 | e.Camera_Type | ALEXA Mini LF |
| 20 | e.Camera_FW | 7.1.1 |
| 21 | e.Camera_ISO | 800 |
| 22 | e.FNumber | 2.8 |
| 23 | e.Shutter_Speed | 1/48 |
| 24 | e.Shutter_Angle | 180 |
| 25 | e.Aperture_Type | Manual |
| 26 | e.White_Balance_CC | 0 |
| 27 | e.White_Point_K | 5600 |
| 28 | e.Lens_Type | Signature Prime 35mm |
| 29 | e.Focal_35efl | 35 |
| 30 | e.Lens_Serial | 98765 |
| 31 | e.Lens_Firmware | 1.0 |
| 32 | e.Camera_Notes | CR=() |
| 33 | e.Sensor_Area | 4448x3096 |
| 34 | e.Lut_Used | ARRI_LogC2Rec709.cube |
| 35 | e.GPS_Position | 45.4642, 9.1900 |
| 36 | e.Tag | Approved,Hero |
| 37 | e.Flags | Red,Green |
| 38 | e.Camera_Rotation | 0 |
| 39 | e.Focus_Distance | 2.4 m |
| 40 | e.XMP_Rating | 5 |
| 41 | e.XMP_Label | Select |
| 42 | e.XMP_DateCreated | 2026-06-07 |
| 43 | e.XMP_Pick | 1 |
| 44 | e.XMP_Good | true |
| 45 | e.XMP_Location | Milan |
| 46 | e.XMP_Creator | DIT |
| 47 | e.XMP_Title | Opening shot |
| 48 | e.XMP_Rights | © 2026 |
| 49 | e.XMP_Subject | interview,b-roll |
| 50 | e.XMP_Description | Wide establishing shot |
Notes: e.Tag carries the macOS Finder Tags of the file; e.Flags carries Finder color labels. e.XMP_Subject and e.Camera_Notes preserve commas; other multi-value fields have commas substituted to protect the column structure.
DaVinci Resolve CSV (.csv)
Comma-separated, comma-quoted. Import via File → Import Metadata To → Media Pool or Selected Clips. One header row, one row per clip.
| # | Column | Example value |
|---|---|---|
| 1 | File Name | A001_C012_0823.mov |
| 2 | Clip Directory | /Volumes/A001/Clips |
| 3 | Date Recorded | 2026-06-07 21:07:41 |
| 4 | Start TC | 14:32:18:04 |
| 5 | End TC | 14:32:51:11 |
| 6 | Clip Number | A001_C012 |
| 7 | Reel Number | A001 |
| 8 | Scene | 14 |
| 9 | Take | 3 |
| 10 | Camera # | A |
| 11 | Comments | Wide establishing shot |
| 12 | Camera FPS | 23.976 |
| 13 | Codec Bitrate | 240 Mbps |
| 14 | Media Type | ProRes 422 HQ |
| 15 | Camera Format | 10 |
| 16 | Gamma Notes | LogC3 |
| 17 | Color Space Notes | ARRI Wide Gamut |
| 18 | Camera Manufacturer | ARRI |
| 19 | Camera Serial # | 12345 |
| 20 | Camera Type | ALEXA Mini LF |
| 21 | Camera Firmware | 7.1.1 |
| 22 | ISO | 800 |
| 23 | Camera Aperture | 2.8 |
| 24 | Shutter | 1/48 |
| 25 | Shutter Speed | 1/48 |
| 26 | Shutter Angle | 180 |
| 27 | Camera Aperture Type | Manual |
| 28 | White Balance Tint | 0 |
| 29 | White Point (Kelvin) | 5600 |
| 30 | Lens Type | Signature Prime 35mm |
| 31 | Focal Point (mm) | 35 |
| 32 | Lens Number | 98765 |
| 33 | Lens Notes | 1.0 |
| 34 | Camera Notes | CR=() |
| 35 | Sensor Area Captured | 4448x3096 |
| 36 | LUT Used | ARRI_LogC2Rec709.cube |
| 37 | Keywords | Approved,Hero |
| 38 | Flags | Red,Green |
| 39 | Location | 45.4642, 9.1900 |
| 40 | Camera Position | 0 |
| 41 | Distance | 2.4 m |
Notes: Keywords is derived from macOS Finder Tags; Flags from Finder color labels. In DaVinci Resolve's import dialog, uncheck Match using clip start and end Timecode and check Match using source file paths.
Pomfort Silverstack CSV (Drylab, .csv)
Semicolon-separated. The file begins with two identity lines (evrExpanse and the product URL) before the header. Import via the Import menu → Drylab CSV; match by Clip Name and Creation Date (Date only).
| # | Column | Example value |
|---|---|---|
| 1 | filenameBase | A001_C012_0823.mov |
| 2 | createdAt | 2026-06-07T21:07:41 |
| 3 | cameraName | ALEXA Mini LF |
| 4 | cameraLetter | A |
| 5 | reel | A001 |
| 6 | scene | 14 |
| 7 | shot | A001_C012 |
| 8 | take | 3 |
| 9 | iso | 800 |
| 10 | tStop | 2.8 |
| 11 | colorTemperature | 5600 |
| 12 | lens | Signature Prime 35mm |
| 13 | cameraTakeNotes | CR=() |
| 14 | latitude | 45.4642 |
| 15 | longitude | 9.1900 |
| 16 | tags | Approved,Hero |
| 17 | dutch | 0 |
Notes: dutch carries camera rotation/position. File preamble lines (rows 1–2) are part of the Drylab format and must remain for Silverstack to parse the file.
Avid Media Composer ALE (.ale)
Tab-delimited Avid Log Exchange. Three sections: a Heading block (delimiter, video format, FPS), a Column block (the field header row), and a Data block (one row per clip). Format, FPS, and Bin Name are set in the Export block before running.
Heading block:
Heading
FIELD_DELIM TABS
VIDEO_FORMAT 1080
FPS 23.976
Column
<header row — see table>
Data
<one tab-delimited row per clip>
Column layout:
| # | Column | Example value |
|---|---|---|
| 1 | Bin Name | Dailies_Day01 |
| 2 | Tape | A001_C012_0823.mov |
| 3 | e_Date.Recorded | 2026-06-07 21:07:41 |
| 4 | Start | 14:32:18:04 |
| 5 | End | 14:32:51:11 |
| 6 | e_Clip.Dir | /Volumes/A001/Clips |
| 7 | e_Clip.Number | A001_C012 |
| 8 | e_Reel.Number | A001 |
| 9 | e_Scene | 14 |
| 10 | e_Take | 3 |
| 11 | e_Camera.Number | A |
| 12 | e_Finder.Tags | Approved,Hero |
| 13 | e_Finder.Flag | Red,Green |
| 14 | e_Camera.FPS | 23.976 |
| 15 | e_Avg.Bitrate | 240 Mbps |
| 16 | e_Video.Codec | ProRes 422 HQ |
| 17 | e_Video.BitDepth | 10 |
| 18 | e_Video.Gamma | LogC3 |
| 19 | e_Color.Spaces | ARRI Wide Gamut |
| 20 | e_Camera.Maker | ARRI |
| 21 | e_Camera.Serial | 12345 |
| 22 | e_Camera.Type | ALEXA Mini LF |
| 23 | e_Camera.FW | 7.1.1 |
| 24 | e_Camera.ISO | 800 |
| 25 | e_Fnumber | 2.8 |
| 26 | e_Shutter.Speed | 1/48 |
| 27 | e_Shutter.Angle | 180 |
| 28 | e_Aperture.Type | Manual |
| 29 | e_White.Balance.CC | 0 |
| 30 | e_White.Point.K | 5600 |
| 31 | e_Lens.Type | Signature Prime 35mm |
| 32 | e_Focal.35efl | 35 |
| 33 | e_Lens.Serial | 98765 |
| 34 | e_Lens.Firmware | 1.0 |
| 35 | e_Lens.Focus.Distance | 2.4 m |
| 36 | e_Camera.Notes | CR=() |
| 37 | e_Sensor.Area | 4448x3096 |
| 38 | e_Lut.Used | ARRI_LogC2Rec709.cube |
| 39 | e_GPS.Position | 45.4642, 9.1900 |
| 40 | e_Camera.Rotation | 0 |
Notes: standard ALE columns (Tape, Start, End, Bin Name) use Avid-native names; evrExpanse-specific columns are prefixed e_ and appear as custom columns in the Media Composer bin. Import via Input → Import Media…, then in Options open the Shot Log tab and select Merge events with known master clips.
Final Cut Pro FCPXML / FCPXMLD
XML. Versions 1.10 and later are written as .fcpxmld bundles (containing Info.fcpxml); 1.9 is a flat .fcpxml file. Each clip produces one <asset> (with an evrExpanse metadata block) and one <asset-clip> (with FCP-native production metadata).
evrExpanse metadata keys on the <asset> (namespace com.evrApp.evrExpanse, all type="string"):
| Key suffix | displayName | Example value |
|---|---|---|
| .Clip_Number | Clip Number | A001_C012 |
| .File_Name_Ext | File Name | A001_C012_0823.mov |
| .Record_Date | Date Recorded | 2026-06-07 21:07:41 |
| .TC_Start | TC start | 14:32:18:04 |
| .TC_End | TC end | 14:32:51:11 |
| .Camera_FPS | Camera FPS | 23.976 |
| .Avg_Bitrate | Average Bitrate | 240 Mbps |
| .Video_Codec | Video Codec | ProRes 422 HQ |
| … | (continues: bit depth, gamma, color space, camera maker/serial/type/FW, ISO, aperture, shutter, white balance, lens, sensor area, LUT, GPS, Finder tags) | |
| .Flags | Finder Color tags | Red,Green |
| .Camera_Rotation | Camera Rotation (angle) | 0 |
FCP-native keys on the <asset-clip>:
| Key | Example value |
|---|---|
| com.apple.proapps.studio.reel | A001 |
| com.apple.proapps.studio.scene | 14 |
| com.apple.proapps.studio.shot | 3 |
| com.apple.proapps.mio.cameraName | A |
The <note> element on each <asset-clip> carries the camera rating (e.g. star rating) followed by comments. To view the evrExpanse fields in FCP: select a clip, open the Metadata View dropdown in the Info Inspector, choose Edit Metadata Views…, and enable evrExpanse.
Assimilate SCRATCH XML (.xml)
XML insert command sent to the SCRATCH Watch Folder (and copied locally). The document wraps construct → slots → slot → shots → shot → metadata, with one <slot> per clip. Project, Group, and Timeline names come from Preferences → Metadata Export; the Project name must match the existing SCRATCH project exactly.
Per-clip <metadata> keys (<dataitem> key/value pairs):
| Key | Example value |
|---|---|
| e.Reel.Number | A001 |
| e.Scene | 14 |
| e.Take | 3 |
| e.Camera.Number | A |
| e.Lens.Focus.Distance | 2.4 m |
Notes: SCRATCH receives a compact production-metadata subset rather than the full field set. The local copy in evrE_FolderName can be used to import the same data on other workstations.
Sony RTMD CSV (.csv)
Comma-separated, transposed — each row is one metadata parameter, columns are per-frame samples (Real-Time Metadata is sampled per frame). One *_rtmd.csv file per Sony clip, saved to the Sony RTMD folder. Generated only for Sony source media.
Parameters (row order):
| # | Parameter | Example (frame 0) |
|---|---|---|
| 1 | FrameNumber | 0 |
| 2 | CaptureTimestamp | 2026-06-07 14:32:18.041 |
| 3 | ShutterSpeed | 1/48 |
| 4 | IrisFStop | 2.8 |
| 5 | ISOValue | 800 |
| 6 | AutoWBMode | Manual |
| 7 | ImageStabilizer | Enabled |
| 8 | Focus Position (Image Plane) | 2.4 m |
| 9 | FocusRingPosition | 1024 |
| 10 | LensZoom35mm | 35 |
| 11 | LensZoomNative | 35 |
| 12 | ZoomRingPosition | 0 |
| 13 | GyroscopeData (x y z;) | 0.01 0.00 -0.02; |
| 14 | GyroscopeScale | 2000 |
| 15 | GyroscopeFrequency | 240 |
| 16 | AccelerometerData (x y z;) | 0.00 0.98 0.01; |
| 17 | AccelerometerScale | 8 |
| 18 | AccelerometerFrequency | 240 |
| 19 | GPSDateStamp | 2026:06:07 |
| 20 | GPSLatitude | 45.4642 |
| 21 | GPSLatitudeRef | N |
| 22 | GPSLongitude | 9.1900 |
| 23 | GPSLongitudeRef | E |
| 24 | GPSMapDatum | WGS-84 |
| 25 | GPSMeasureMode | 3 |
| 26 | GPSStatus | A |
| 27 | GPSTimeStamp | 12:32:18 |
| 28 | GPSVersionID | 2.3.0.0 |
Notes: because the file is transposed, the first data column corresponds to the first recorded frame and subsequent columns advance frame by frame. Sony RTMD .csv files are written to the log folder inside the source directory, not to the evrE_FolderName export subfolder.
Extract LUT (.cube)
Not a tabular format. Extracts the embedded 3D LUT from supported camera media (Kinefinity, ARRI, McPRO24fps) as a standard .cube file, saved in evrE_FolderName. The file is the camera's native LUT; evrExpanse does not rewrite or re-grade it.
MHL Hash Format Reference
ASC MHL
| UI Label | Algorithm | XML Tag |
|---|---|---|
| md5 | MD5 | <md5> |
| sha-1 | SHA-1 | <sha1> |
| c4 | C4 | <c4> |
| xxh64 | 64-bit xxHash | <xxh64> |
| xxh3 64-bit | XXH3 64-bit | <xxh3> + <xxh64> |
| xxh3 128-bit | XXH3 128-bit | <xxh128> + <xxh64> |
MHL v1
| UI Label | Algorithm | XML Tag |
|---|---|---|
| md5 | MD5 | <md5> |
| sha-1 | SHA-1 | <sha1> |
| xxhash32 | 32-bit xxHash | <xxhash> |
| xxhash64 BE | 64-bit xxHash big-endian | <xxhash64be> |
| xxhash64 LE | 64-bit xxHash little-endian | <xxhash64> |
Keyboard Shortcuts
| Shortcut | Action |
|---|---|
| ⌘⇧L | Open Log & Report Viewer |
| ⌘, | Open Preferences |
| ⌥⌘R | Open License window |
| ⌘' | Open User Manual |
TC Mode Reference
TC Mode is configured in Preferences → General and applies globally to Export Metadata and Transcode.
| Mode | Behavior | Video | Photo |
|---|---|---|---|
| Use embedded timecode | Reads TC from camera metadata | Fallback chain: MediaInfo → FFprobe → 00:00:00:00 |
Field left empty |
| Time-of-day | Derives TC from file creation date as HH:MM:SS:00 |
Falls back to ModifyDate with log warning if CreateDate absent. Sets 00:00:00:00 if neither available |
Same as video |
| 00:00:00:00 | Resets all timecodes to zero | Applied to all files | Applied to all files |
Log warnings — Time-of-day mode:
| Condition | Log entry |
|---|---|
| CreateDate not found, ModifyDate used | ⚠️ filename — CreateDate not found, TC time-of-day derived from ModifyDate (may be inaccurate). |
| Neither CreateDate nor ModifyDate found | ⚠️ filename — CreateDate and ModifyDate not found, TC time-of-day set to 00:00:00:00. |
Third-Party Components
evrExpanse bundles the following third-party tools. For the full declaration see the Third-Party Software Declaration page.
| Tool | Purpose |
|---|---|
| ffmpeg | Transcoding engine |
| ffprobe | Media stream analysis |
| ExifTool | Metadata extraction and writing |
| MediaInfo | Media technical metadata analysis |
| jq | JSON processing |
| Miller (mlr) | CSV/TSV parsing and validation (Apply Finder Tags) |
| tag | Applying macOS Finder Tags |
| ascmhl | ASC MHL manifest generation and verification |
| mhl | MHL v1 (Pomfort) manifest generation and verification |
| xxhsum | xxHash checksum calculation |
| ARRIMetaExtract_CMD | ARRI metadata and LUT extraction |
| swiftDialog | Native dialog UI for the Apply Finder Tags workflow |