--- title: "How to resolve frame extraction validation errors in Aura" slug: "how-to-resolve-frame-extraction-validation-errors-in-aura" updated: 2026-08-24T05:26:44Z published: 2026-08-24T05:26:44Z canonical: "knowledge.emesent.com/how-to-resolve-frame-extraction-validation-errors-in-aura" stale: true --- > ## Documentation Index > Fetch the complete documentation index at: https://knowledge.emesent.com/articles/llms.txt > Use this file to discover all available pages before exploring further. # 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 > [!CAUTION] > **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. ![Non-contiguous video files error in Aura](https://cdn.document360.io/c908b593-57d7-4fc8-b409-592fc1051369/Images/Documentation/image-20250527-040058.png) ![Unsupported video file name error in Aura](https://cdn.document360.io/c908b593-57d7-4fc8-b409-592fc1051369/Images/Documentation/image-20250527-040355.png) ## Why this occurs Aura requires video files used in the colorization 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, reorganization, or upload. The original filenames (for example, **GS010123.360**, **GS020123.360**) are essential for Aura to establish accurate synchronization and file mapping. ## 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 colorization process. ## Resolution There are two options to resolve this issue: 1. **Restore the original GoPro filenames.** This is the most reliable approach. Files should match the original names exactly as they came off the camera (for example, **GS010123.360**, **GH020123.MP4**, **GX030456.360**). 2. **Manually rename the files using GoPro's expected structure.** If the original names are not available, 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. If restoring the originals is not possible, follow the procedure below to manually rename the files. ### GoPro file naming convention GoPro video files follow this general naming format: **[Camera Identifier][Chapter Number][Clip Number].[File Extension]** Example: **GS010123.360** #### 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 recognizes all three prefixes. #### Chapter number (01, 02, 03) - Each recording is split into 4 GB segments. - The chapter number indicates the file's position in that session. - For example, **GH010123** is the first segment, **GH020123** is the second, and so on. #### Clip number (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 1: Determine the correct sequence 1. Watch each video to determine the correct sequence. 2. Use visual cues (such as start/stop motions, lighting, or scene progression) to identify the chronological order in which the videos were captured. ### Step 2: Rename the video files 1. 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 determined in Step 1. - Choose a clip number (for example, **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. 2. Double-check that the files are in the correct sequence and that names follow the format **[Camera Identifier][Chapter Number][Clip Number].[File Extension]**. ## Can this data still be processed? 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. ## Related documentation and support - [Emesent Aura Colorization Workflow.](/v1/docs/colorizing-point-clouds-1-1) - [Capture a scan with colorization.](/v1/docs/capture-a-scan-with-colorization) For assistance, contact the regional Emesent partner or the [Emesent Client Support team](https://emesent.com/customer-support/).