FrameExporter

FrameExporter is a macOS app for opening a video, scrubbing to an exact moment, and exporting the current frame as a JPEG.

Features

• Open video files from:
  • In-app file picker
  • Drag and drop
  • Finder Quick Action (Quick Actions > Frame Export)
• Timeline scrubbing with timecode display
• Play / Pause controls
• Frame-by-frame stepping (◀︎ 1 Frame, 1 Frame ▶︎)
• JPEG frame export with conflict-safe filenames:
  • VideoName.jpg
  • VideoName_1.jpg, VideoName_2.jpg, etc.
• Source-folder-first export strategy
• Permission-aware fallback export directory when source folder is not writable
• Grant access flow for source folder write permission

Requirements

• macOS 13.0+
• Xcode 15+ (recommended: latest stable)

Build And Run

1. Open FrameExporter.xcodeproj in Xcode.
2. Select the FrameExporter scheme.
3. Run on My Mac.

Command line:

xcodebuild -project FrameExporter.xcodeproj -scheme FrameExporter -configuration Debug build

Release Build

xcodebuild -project FrameExporter.xcodeproj -scheme FrameExporter -configuration Release -derivedDataPath build build

The app bundle is generated at:

build/Build/Products/Release/FrameExporter.app

Finder Quick Action

The project includes a Finder Quick Action extension (FrameExporterQuickAction).

After installing the app to /Applications, you can right-click a video file and use:

Quick Actions > Frame Export

This opens the selected video directly in FrameExporter.

Permissions

FrameExporter uses macOS sandboxed file access.

If export to the source folder is denied, the app will show a permission message and can request folder access with Grant Folder Access.
If direct write still fails, export falls back to an app-managed export folder.

Tests

Run tests from Xcode, or:

xcodebuild test -project FrameExporter.xcodeproj -scheme FrameExporter -destination 'platform=macOS'

Privacy

• No cloud upload
• No telemetry
• No external API calls

All processing is local on your Mac.