Skip to content

Latest commit

 

History

11 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Simple Screen Recorder for MacOS

SimpleRecorder is a lightweight macOS menu bar app for recording your screen with optional microphone audio and a floating camera view. It also provides activity-based zoom and click effects for clearer demonstrations.

Requirements

  • macOS 12.3 or later
  • Swift compiler and macOS command line developer tools
  • An AppIcon.icns file in the project root for the packaged build

Build

Run the build script from the project root:

./build.sh

The script creates:

  • build/SimpleRecorder.app
  • build/SimpleRecorder.dmg

The app is built as an x86_64 binary and ad hoc signed with the included entitlements.

Permissions

On first launch, macOS may ask for these permissions in System Settings > Privacy & Security:

  • Screen Recording
  • Accessibility
  • Camera
  • Microphone

Accessibility permission is used for activity tracking and zoom behavior. Camera and microphone capture are optional, but require their respective permissions when enabled.

Controls

  • Command + Shift + R: Start or stop recording from any app
  • Camera expand button: Expand the floating camera view while recording
  • Escape: Return an expanded camera view to its floating state

Project Layout

  • Sources/main.swift: Application and recording implementation
  • Info.plist: App bundle metadata and permission descriptions
  • Entitlements.plist: App entitlements
  • build.sh: App and DMG build script
  • RELEASE_NOTES.md: Release history

About

SimpleRecorder is a native macOS screen-recording app with microphone input, a floating camera overlay, global hotkeys, activity-based cursor zoom, click effects, and smooth 16:9 video output for polished tutorials and demos.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages