How do I import a video from Files?

You can import video files stored on your device, an external drive, or cloud storage into Smooth Operator. This guide covers importing from your file system.

Supported formats

Smooth Operator can import any video format that Apple's AVFoundation can read. This includes:

.mov (QuickTime)
.mp4 / .m4v (MPEG-4)
.avi (AVI files)

If a file is not a valid playable video, the app will show the error: "The selected file is not a valid video."

Importing on iOS

Open the Import sheet by tapping the "+" button on the Projects screen.
In the "Import From" picker, select "Files."
Tap "Select Video File." The iOS file browser opens.
Navigate to your video file and select it.
The app verifies the file is playable and returns to the Import sheet.
Optionally, attach a motion.json file by tapping "Attach motion.json."
Enter a project name (or keep the auto-suggested name).
Tap the import/confirm button.

Importing on Mac

Click the "+" button or use the menu command File → Import Video... (Cmd+I).
In the "Import From" picker, select "Files."
Click "Select Video File." A Finder open panel appears.
Choose your video file (single selection only).
Optionally, attach a motion.json file by clicking "Attach motion.json..."
Enter a project name.
Click Import.

You can also drag and drop a video file from Finder directly onto the Smooth Operator window. The file will be copied to a temporary location and imported.

Importing a Smooth Operator bundle

If you have a folder that contains both a video.mov and a motion.json file (a Smooth Operator bundle), you can select the folder itself when importing. The app detects the bundle structure and extracts both files automatically.

What happens after import

The app checks if the file is playable.
By default, Smooth Operator creates a reference to your file rather than copying it. This saves storage space. See Why does Smooth Operator use source file references? for details.
A proxy (low-resolution copy) is generated in the background for smooth editing.
A thumbnail is created from the first frame.
If motion data was included, the Auto-Process Wizard opens.

Common issues

Problem	What to do
"The selected file is not a valid video"	Try converting the file to .mp4 or .mov first.
"Access to the file was denied"	Check file permissions. On Mac, ensure the file is not locked.
Import was cancelled	The file picker was dismissed without a selection. Try again.
"Failed to copy the video file"	There may not be enough storage space. Free up space and retry.