Help

Install, record, update and remove.

App blocked by macOS?

RecordStuff isn't notarized by Apple, so macOS may block it on first launch and after updates. Don't click Done; instead:

  1. Open System Settings → Privacy & Security.
  2. Scroll to Security, click Open Anyway next to RecordStuff and confirm.

For malware or damaged-file warnings, stop and report the issue. Apple’s instructions ↗

Install

  1. Open the DMG and drag RecordStuff onto Applications

    Then eject the DMG.

  2. Open RecordStuff from Applications

    If macOS blocks it, see ‘App blocked by macOS?’ above.

  3. Allow Screen & System Audio Recording

    Follow the app's prompt to System Settings → Privacy & Security, allow RecordStuff, then choose Quit & Reopen. Allow the system audio prompt too if one appears.

  4. Record from the menu bar

    Click the icon and choose Start recording, or press ⇧⌘1. Stop the same way.

Opening the app and recording the screen are separate permissions; both are needed. If prompts keep coming back, open RecordStuff from Applications and relaunch it. Microphone asks for its own access; while it is refused, a recording with Microphone on does not start: allow RecordStuff in System Settings → Privacy & Security → Microphone, or turn Microphone off.

Record

  • Start: click the menu bar icon and choose Start recording, or press ⇧⌘1.
  • Cancel or stop: the same menu or shortcut. Cancelling during the countdown saves nothing.
  • Find recordings: click the saved notification, or choose Show last recording or Open RecordStuff from the menu. RecordStuff lists your recordings, where you can play, rename, edit, reveal or delete them.

RecordStuff records one whole screen with system audio, and your microphone if you turn it on, to an H.264/AAC MP4. To change how, open RecordStuff (⌥⌘,):

Recording
SettingOptionsDefault
ScreenPrimary or a connected displayPrimary
Hide menu barOn / Off; leaves the menu bar and its icons out of recordings, and the strip it keeps at the topOff
Hide DockOn / Off; leaves the Dock out of recordings, and its strip when it stays on screenOff
Hide desktop icons and widgetsOn / Off; leaves desktop icons and widgets out of recordingsOff
Output folderAny folderMovies → RecordStuff
File name formatA pattern of {date}, {time} and other placeholders{date} {time}
Editable recordingsOn / Off; keeps the camera and each sound apart, so Edit… can still change them. Files are about twice as largeOff
CountdownOff / 3 / 5 / 10 s, with an optional tick3 s, tick on
System audioOn / Off, also in the menu bar menu and the Recording Studio; off records none of the computer's soundOn
MicrophoneOn / Off, also in the menu bar menu; mixed with system audio (use headphones to avoid speaker echo)On
Input deviceSystem default or a connected microphoneSystem default
CameraOn / Off, also in the menu bar menu; arranged in the Recording StudioOn
Camera deviceSystem default or a connected cameraSystem default
Video qualityEconomy / Standard / HighStandard
Resolution cap1080p / 1440p / 4K / SourceSource
Frame rate30 / 60 fps30 fps
General
SettingOptionsDefault
Icon clickOpen the menu / Start or stopOpen the menu
Shortcut⇧⌘1 / custom / off⇧⌘1
NotificationsOn / OffOn
LanguageEnglish / 繁體中文English
AppearanceSystem / Light / DarkSystem
Check for updates on launchOn / OffOn

While recording, only Icon click, Language and Appearance can change, and Input device while Microphone is on.

Camera

RecordStuff can draw your camera into the recording as a bubble. It is part of the video only: nothing is shown on your screen, so it never covers or catches clicks meant for the app you record.

  • Turn it on: check Camera under Include in recordings in the menu bar menu, or turn on Camera in Recording settings, where Camera device picks the camera. macOS asks for camera access the first time.
  • If access was refused: click Open camera settings… and allow RecordStuff in System Settings → Privacy & Security → Camera, then click Already allowed? Relaunch RecordStuff; macOS shows a new permission to RecordStuff only after a relaunch. While access is off, a recording with Camera on does not start.
  • Arrange it: choose Open Recording Studio… from the menu bar menu. Drag the bubble in the preview (or move it with the arrow keys), and set its width, height, shape, rounding and mirror. Its place is remembered for each display.
  • Check before recording: turn on Live preview in the Studio to see the recording as it will look, with level meters for system audio and the microphone. Start recording continues from it without a gap.
  • While recording: the bubble can still be moved and resized in the Studio. Choose Hide camera from the menu bar menu, or turn off Show camera in recording in the Studio, to take it out for a while; the next recording shows it again.
  • Volume: the Studio's Audio panel has a mute and a volume for system audio and for the microphone, from 0% to 600%. Mutes last for one recording; volumes are kept for the next ones.

The camera is also offered on Windows, where desktop apps must be allowed in Settings → Privacy & security → Camera; it has not been tested with a camera on Windows hardware.

Edit

Cut out what you don't need. The recording itself is never changed.

  • Cut: in RecordStuff's Recordings, open a recording's menu and choose Edit…. Remove parts at the start, the end or anywhere between.
  • Export: Export saves what is kept as a new file beside it, such as Talk (edited).mp4. The edit is remembered, so it reopens where you left it.
  • Editable recordings: turn on Editable recordings in Recording settings, or choose Start editable recording from the menu bar menu for one recording. The camera and each sound stay apart, so in Edit… you can still move the camera and set the volumes. Files are about twice as large, and other apps play only the screen with system audio until you export.

Update

By default RecordStuff checks for updates at launch and notifies you of a new version. To install it:

  1. Quit RecordStuff from its menu bar icon

  2. Download the new DMG

    Optionally check it with shasum -a 256 against the release's SHA256SUMS.

  3. Drag RecordStuff onto Applications and choose Replace

    Settings are kept, and macOS normally keeps the recording permission. If it asks again, allow it and relaunch.

  4. Open the updated app

    If macOS blocks it, see ‘App blocked by macOS?’ above.

Remove

  1. Quit RecordStuff from its menu bar icon

  2. Drag RecordStuff from Applications to the Trash

    There is no uninstaller or background service. Your data stays where it is, unless you first choose Troubleshooting → Diagnostics and cleanup → Clear and quit… in RecordStuff, which removes everything but recordings:

DataLocation
RecordingsMovies → RecordStuff, or the folder you chose
Settings~/Library/Application Support/recordstuff
Logs~/Library/Logs/recordstuff

Install on Windows

An x64 installer is on the Download page.

Not verified on Windows hardware. CI checks that the installer installs and uninstalls; screen capture, system audio, notifications and the tray have not been tested on Windows hardware.

  1. Run the installer

    It installs for your account only, with no administrator prompt, and adds a Start-menu shortcut.

  2. If SmartScreen appears, choose More info → Run anyway

    Only for an installer from the RecordStuff release. Managed PCs may block this.

  3. Record from the system tray

    Click the icon and choose Start recording, or press Ctrl+Shift+1. Recordings go to Videos → RecordStuff.

Update on Windows

  1. Quit RecordStuff from its tray icon

  2. Run the new installer

    Optionally check it with Get-FileHash against the release's SHA256SUMS. Settings and recordings are kept.

Uninstall on Windows

  1. Quit RecordStuff from its tray icon

  2. Uninstall it in Settings → Apps → Installed apps

    Your data stays where it is:

DataLocation
RecordingsVideos\RecordStuff, or the folder you chose
Settings%APPDATA%\recordstuff
Logs%APPDATA%\recordstuff\logs

This guide is also on GitHub in English and 繁體中文.