Skip to content

pardeike/ScreenLog

Repository files navigation

ScreenLog

ScreenLog is a native macOS menu bar recorder built to stay out of the Dock and App Switcher while still giving you fast hotkey-driven recording.

What Works

  • Menu bar agent app with LSUIElement
  • Global shortcuts for:
    • toggle recording
    • optional dedicated start
    • optional dedicated stop
    • optional show settings
  • Capture target configuration for:
    • full display
    • specific window
    • application-scoped capture
    • arbitrary rectangle on a chosen display
  • Native ScreenCaptureKit recording pipeline with MP4 output
  • Optional system audio, microphone, cursor, and mouse click highlighting
  • Output folder selection
  • Window-trigger automation:
    • match by bundle identifier
    • optional window-title substring
    • auto-start when a match appears
    • optional auto-stop when the match disappears

Build

Generate the project and build it:

xcodegen generate
xcodebuild -project ScreenLog.xcodeproj -scheme ScreenLog -configuration Debug build

The app bundle is produced directly in the repository root:

./ScreenLog.app

Run

Launch the built app:

open ./ScreenLog.app

On first use, macOS will require Screen Recording permission. If microphone capture is enabled, it will also request microphone access.

Notes

  • Window and application lists depend on Screen Recording permission because they come from ScreenCaptureKit shareable content.
  • The rectangle selector is currently display-relative and intended for fast arbitrary region capture.
  • This project is unsandboxed and unsigned in local builds to keep development friction low.

Product Direction

The implementation plan and next steps live in docs/PRODUCT.md.

About

Native macOS menu bar screen recorder with hotkeys and ScreenCaptureKit

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Languages