QuickRecorder

A lightweight and high-performance screen recorder for macOS
[中文版本]
[Landing Page]

Screenshot

Installation and Usage

System Requirements:

• macOS 12.3 and Later

Install:

Download the latest installation file here.

Features/Usage:

• You can use QuickRecorder to record your screens / windows / applications / mobile devices... etc.

• QuickRecorder supports driver-free audio loopback recording, mouse highlighting, screen magnifier and many more useful features.

• The new "Presenter Overlay" in macOS 14 was fully supported by QuickRecorder, which can overlay the camera in real time on your recording (macOS 12/13 can only use camera floating window)

• QuickRecorder is able to record HEVC with Alpha video format, that can contain alpha channel in the output file (currently only iMovie and FCPX support this feature)

CLI Companion

QuickRecorder also ships with a companion CLI named quickrecorder for local automation and scripted recording flows.

When quickrecorder needs to launch QuickRecorder.app, the app starts in automation mode:

• it does not open the main panel
• it stays available to the CLI in the background
• if Dock display is enabled in settings, the app can still appear in the Dock without showing a window

Currently verified commands:

• quickrecorder list-displays
• quickrecorder list-devices
• quickrecorder start ...
• quickrecorder stop
• quickrecorder status --json

Example: record the main screen for 10 seconds

quickrecorder start screen \
  --display 1 \
  --output /Users/me/Movies/demo.mp4 \
  --high-res x2 \
  --cursor on \
  --hdr off \
  --app-audio off \
  --fps 60 \
  --timeout 10s

Example: record OBS Virtual Camera for 10 seconds

quickrecorder start external-av-device \
  --name "OBS Virtual Camera" \
  --output /Users/me/Movies/obs.mov \
  --timeout 10s

For CLI-launched mobile-device and external-av-device recordings, the floating preview window is disabled by default. If you want it back, enable Show Device Preview for CLI Recording in Settings -> Command Line.

For the fuller command guide, see docs/cli-companion-usage.md.

Q&A

1. Where can I reopen the main panel after closing it?

Click the Dock tile or Menubar icon of QuickRecorder to reopen the main panel at any time.

2. Why does QuickRecorder not a sandbox app?

QuickRecorder has no plans to be uploaded to the App Store, so it does not need to be designed as a sandbox app.

3. How to independently control the volume of system sound and sound from microphone in other video editor?

QuickRecorder will merge the audio input from the microphone to the main audio track after recording by default. If you need to edit the video, you can turn off the Record Microphone to Main Track option in the settings panel. After turning off, the system sound and sound from microphone will be recorded into two audio tracks and can be edited independently.

Thanks

liaochenliang

Author and maintainer of this fork.

lihaoyun6

Thanks to the original author of QuickRecorder.

Azayaka @Mnpn

The source of inspiration and part of the code of the screen recording engine comes from the Azayaka project, and I am also one of the code contributors to this project

KeyboardShortcuts @sindresorhus

QuickRecorder uses this swift library to handle shortcut key events

SwiftLAME @Hidden Spectrum

QuickRecorder uses this swift library to handle MP3 output

ChatGPT @OpenAI

Note: Part of the code in this project was generated or refactored using ChatGPT.