BetterCapture Documentation

Concepts

Background knowledge for understanding screen recording settings and terminology.

• Video Concepts: Resolution, frame rate, codecs, compression, containers, pixel formats, color spaces, HDR, alpha channel.
• Audio Concepts: Sample rate, bit depth, channels, audio codecs (AAC, PCM), synchronization.
• Glossary: Quick-reference table of terms.

ScreenCaptureKit

How Apple's ScreenCaptureKit and AVFoundation frameworks work together for screen recording.

• Overview: Key classes (SCStream, SCStreamConfiguration, AVAssetWriter, etc.), class relationships, and the capture-to-disk pipeline.
• Configuration Reference: How SCStreamConfiguration properties map to video/audio concepts. How SCK and AVFoundation settings must align.
• HDR Capture Reference: ScreenCaptureKit HDR configuration, presets, encoding constraints, pitfalls, and verification.

Architecture

How BetterCapture is built. Component structure, data flow, and implementation details.

• Architecture Overview: MVVM structure, component diagram, recording data flow, codec/container support.
• Output Settings: Resolution, bitrate, codec/container compatibility, pixel formats, color profiles, HDR, automatic settings adjustment.

Specifications

• Feature Specs: Detailed specifications for individual features.

Process

• Release Process: Versioning scheme, release steps, Homebrew tap updates.
• Smoke Testing: Manual test matrix covering all codec/container/audio combinations.

Decisions

• Decision Records: Architecture Decision Records (ADRs).