Good Frame

Good Frame


headline.png
Good Frame is a Mac app for cropping and encoding videos and images with precision.

cta-download.png
cta-github.png

Download, unzip, and move Good Frame to Applications. Try opening it once. An app downloaded from the web can be blocked because it is not notarized by Apple:

Or verify and build the app from the source code.


heading-video-image.png
feature-video-and-image-framed.png
Open a video or image.

heading-zoom.png
feature-zoom-framed.png
Zoom and pan with the trackpad, mouse, and keyboard to get a closer look.

heading-preview.png
feature-preview-framed.png
Hide the crop UI for a clean look. Adjust the crop with the mouse or keyboard.

heading-spot.png
feature-background-framed.png
Change the canvas color to spot a bad frame and see how the file will fit.

heading-encode.png
feature-encode-framed.png
Export videos to H264 for maximum compatibility or HEVC with HDR support.
Choose the compression quality with a single slider.

heading-capture.png
feature-capture-framed.png
Step through videos frame by frame and save to image with HDR support.

heading-export.png
feature-review-framed.png
Review the result before naming and saving.
Copy or drag directly from the export window.

Specs

Native macOS app. Requires macOS 15.6 or later.

Video

Image


Context

I needed to crop and prepare videos for my website. With Apple's Photos and online cropping tools, I couldn't easily zoom in to fine-tune the crop, and the cropped video could be aggressively recompressed.

It turns out cropping a video isn't trivial. Most videos are already compressed, including screen recordings made by macOS and iOS. Therefore opening a video is decoding it. Cropping a video means removing parts of each frame and then encoding it again, which can reduce quality.

My first try was asking AI to make a web app using FFmpeg WASM. But I wasn't happy with the encoding quality and performance. I also tried Handbrake, but Handbrake has a horrendous UI. It's hard to find the right encoding settings, and cropping is done by entering numbers without visual feedback.

I decided to make a native macOS utility with AVFoundation, which I had used before to successfully encode videos (see SpriteKit Offline Rendering). The results were faster and better than what I got with FFmpeg on the web.

While making the app, I added features I needed such as hiding the crop UI, changing the canvas color, and exporting a video frame as an image.

Good Frame was written by GPT 6.1 Sol with a GPT 6 Astra pass early on. It's the first macOS app I make entirely with AI. The main code is a single Swift file over 4000 lines long, left as is on purpose. It took less than a day to get a working app. Then it took many days and counting to improve the UI, guide the AI toward better techniques such as how to implement smooth video scrubbing with AVFoundation, and get the app to follow Mac conventions and expectations. Things like copying content, having a proxy icon in the export window, and opening a new window from the Dock menu.

If you have feedback, contact me on X/Twitter or by e-mail.


License

Free for personal and professional use. Reselling or repackaging the app for sale requires permission. Read the license.