Structured Input

The Structured JSON panel accepts one JSON object and fills the existing Filename Tool form. The importer does not construct filenames itself.

The JSON can also be constructed from the existing form state. This can be applied to the Batch Filenames panel, so a number of Form values can be applied to a group of files together.

Omitted fields retain their current values unless the Clear Tool button is used to clear (or return to their defaults) the tool’s fields. Unknown fields and invalid values are rejected and displayed together.

“Get From Tool” emits time and useTime whenever the six-digit value is a valid 24-hour HHMMSS time—the same rule that changes the interface label from Sort to Time. It emits sort and useSort for every other valid sort value. Input remains permissive: a time-like value supplied as sort is accepted and interpreted by the same underlying tool controls. Do not provide both time and sort, or both useTime and useSort, in one object. compression is accepted as an alias for quality; do not provide both names in that pair either.

{
	"imageDate": "2026-07-17",
	"dateClarification": "date_mod",
	"baseName": "Nightfall",
	"detail": "Rally Sequence",
	"format": "mp4",
	"camera": "XF605",
	"width": 3840,
	"height": 2160,
	"rating": 3,
	"logging": [
		{ "label": "Scene", "value": "07" },
		{ "label": "Take", "value": "03" }
	],
	"loggingBeforeDetail": true,
	"flags": ["slated"]
}

The full schema, with complete field definitions and allowed values, is available at /filename-tool-input.schema.json.

All JSON Fields Example

The JSON below contains every field exported by Filename Tool, combined into a single—if somewhat unrealistic—example. Use it as a quick reference when adding a field manually: you can find the correct field name and a representative value here, or consult the full schema for more definitive documentation.

{
	"useDate": true,
	"imageDate": "2026-07-17",
	"dateClarification": "date_mod",
	"useTime": true,
	"time": "145421",
	"sortFirst": true,
	"baseName": "Nightfall",
	"detail": "Full Program",
	"suffix": "@2x",
	"version": "v03B",
	"durationHours": 1,
	"durationMinutes": 23,
	"durationSeconds": 45,
	"format": "mp4",
	"useCompression": true,
	"quality": "ProRes422",
	"useCreator": true,
	"creator": "by Christopher Werby",
	"useCamera": true,
	"camera": "XF605",
	"useColorSpace": true,
	"colorSpace": "Rec709",
	"useReference": true,
	"imageReference": "1842+1843",
	"useDimensions": true,
	"width": 3840,
	"height": 2160,
	"rating": 3,
	"logging": [
		{
			"label": "Scene",
			"value": "01 to 23"
		}
	],
	"loggingBeforeDetail": true,
	"flags": [
		"slated"
	],
	"customFlags": [
		"client_review"
	],
	"flagValues": {
		"background": "202020",
		"dither": "diffusion",
		"foreground": "F3F3F3",
		"forprogram": "finalcut",
		"fps": "29.97",
		"fromprogram": "resolve",
		"lossy": "medium",
		"matte": "black"
	}
}