Vello Support

System requirements

• macOS 15 Sequoia or later
• Screen Recording permission for display, window, or region capture
• Microphone permission only when audio recording is enabled

Start a recording

1. Open Vello from the menu bar and choose New Recording, or use the configured global shortcut.
2. Select a region, full display, or window. Choose 30 or 60 fps and optionally enable the microphone, cursor, or click highlighting.
3. Press the red record button. While recording, use the menu-bar control to pause, resume, or stop.
4. Preview and trim the result, choose the scale, frame rate, format, and save location, then select Export.

Screen Recording permission

If capture is unavailable or the recorded area is blank, open System Settings → Privacy & Security → Screen Recording and allow Vello. macOS may require you to quit and reopen the app after changing the permission.

Export formats

• MP4 — H.264 video with optional audio
• HEVC — efficient HEVC video with optional audio
• GIF — looping animated image without audio
• APNG — looping animated PNG without audio

Build Vello from source

Development requires Xcode 26 or later and XcodeGen. Run xcodegen generatein the repository, then open Vello.xcodeproj. The project's configured development team must be changed to your own signing team.

VelloKit can be tested independently by running swift test inside its folder. Live capture tests skip when Screen Recording permission is unavailable.

Ask for help or report a bug

Because Vello is open source, reproducible bugs and focused improvements can be reported in the public repository. Include your macOS version, Vello build, capture type, export settings, expected result, and actual result. Do not attach sensitive recordings unless you intentionally choose to share them.