Aperture logo

Aperture

Swift library for high‑fidelity macOS screen and audio capture

A native Swift API that records macOS screens, windows, audio, or connected iOS devices with configurable video codecs, frame rates, and audio options.

Overview

Highlights

Record full screen, specific window, or custom region
Capture system audio, microphone, or both with lossless ALAC option
Choose from H.264, HEVC, ProRes 422, and ProRes 4444 codecs
Support for external iOS device capture

Pros

  • Native Swift implementation leverages AVFoundation for performance
  • Fine‑grained control over video and audio parameters
  • Simple async API integrates with modern Swift concurrency
  • Supports macOS 13+ and recent hardware

Considerations

  • Limited to macOS; no Windows or Linux support
  • Requires Xcode 15+ and Swift 5.7+
  • Click‑highlighting only available on macOS 15+
  • No built‑in UI; developers must create their own interface

Managed products teams compare with

When teams consider Aperture, these hosted platforms usually appear on the same shortlist.

Google Meet logo

Google Meet

Video conferencing and collaboration platform

Loom logo

Loom

Instant video messaging and screen recording for teams

Zoom logo

Zoom

Video conferencing and online meeting platform

Looking for a hosted option? These are the services engineering teams benchmark against before choosing open source.

Fit guide

Great for

  • Developers building macOS utilities that need screen capture
  • Automation scripts that generate screencasts programmatically
  • Testing frameworks that record UI interactions
  • Apps that bundle video tutorials or demos

Not ideal when

  • Cross‑platform projects requiring Windows or Linux recording
  • Users needing a ready‑made graphical recorder
  • Environments without Xcode or Swift toolchain
  • Real‑time streaming where ultra‑low latency is critical

How teams use it

Automated tutorial generation

Create high‑quality video guides directly from code without manual recording.

UI test documentation

Record test runs to review UI behavior and debug failures.

Live demo capture for product releases

Capture screen and system audio in a single step for marketing videos.

iOS device screen mirroring

Record the display of a connected iPhone or iPad for app demos.

Tech snapshot

Swift100%
Shell1%

Tags

apertureswiftkapmacosscreen-recordercapturescreencastavfoundationrecord

Frequently asked questions

What macOS versions are supported?

Aperture runs on macOS 13 Ventura and later.

Do I need a GUI to start recordings?

No. The API is headless; you control recordings programmatically.

Can I record both system audio and microphone simultaneously?

Yes, enable `recordSystemAudio` and provide a `microphoneDeviceID`.

Which video codecs are available?

H.264, HEVC, ProRes 422, and ProRes 4444.

Project at a glance

Dormant
Stars
1,296
Watchers
1,296
Forks
113
LicenseMIT
Repo age9 years old
Last commitlast year
Primary languageSwift

Last synced 12 hours ago