@hasna/recordings 0.1.4 → 0.1.6

package/src/native/Recordings/test_fn2.swift

@@ -0,0 +1,33 @@
+#!/usr/bin/env swift
+// Test: NSEvent.addGlobalMonitorForEvents — does it see fn key?
+import Cocoa
+
+print("Testing NSEvent global monitor for 15 seconds...")
+print("Press fn, Option, any key. Ctrl+C to quit.\n")
+
+let app = NSApplication.shared
+app.setActivationPolicy(.accessory)
+
+// Monitor flagsChanged (modifier keys including fn)
+NSEvent.addGlobalMonitorForEvents(matching: [.flagsChanged, .keyDown, .keyUp]) { event in
+    if event.type == .flagsChanged {
+        let fn = event.modifierFlags.contains(.function) ? " [fn]" : ""
+        let cmd = event.modifierFlags.contains(.command) ? " [cmd]" : ""
+        let opt = event.modifierFlags.contains(.option) ? " [opt]" : ""
+        let ctrl = event.modifierFlags.contains(.control) ? " [ctrl]" : ""
+        print("flagsChanged  keyCode=\(event.keyCode)\(fn)\(cmd)\(opt)\(ctrl)")
+    } else if event.type == .keyDown {
+        print("keyDown       keyCode=\(event.keyCode)  chars=\(event.characters ?? "")")
+    } else if event.type == .keyUp {
+        print("keyUp         keyCode=\(event.keyCode)")
+    }
+}
+
+print("✅ Global monitor registered\n")
+
+DispatchQueue.main.asyncAfter(deadline: .now() + 15) {
+    print("\nDone.")
+    exit(0)
+}
+
+app.run()

package/src/native/RecordingsHelper.swift

@@ -60,11 +60,47 @@ class AppDelegate: NSObject, NSApplicationDelegate {
 
     // ── Global Hotkey ───────────────────────────────────────────────────────
 
+    /// Check if Accessibility permission is granted. If not, show a dialog and open System Settings.
+    func checkAccessibilityPermission() -> Bool {
+        // First check without prompting
+        let trusted = AXIsProcessTrustedWithOptions(
+            [kAXTrustedCheckOptionPrompt.takeUnretainedValue(): false] as CFDictionary
+        )
+        if trusted { return true }
+
+        // Not trusted — show dialog explaining why we need it
+        let alert = NSAlert()
+        alert.messageText = "Accessibility Permission Required"
+        alert.informativeText = "RecordingsHelper needs Accessibility access to detect the global hotkey (hold Space to record).\n\nClick 'Open Settings' to grant permission, then restart the app."
+        alert.alertStyle = .warning
+        alert.addButton(withTitle: "Open Settings")
+        alert.addButton(withTitle: "Quit")
+
+        let response = alert.runModal()
+        if response == .alertFirstButtonReturn {
+            // Prompt the system dialog AND open System Settings > Accessibility
+            AXIsProcessTrustedWithOptions(
+                [kAXTrustedCheckOptionPrompt.takeUnretainedValue(): true] as CFDictionary
+            )
+            if let url = URL(string: "x-apple.systempreferences:com.apple.preference.security?Privacy_Accessibility") {
+                NSWorkspace.shared.open(url)
+            }
+        } else {
+            NSApplication.shared.terminate(nil)
+        }
+        return false
+    }
+
     func registerHotkey() {
         // Hold Space for 1+ second to start recording, release to stop.
         // Uses CGEventTap to monitor all keyboard events globally.
         // Normal space presses (< 1 second) pass through untouched.
 
+        // Check Accessibility permission BEFORE attempting event tap
+        if !checkAccessibilityPermission() {
+            return
+        }
+
         let eventMask: CGEventMask = (1 << CGEventType.keyDown.rawValue) | (1 << CGEventType.keyUp.rawValue) | (1 << CGEventType.flagsChanged.rawValue)
 
         guard let tap = CGEvent.tapCreate(