How to resolve frame extraction validation errors in Aura

This article explains how to resolve Aura processing errors caused by incorrectly named or non-sequential video files used for colorization.

Error Message

Processing Failed: FrameExtraction validation: Non-contiguous video files. Files should be named GS01..., GS02..., GS03... etc. (or GH or GX).

Processing Failed: FrameExtraction validation: Unsupported video file name(s). File name should start with GS, GH, or GX, followed by 6 digits.

Dataset has incorrectly named video files error 2

Dataset has incorrectly named video files Error 1

Why does this occur?

Aura requires video files used in the colourisation process to retain their original filenames as they came directly from the camera. If the files have been renamed, Aura may not correctly match them with the corresponding scan data, resulting in failed or mismatched processing.

This can happen when files are renamed during data transfer, reorganisation, or upload. The original filenames (e.g. GS010123.360, GS020123.360) are essential for Aura to establish accurate synchronisation and file mapping.

Common Causes

Cause: Renamed or Mismatched Video Files

Aura relies on GoPro’s original file naming convention to correctly sequence and align video files with scan data. If the files are renamed, either accidentally or during transfer, Aura may be unable to associate them correctly with the scan, which can lead to issues such as frame extraction errors, sync mismatches, or complete failure of the colourisation process.

Resolution

To resolve this issue, you have two options:

Restore the original GoPro filenames.
This is the most reliable approach. Files should match the original names exactly as they came off the camera (e.g. GS010123.360, GH020123.MP4, GX030456.360).
Manually rename the files using GoPro’s expected structure.
If the original names are not available, you can rename the files using a format that Aura can interpret. The goal is to clearly signal the sequence of the video segments and their relationship to the capture session.

Step 1: Understand the GoPro File Naming Convention

GoPro video files follow this general naming format:

[Camera Identifier] [Chapter Number] [Clip Number].[File Extension]

Example:
GS010123.360

1. Camera Identifier (GS, GH, or GX)

Indicates video type and encoding:
- GH = H.264 codec (standard)
- GX = H.265/HEVC codec
- GS = Typically used for 360-degree GoPro Max video
Aura recognises all three prefixes.

2. Chapter Number (e.g. 01, 02, 03)

Each recording is split into 4GB segments.
The chapter number indicates the file’s position in that session.
For example, GH010123 is the first segment, GH020123 is the second, etc.

3. Clip Number (e.g. 0123)

Represents a single recording session, from the moment “Record” is pressed until stopped.
All segments from the same session share the same clip number.

Example

A single recording session that spans multiple files might include:

GS010123.360 is the first file of clip 0123
GS020123.360 is the second file of the same clip
GS030123.360 is the third file of the same clip

All files belong to clip 0123 and should be kept in sequence.

Step 2: Rename the video files

Watch each video to determine the correct sequence.
Use visual cues (e.g. start/stop motions, lighting, or scene progression) to identify the chronological order in which the videos were captured.
Rename each file using the correct structure:
- Use GS, GH, or GX as the prefix (depending on the original video type).
- Assign a chapter number (01, 02, 03, etc.) based on the order you just determined.
- Choose a clip number (e.g. 0123) and keep it consistent across all segments from the same recording session.
- Use the .360 file extension if the video was captured using a 360-degree camera.
Double-check that the files are in the correct sequence and that names follow the format
1. [Camera Identifier] [Chapter Number] [Clip Number].[File Extension]

Can I still process this data?

Yes, provided all video files are present and complete, the data can still be processed by following the steps above. This includes restoring the original filenames or renaming the files using a format that Aura can ingest.