Application
User Manual

Project Selector

Initial UI

- **Choose the analysis type for file**: Selects the analytical pipeline to appl
  • Choose the analysis type for file: Selects the analytical pipeline to apply to the dropped video file.
  • Normal: Assigns a heuristic analysis pipeline for video footage consisting of a single, continuous shot.
  • Storyboard: Assigns a pipeline for edited videos consisting of multiple clips, identifying a representative keyframe for each detected shot.
  • Extract Sequences: Assigns a pipeline for edited videos consisting of multiple clips, automatically detecting shot boundaries and splitting the video into distinct, separate sequences.

Progress

- **Progress...**: Indicates an active, long-running background process.
- **Sco
  • Progress...: Indicates an active, long-running background process.
  • Score: 105%, Analysis done: Displays the final quality rating and confirms the completion of the neural analysis for the specific frame currently shown.
  • Thumbnail Preview: Provides a visual reference of the frame currently being analyzed or processed.
  • Activity Indicator: Signals that the process is actively running.
  • Analyzing frame 96 of 122...: Identifies the specific operation and current stage within the overall task.
  • Progress Bar: Visualizes the overall completion percentage of the task.
  • 17%: Displays the exact numerical completion value.
  • Coverage: 31%: Reports the proportion of the video's total timeline that has been fully evaluated.
  • 4.05% per minute: Provides a measure of the current processing speed.
  • About 45 seconds...: Estimates the remaining time until the operation finishes.

Main UI

Main

- **Undo and Redo**: Reverts or reapplies the most recent user action to modify
  • Undo and Redo: Reverts or reapplies the most recent user action to modify the project state.
  • Eye Icon: Toggles the visual display of neural network bounding boxes (overlays for detected faces, eyes, and pets) on the main preview image.
  • Star Icon: Flags the currently selected frame as a favorite to prioritize it in sorting and export workflows.
  • Export Button: Initiates the process of saving the currently displayed frame or selected frames to disk based on the configured export settings.
  • Zoom Controls (+, -, fitting): Magnifies, reduces, or resets the viewport scale of the main preview image to allow detailed inspection.
  • Timestamp Overlay: Displays the specific timecode of the currently displayed frame, indicating its absolute position within the source video.
  • Score Panel: Shows the computed aesthetic quality score of the currently selected frame using a circular progress indicator and a percentage value.
  • Filters Section: Provides toggles for non-destructive AI enhancement filters (AI Denoise, AI Low Light Fix, AI DeBlur, Sharpen, Enhance), which are applied in real-time to the preview.
  • Metadata Display: Lists recognized visual subject tags (e.g., outdoor, land, grass) generated by computer vision, and shows the resolution dimensions of the source frame.
  • Filter Search Field: Allows filtering the grid of candidate frames below by keywords, matching against automatically generated subject tags and optical character recognition (OCR) text.
  • Candidate Thumbnails Grid: Displays all analyzed keyframes that meet the current quality and visibility criteria. The blue border indicates the active selection.
  • Score Badges: Each thumbnail displays its individual aesthetic quality score, allowing for quick comparison across the timeline.
  • Visibility Toggles (Show All, Show Favorites Only, Hide Ignored): Controls which frames are displayed in the candidate grid based on their user-assigned marks (normal, favorite, or ignored).
  • Selection Controls (Select All, Deselect All): Batch-selects or clears the selection of all frames currently visible in the grid.
  • Frame Marking Actions (Hide, Favorite, unfavorite): Assigns categorization states (ignore or favorite) to the selected frames to manage workflow visibility and priority.
  • Export Action: Triggers the bulk export of all currently selected frames.
  • Weights Button: Opens a configuration panel to adjust the scoring importance (weights) applied to specific detected features, such as faces, eyes, or pets.
Element 1
Element 1
  • Eye slash icon: Toggles the frame's categorization state to "ignored," which hides it from standard grid views and filter results to clean up the workspace.
  • Star icon: Flags the frame as a "favorite," prioritizing it for sorting and bulk export workflows.
Element 2
Element 2
  • 00:00:02:09: Displays the precise timecode of the currently displayed frame, indicating its position within the source video timeline.
Element 3
Element 3
  • Score: Identifies the quantitative aesthetic rating of the currently selected frame.
  • 70%: Displays the calculated quality value as a percentage.
  • Circular progress indicator: Visualizes the aesthetic score, providing a quick, intuitive gauge of the frame's overall quality based on the active evaluation weights.
Element 4
Element 4
  • Filters: Identifies the section of the interface dedicated to non-destructive image enhancement options.
  • AI Denoise: Applies a neural network to reduce sensor grain and compression artifacts from the image.
  • AI Low Light Fix: Activates an AI-driven process to correct exposure issues and recover detail from underexposed areas.
  • AI DeBlur: Triggers an AI upscaling and deblurring process to restore focus and detail to soft images.
  • Sharpen: Applies an edge-contrast enhancement to increase micro-detail and clarity.
  • Enhance: Enables automatic color, contrast, and tonal level corrections to improve overall visual balance.
Element 5
Element 5
  • outdoor, land, grass: Displays a comma-separated list of visual categories generated by the computer vision engine, identifying the primary subjects and scene elements detected within the current frame. These tags are used for filtering and searching.
Element 6
Element 6
  • Source Frame Size: 1904x1088: Displays the native resolution (width by height in pixels) of the currently viewed frame, as extracted from the original source video file.
Element 7
Element 7
  • Gauge icon: Sorts the list of analyzed frames by their aesthetic quality score, prioritizing frames with the highest visual rating.
  • Clock icon: Sorts the list of analyzed frames chronologically according to their original position in the video timeline.
Element 8
Element 8
  • Show All: Displays every analyzed frame in the grid, regardless of its assigned mark or categorization state.
  • Show Favorites Only: Filters the grid to display only the frames that have been flagged with a favorite status.
  • Hide Ignored: Filters the grid to exclude frames that have been manually marked as ignored, removing them from the current view.
Element 9
Element 9
  • Select All: Selects every frame currently visible in the candidate grid.
  • Deselect All: Clears the selection status from all previously selected frames.
Element 10
Element 10
  • Hide: Marks the currently selected frames as "ignored," which will remove them from standard grid views and filter results.
  • Favorite: Flags the currently selected frames with a favorite status to prioritize them in sorting and export workflows.
  • unfavorite: Removes the favorite status from the currently selected frames, reverting them to a normal state.
  • Export: Initiates the process to save the currently selected frames to the configured output destination using the specified export settings.
Element 11
Element 11
  • Weights: Opens a configuration panel to adjust the scoring multipliers assigned to specific detected features (such as faces, eyes, or pets), which changes how the overall aesthetic score is calculated for each frame.

Weights

- **Weights**: Title of the panel used to adjust the scoring parameters for the
  • Weights: Title of the panel used to adjust the scoring parameters for the document's aesthetic evaluation.
  • Document Weights: Identifies the section containing the configurable scoring multipliers applied to detected visual features.
  • Faces Slider: Adjusts the scoring multiplier assigned to detected human faces, affecting how much they contribute to the overall frame score.
  • Eyes Slider: Adjusts the scoring multiplier assigned to detected human eyes, affecting how much they contribute to the overall frame score.
  • Pets Slider: Adjusts the scoring multiplier assigned to detected animals, affecting how much they contribute to the overall frame score.
  • Avoid Texts Toggle: When active, frames containing recognized text are penalized or excluded from peak scoring results.

Settings

Display

### Thumbnail Size Setting

Controls the display dimensions of frame thumbnails
Thumbnail Size Setting

Controls the display dimensions of frame thumbnails in the grid.

  • 130 px: The current setting is displayed as a numerical value, representing the size in pixels.
  • Adjusting this value increases or decreases the visual scale of thumbnails, allowing you to fit more or fewer frames into the workspace.

Analysis

### Storyboard

**Sequence Min. Length**: Defines the minimum number of frames a
Storyboard

Sequence Min. Length: Defines the minimum number of frames a detected shot must contain to be considered a distinct sequence. Shots falling below this threshold are merged with neighboring clips to prevent the creation of overly short, fragmented segments.

Default Weights

These multipliers determine the influence of specific visual features on a frame's overall aesthetic score.

  • Faces: The scoring weight applied to detected human faces.
  • Eyes: The scoring weight applied to detected human eyes.
  • Pets: The scoring weight applied to detected animals.
  • Avoid Texts: When enabled, frames containing readable text are penalized or excluded from top results.
Split Sequences

Configures the deep analysis of individual shots.

  • Deep Analysis Percentage: The proportion of frames within a detected shot that undergo full visual evaluation.
  • Min. Frames: The minimum number of frames evaluated per sequence.
  • Enable Max Frames: Toggles a maximum limit on the number of frames evaluated per sequence.
  • Threads: The number of CPU cores allocated for parallel processing of sequence analysis.
Skip Short Sequences
  • Skip Short Sequences: When enabled, sequences shorter than the minimum duration are skipped during analysis to save processing time.
  • Minimum Duration: The minimum duration (in seconds) a sequence must have to be evaluated.

Export

The interface is divided into three primary functional topics. Below is a summar

The interface is divided into three primary functional topics. Below is a summary of the purpose for each numbered segment.

  1. Image and Video Format Settings

This segment configures the output file type and quality for media exports. For images, it defines the compression format and the visual quality level. For video, it specifies the encoding codec, the target data rate, and includes a control to embed the original audio track into the exported clip.

  1. Sub-Sequence Duration Limits

This topic controls the length of exported video clips when the source has been segmented into individual shots. It allows the user to choose between exporting the entire detected shot or truncating the output to a specific maximum duration. The current duration limit is adjusted using a dedicated control.

  1. Destination and File Naming

This segment manages the file system output location and naming conventions. It defines where the exported files are saved relative to the source file's location, sets the base name for the output files, and allows for the addition of custom prefixes or suffixes to the file names.

Element 1
Element 1
Image Format
  • Format: Selects the file format (JPEG, PNG, or HEIC) for exported images.
  • Quality: Sets the compression quality, affecting file size and visual fidelity.
Video Format
  • Video Codec: Selects the compression codec (ProRes 422, H.264, or H.265).
  • Video DataRate: Determines the target bitrate in megabits per second, balancing quality and file size.
  • Include Audio Track: When enabled, the original audio is retained in the exported video clip.
Element 2
Element 2
Sub Sequences
  • Export: Determines whether to export the entire shot ("All Video") or only a specific portion of it ("Max Length").
  • Duration: When "Max Length" is selected, defines the maximum duration (in seconds) of the exported clip.
Element 3
Element 3
Destination
  • Save To: Sets the target folder location (e.g., a subfolder within the source file's directory).
  • Name: Specifies the name of the destination folder.
  • Add Prefix: Appends a custom text string to the beginning of exported file names.
  • Add Suffix: Appends a custom text string to the end of exported file names.

Advanced