CueRecord

CueRecord is a native macOS recording app for screen demos, tutorials, product walkthroughs, and teleprompter-assisted presentations.

It combines high-resolution screen recording, optional camera overlay, microphone/system audio capture, and a built-in teleprompter workflow in one desktop app.

Download

Download the latest signed and notarized macOS build:

• Download CueRecord.dmg
• Release notes

Features

• High-resolution screen recording for full screen, window, and selected-area workflows
• Multi-display support, including external display selection
• Optional camera overlay with draggable preview window
• Microphone and system audio capture
• Single-track mixed audio output in the final composited recording
• Built-in teleprompter with adjustable line count and follow-along behavior
• Minimal export progress in the project sidebar
• Raw recording assets organized under raw_data/ while the final composited movie stays in the project folder
• Developer ID signed, notarized, and stapled DMG for distribution

Permissions

CueRecord uses standard macOS privacy permissions:

• Screen Recording: required to capture the selected display, window, or area
• Microphone: required when recording voice or using speech-guided teleprompter behavior
• Camera: required for the camera overlay
• System Audio: required when system audio recording is enabled

You can manage these permissions in macOS System Settings under Privacy & Security.

Requirements

• macOS 15.7 or later
• Apple Silicon or Intel Mac

Build From Source

This repository uses Git LFS for bundled model and native library assets. Install Git LFS before cloning or pulling dependencies.

git lfs install
git clone https://github.com/nolangz/CueRecord.git
cd CueRecord
git lfs pull

Build a local debug app:

xcodebuild \
  -project CueRecord.xcodeproj \
  -scheme CueRecord \
  -configuration Debug \
  -destination 'platform=macOS' \
  build

Run focused recording-core checks:

scripts/run-recording-core-tests.sh

Release Build

build.sh creates a universal macOS app, signs it with Developer ID, builds a DMG, submits it to Apple notarization, staples the ticket, and validates the final artifact.

Prerequisites:

• Xcode command line tools
• Developer ID Application certificate installed in Keychain
• Apple notarization credentials saved in a notarytool keychain profile
• Git LFS assets pulled locally

Default release environment:

TEAM_ID=JKDNYL5U42
SIGN_IDENTITY='Developer ID Application: NUOLIN LAI (JKDNYL5U42)'
NOTARY_PROFILE=cuerecord-notary

Create a release DMG:

./build.sh

The output is written to:

build/release/CueRecord.dmg

Project Structure

CueRecord/                App source
CueRecord/Recording/      Recording pipeline, UI, selection, metrics, export organization
Tests/RecordingCoreTests/ Focused command-line checks for recording core behavior
Vendor/                   Git LFS tracked native libraries and local ASR model assets
build.sh                  Signed, notarized release DMG build script

Notes

• Final exported recordings are designed to contain a single mixed audio track.
• Intermediate screen, camera, overlay metadata, and metrics files are kept under raw_data/.
• Large bundled assets are tracked with Git LFS and are required for a complete local build.