macos-screen-recorder (sck-record)
A Swift CLI tool that records macOS screen with system audio via ScreenCaptureKit, no virtual audio device required.
Maintainer of this project? Claim this page to edit the listing.
0.1.0Add to Favorites
Install
Add it to your toolbox
Run in your project directory:
curl -fsSL https://spark.entire.vc/get/ag-macos-screen-recorder | bash Overview
macos-screen-recorder (sck-record)
CLI screen recorder with system audio via ScreenCaptureKit Script macOS screen captures with system sound from the command line
What it does
macos-screen-recorder (binary: sck-record) is a Swift-based command-line tool that captures your main macOS display plus system audio using ScreenCaptureKit. It addresses the gap left by QuickTime and screencapture -v for scripted screen recording with system sound from the CLI, without installing BlackHole or loopback virtual devices, and without requiring sudo.
When to use - and when NOT to
Use sck-record when you need to script a screen recording with system sound on macOS from the CLI - for demos, captures, or voice-demo recording. This is the case QuickTime and screencapture -v can't cover without a virtual audio device.
When NOT to use: This tool records the main display and system audio, nothing more. The recorder captures raw display and system audio but does not provide editing, auto-zoom, captions, or social-format polish by itself. For post-production features like idle speed-up, auto-zoom, keystroke chips, smoothed cursor, or vertical export, pair sck-record with a separate post-processing tool like screenstudio-alternative-skill.
Inputs and outputs
You provide two arguments: an output file path and recording duration in seconds:
./sck-record <out.mp4> <seconds>
The tool records the main display and system audio. The source material mentions a --no-cursor option for use with post-production workflows that require an input-event log captured during recording. Input-event overlays require a separate event log captured during recording; pixels alone cannot reconstruct keystrokes or precise click metadata.
Integrations
The source material identifies compatibility with screenstudio-alternative-skill for post-production. After recording with sck-record --no-cursor <out.mp4> <seconds>, you can run that skill's post-production pass on the resulting mp4. The source notes that auto-zoom and keystroke overlays additionally need an input-event log captured during recording, which that skill supplies; sck-record's pixels alone cover idle speed-up, cursor smoothing, and vertical export.
Who it's for
Developers and technical content creators who need to script screen recordings with system audio on macOS from the command line. The tool fills the headless-CLI-with-system-audio gap.
Limitations
macOS only - the tool depends on ScreenCaptureKit and the user's Screen Recording permission. The recorder captures raw display and system audio but does not provide editing, auto-zoom, captions, or social-format polish by itself. Input-event overlays require a separate event log captured during recording; pixels alone cannot reconstruct keystrokes or precise click metadata.
Source README
When to Use
Use when you need to script a screen recording WITH system sound on macOS from the CLI (demos, captures, voice-demo recording) - the case QuickTime and screencapture -v can't cover without a virtual audio device.
Source: connerkward/macos-screen-recorder-system-audio (MIT).
macos-screen-recorder (sck-record)
sck-record.swift → compiled sck-record (binary gitignored; built by setup-machine, orswiftc -O sck-record.swift -o sck-record). Records the main display + system audio via
ScreenCaptureKit.
./sck-record <out.mp4> <seconds>
The one true differentiator: system audio from the CLI with zero install - no
BlackHole / loopback virtual device, no sudo; only the standard Screen Recording permission
(granted once to whatever app shells out). It is not a general "better than OBS/Screen
Studio" tool - it fills exactly the headless-CLI-with-system-audio gap.
sck-record is the raw capture primitive - it records, nothing more. To polish a
recording afterward (idle speed-up, auto-zoom, keystroke chips, smoothed cursor,
vertical export), pair it with
screenstudio-alternative-skill:
record with sck-record --no-cursor <out.mp4> <seconds>, then run its post-production
pass on the resulting mp4. (Auto-zoom and keystroke overlays additionally need an
input-event log captured during recording, which that skill supplies; sck-record's
pixels alone cover idle speed-up, cursor smoothing, and vertical export.)
Limitations
- macOS only; it depends on ScreenCaptureKit and the user's Screen Recording permission.
- The recorder captures raw display and system audio but does not provide editing, auto-zoom, captions, or social-format polish by itself.
- Input-event overlays require a separate event log captured during recording; pixels alone cannot reconstruct keystrokes or precise click metadata.
FAQ
Common questions
Discussion
Questions & comments · 0
Sign In Sign in to leave a comment.