FrameForge

This repository hosts public release artifacts for FrameForge, a commercial desktop application for extracting controlled image sequences from video files.

Compatibility: Windows, macOS, and Linux

The application source code is private. This repository exists only for installer downloads, release notes, and signed auto-update metadata.

Why FrameForge

Photogrammetry from video starts with frame extraction, but that process can be tedious to do well. Extracting every frame from 30 or 60 FPS video is often far more than most scenes need, which wastes compute time and memory during alignment and model generation.

FrameForge lets you segment video files by movement speed and actively balance precision against compute cost: use higher FPS where the camera or subject moves quickly, and lower FPS where fewer frames are enough.

The goal is to make frame extraction simple, fast, and intuitive through a video-editor-style interface that feels familiar without turning FrameForge into a full video editor.

What is FrameForge

FrameForge helps turn video files into controlled image sequences. It is built for workflows where different parts of the same source video need different sampling rates.

Key capabilities:

• Segment-based frame extraction with different FPS values per timeline range
• Hardware-accelerated FFmpeg decoding where supported
• Video-editor-style timeline controls for defining extraction ranges
• Gap-aware exports with continuous frame numbering
• JPEG and PNG export options
• Output scaling and JPEG quality controls
• Built-in license activation and offline grace period
• Signed automatic updates

FrameForge is not a full video editor. The timeline is used to define extraction ranges and sampling rates, not to cut or render new video files.

Downloads

Download the latest installer from the Releases page.

Additional files such as .sig files and latest.json are used by the signed auto-updater. Most users do not need to download them manually.

Installation

macOS

1. Download the .dmg for your Mac.
2. Open the disk image.
3. Drag FrameForge into Applications.
4. Launch FrameForge.

If macOS blocks the first launch, open System Settings > Privacy & Security and allow FrameForge to run.

Windows

1. Download the Windows installer.
2. Run the .exe or .msi.
3. Follow the installer prompts.
4. Launch FrameForge from the Start menu.

Linux

Choose the package format that best matches your distribution:

• Use .AppImage for a portable build.
• Use .deb for Debian/Ubuntu-based distributions.
• Use .rpm for Fedora/RHEL-compatible distributions.

Licensing

FrameForge is commercial proprietary software. A valid license is required to use the application.

The app includes:

• license key activation
• machine-based validation
• offline grace period
• license expiry checks
• deactivation support

Installer availability in this public repository does not grant a license to use, copy, modify, reverse engineer, redistribute, or sublicense FrameForge. Use of FrameForge is governed by the commercial license agreement or EULA provided by OpenSpeleo.

Auto-Updates

FrameForge checks this repository for signed update metadata:

https://github.com/OpenSpeleo/FrameForge-Releases/releases/latest/download/latest.json

Updates are cryptographically signed. The installed app verifies update signatures before installing them.

Do not edit, rename, or remove release assets unless you are intentionally publishing or correcting a release. The updater depends on the asset names, download URLs, signatures, and latest.json metadata.

Playback Compatibility

Some files can extract correctly even if inline playback does not work. HEVC/H.265 is a common example on systems whose webview cannot decode the file. If preview fails, use an H.264 MP4 preview copy or continue extracting without relying on inline playback.

Support

For license, installation, or product support, contact OpenSpeleo through the support channel provided with your purchase or license.

When reporting a problem, include:

• FrameForge version
• operating system and version
• installer type used
• video container and codec, if the issue is video-related
• a brief description of what you expected and what happened

Do not post license keys, private videos, or other sensitive data in public issues.

Repository Purpose

This repository is intentionally limited to release distribution.

It may contain:

• release notes
• installers
• updater metadata
• updater signatures

Legal

FrameForge is proprietary commercial software.

Installer availability in this repository does not grant a license to use, copy, modify, redistribute, reverse engineer, or sublicense FrameForge except as expressly allowed by a written commercial license agreement.

Third-party components bundled with FrameForge remain subject to their respective licenses.