7 struct CapturaApp: App {
9 @NSApplicationDelegateAdaptor(CapturaAppDelegate.self) var appDelegate
11 var body: some Scene {
14 .handlesExternalEvents(preferring: Set(arrayLiteral: "PreferencesScreen"), allowing: Set(arrayLiteral: "*"))
15 .frame(width: 650, height: 450)
17 .handlesExternalEvents(matching: Set(arrayLiteral: "PreferencesScreen"))
18 //.modelContainer(for: CapturaRemoteFile.self)
22 @objc(CapturaAppDelegate) class CapturaAppDelegate: NSObject, NSApplicationDelegate, NSMenuDelegate {
24 @Environment(\.openURL) var openURL
25 var statusItem: NSStatusItem!
26 var captureState: CaptureState = .idle
27 var recordingWindow: RecordingWindow? = nil
28 var preferencesWindow: PreferencesWindow? = nil
29 var boxListener: AnyCancellable? = nil
30 var popover: NSPopover? = nil
32 var captureSession: CapturaCaptureSession? = nil
33 var images: [CGImage] = []
34 var outputFile: CapturaFile? = nil
35 var gifCallbackTimer = ContinuousClock.now
36 var pixelDensity: CGFloat = 1.0
37 var stopTimer: DispatchWorkItem?
38 var remoteFiles: [CapturaRemoteFile] = []
39 var captureSessionConfiguration: CaptureSessionConfiguration = CaptureSessionConfiguration()
41 @objc dynamic var scriptedPreferences: ScriptedPreferences = ScriptedPreferences()
43 func applicationDidFinishLaunching(_ notification: Notification) {
45 NotificationCenter.default.addObserver(
47 selector: #selector(self.didReceiveNotification(_:)),
54 // MARK: - Setup Functions
57 private func setupStatusBar() {
58 statusItem = NSStatusBar.system.statusItem(withLength: NSStatusItem.variableLength)
60 if let button = statusItem.button {
61 button.image = NSImage(systemSymbolName: "rectangle.dashed.badge.record", accessibilityDescription: "Captura")
64 statusItem.isVisible = true
65 statusItem.menu = NSMenu()
66 statusItem.menu?.delegate = self
70 popover?.contentViewController = HelpPopoverViewController()
71 popover?.behavior = .transient
76 private func setupMenu() {
78 statusItem.menu?.removeAllItems()
80 statusItem.menu?.addItem(NSMenuItem(title: "Record", action: #selector(CapturaAppDelegate.onClickStartRecording), keyEquivalent: ""))
81 if (remoteFiles.count > 0) {
82 statusItem.menu?.addItem(NSMenuItem.separator())
83 for remoteFile in remoteFiles {
84 let remoteFileItem = NSMenuItem(title: remoteFile.name, action: #selector(CapturaAppDelegate.onClickRemoteFile), keyEquivalent: "")
85 remoteFileItem.representedObject = remoteFile
86 statusItem.menu?.addItem(remoteFileItem)
89 statusItem.menu?.addItem(NSMenuItem.separator())
90 statusItem.menu?.addItem(NSMenuItem(title: "Open Local Folder", action: #selector(CapturaAppDelegate.onOpenFolder), keyEquivalent: ""))
91 statusItem.menu?.addItem(NSMenuItem.separator())
92 statusItem.menu?.addItem(NSMenuItem(title: "Preferences", action: #selector(CapturaAppDelegate.onOpenPreferences), keyEquivalent: ""))
93 statusItem.menu?.addItem(NSMenuItem(title: "Quit", action: #selector(CapturaAppDelegate.onQuit), keyEquivalent: ""))
96 private func closeWindow() {
97 if let window = NSApplication.shared.windows.first {
102 // MARK: - URL Event Handler
104 func application(_ application: NSApplication, open urls: [URL]) {
105 if (CapturaSettings.shouldAllowURLAutomation) {
107 if let action = CapturaURLDecoder.decodeParams(url: url) {
109 case let .configure(config):
110 NotificationCenter.default.post(name: .setConfiguration, object: nil, userInfo: [
113 case let .record(config):
114 NotificationCenter.default.post(name: .setCaptureSessionConfiguration, object: nil, userInfo: [
117 NotificationCenter.default.post(name: .startAreaSelection, object: nil, userInfo: nil)
122 let alert = NSAlert()
123 alert.messageText = "URL Automation Prevented"
124 alert.informativeText = "A website or application attempted to record your screen using URL Automation. If you want to allow this, enable it in Preferences."
125 alert.alertStyle = .warning
126 alert.addButton(withTitle: "OK")
131 // MARK: - UI Event Handlers
133 func menuWillOpen(_ menu: NSMenu) {
134 if captureState != .idle {
135 menu.cancelTracking()
136 if captureState == .recording {
137 NotificationCenter.default.post(name: .stopRecording, object: nil, userInfo: nil)
142 @objc private func onClickStartRecording() {
143 NotificationCenter.default.post(name: .startAreaSelection, object: nil, userInfo: nil)
146 @objc private func onOpenPreferences() {
147 NSApp.activate(ignoringOtherApps: true)
148 if preferencesWindow == nil {
149 preferencesWindow = PreferencesWindow()
151 preferencesWindow?.makeKeyAndOrderFront(nil)
152 preferencesWindow?.orderFrontRegardless()
156 @objc private func onOpenFolder() {
157 if let directory = FileManager.default.urls(for: .picturesDirectory, in: .userDomainMask).first?.appendingPathComponent("captura") {
158 NSWorkspace.shared.open(directory)
162 @objc private func onClickRemoteFile(_ sender: NSMenuItem) {
163 if let remoteFile = sender.representedObject as? CapturaRemoteFile {
164 if let urlString = remoteFile.url {
165 if let url = URL(string: urlString) {
166 NSWorkspace.shared.open(url)
172 @objc private func onQuit() {
173 NSApplication.shared.terminate(self)
176 // MARK: - App State Event Listeners
178 @objc func didReceiveNotification(_ notification: Notification) {
179 switch(notification.name) {
180 case .startAreaSelection:
182 case .startRecording:
186 case .finalizeRecording:
187 DispatchQueue.main.async {
188 self.finalizeRecording()
193 DispatchQueue.main.async {
196 case .failedtoUpload:
197 DispatchQueue.main.async {
201 if let frame = notification.userInfo?["frame"] {
202 receivedFrame(frame as! CVImageBuffer)
204 case .setConfiguration:
205 DispatchQueue.main.async {
206 if let userInfo = notification.userInfo {
207 if let config = userInfo["config"] as? ConfigureAction {
208 self.setConfiguration(config)
212 case .reloadConfiguration:
213 reloadConfiguration()
214 case .setCaptureSessionConfiguration:
215 if let userInfo = notification.userInfo {
216 if let config = userInfo["config"] as? RecordAction {
217 setCaptureSessionConfiguration(config)
220 case .NSManagedObjectContextObjectsDidChange:
221 DispatchQueue.main.async {
222 self.fetchRemoteItems()
231 func startAreaSelection() {
233 if captureState != .selectingArea {
234 captureState = .selectingArea
235 if let button = statusItem.button {
236 let rectInWindow = button.convert(button.bounds, to: nil)
237 let rectInScreen = button.window?.convertToScreen(rectInWindow)
238 NSApp.activate(ignoringOtherApps: true)
239 recordingWindow = RecordingWindow(captureSessionConfiguration, rectInScreen)
240 recordingWindow?.makeKeyAndOrderFront(nil)
241 recordingWindow?.orderFrontRegardless()
242 boxListener = recordingWindow?.recordingContentView.$box
243 .debounce(for: .seconds(0.3), scheduler: RunLoop.main)
248 self.helpShown = true
249 self.showPopoverWithMessage("Click here when you're ready to record.")
257 func startRecording() {
258 captureState = .recording
262 pixelDensity = recordingWindow?.pixelDensity ?? 1.0
263 recordingWindow?.recordingContentView.startRecording()
264 if let box = recordingWindow?.recordingContentView.box {
265 if let screen = recordingWindow?.screen {
266 captureSession = CapturaCaptureSession(screen, box: box)
268 if let captureSession {
270 stopTimer = DispatchWorkItem {
273 DispatchQueue.main.asyncAfter(deadline: .now() + Double(captureSessionConfiguration.maxLength), execute: stopTimer!)
275 outputFile = CapturaFile()
276 if captureSessionConfiguration.shouldSaveMp4 {
277 captureSession.startRecording(to: outputFile!.mp4URL)
279 captureSession.startRunning()
285 NotificationCenter.default.post(name: .failedToStart, object: nil, userInfo: nil)
288 func stopRecording() {
289 captureState = .uploading
294 if self.captureSessionConfiguration.shouldSaveGif {
295 if let outputFile = self.outputFile {
296 await GifRenderer.render(self.images, at: self.captureSessionConfiguration.frameRate, to: outputFile.gifURL)
299 let wasSuccessful = await self.uploadOrCopy()
301 NotificationCenter.default.post(name: .finalizeRecording, object: nil, userInfo: nil)
303 NotificationCenter.default.post(name: .failedtoUpload, object: nil, userInfo: nil)
308 func finalizeRecording() {
309 captureState = .uploaded
311 DispatchQueue.main.asyncAfter(deadline: .now() + 2.0) {
312 NotificationCenter.default.post(name: .reset, object: nil, userInfo: nil)
319 captureSessionConfiguration = CaptureSessionConfiguration()
323 func receivedFrame(_ frame: CVImageBuffer) {
324 let now = ContinuousClock.now
326 if now - gifCallbackTimer > .nanoseconds(1_000_000_000 / UInt64(captureSessionConfiguration.frameRate)) {
327 gifCallbackTimer = now
328 DispatchQueue.main.async {
329 if let cgImage = frame.cgImage?.resize(by: self.pixelDensity) {
330 self.images.append(cgImage)
336 func failed(_ requestPermission: Bool = false) {
337 captureState = .error
339 if requestPermission {
340 requestPermissionToRecord()
343 DispatchQueue.main.asyncAfter(deadline: .now() + 2.0) {
344 NotificationCenter.default.post(name: .reset, object: nil, userInfo: nil)
348 func setConfiguration(_ config: ConfigureAction) {
349 CapturaSettings.apply(config)
352 func reloadConfiguration() {
353 self.captureSessionConfiguration = CaptureSessionConfiguration()
356 func setCaptureSessionConfiguration(_ config: RecordAction) {
357 self.captureSessionConfiguration = CaptureSessionConfiguration(from: config)
362 private func fetchRemoteItems() {
363 let viewContext = PersistenceController.shared.container.viewContext
364 let fetchRequest = NSFetchRequest<CapturaRemoteFile>(entityName: "CapturaRemoteFile")
365 fetchRequest.fetchLimit = 5
366 fetchRequest.sortDescriptors = [NSSortDescriptor(key: "timestamp", ascending: false)]
368 let results = try? viewContext.fetch(fetchRequest)
369 remoteFiles = results ?? []
372 // MARK: - Presentation Helpers
375 private func requestPermissionToRecord() {
376 showPopoverWithMessage("Please grant Captura permission to record")
377 if let url = URL(string: "x-apple.systempreferences:com.apple.preference.security?Privacy_ScreenRecording") {
378 NSWorkspace.shared.open(url)
382 private func showPopoverWithMessage(_ message: String) {
383 if let button = statusItem.button {
384 (self.popover?.contentViewController as? HelpPopoverViewController)?.updateLabel(message)
385 self.popover?.show(relativeTo: button.bounds, of: button, preferredEdge: NSRectEdge.minY)
386 DispatchQueue.main.asyncAfter(deadline: .now() + 2.0) {
387 self.popover?.performClose(nil)
392 private func updateImage() {
393 if let button = statusItem.button {
394 let image: String = switch captureState {
396 "rectangle.dashed.badge.record"
398 "circle.rectangle.dashed"
400 "checkmark.rectangle"
402 "dock.arrow.up.rectangle"
404 "checkmark.rectangle.fill"
406 "xmark.rectangle.fill"
408 button.image = NSImage(systemSymbolName: image, accessibilityDescription: "Captura")
412 private func stop() {
414 captureSession?.stopRunning()
416 boxListener?.cancel()
417 recordingWindow?.close()
418 recordingWindow = nil
421 private func uploadOrCopy() async -> Bool {
422 if captureSessionConfiguration.shouldUseBackend {
423 let result = await uploadToBackend()
424 if result && !captureSessionConfiguration.shouldKeepLocalFiles {
429 copyLocalToClipboard()
434 private func copyLocalToClipboard() {
435 let fileType: NSPasteboard.PasteboardType = .init(rawValue: captureSessionConfiguration.shouldSaveGif ? "com.compuserve.gif" : "public.mpeg-4")
436 if let url = captureSessionConfiguration.shouldSaveGif ? outputFile?.gifURL : outputFile?.mp4URL {
437 if let data = try? Data(contentsOf: url) {
438 let pasteboard = NSPasteboard.general
439 pasteboard.declareTypes([fileType], owner: nil)
440 pasteboard.setData(data, forType: fileType)
445 private func uploadToBackend() async -> Bool {
446 let contentType = captureSessionConfiguration.shouldUploadGif ? "image/gif" : "video/mp4"
447 if let url = captureSessionConfiguration.shouldUploadGif ? outputFile?.gifURL : outputFile?.mp4URL {
448 if let data = try? Data(contentsOf: url) {
449 if let remoteUrl = captureSessionConfiguration.backend {
450 var request = URLRequest(url: remoteUrl)
451 request.httpMethod = "POST"
452 request.httpBody = data
453 request.setValue(contentType, forHTTPHeaderField: "Content-Type")
454 request.setValue("Captura/1.0", forHTTPHeaderField: "User-Agent")
457 let (data, response) = try await URLSession.shared.data(for: request)
459 if let httpResponse = response as? HTTPURLResponse {
460 if httpResponse.statusCode == 201 {
461 let answer = try JSONDecoder().decode(BackendResponse.self, from: data)
462 createRemoteFile(answer.url)
473 private func createRemoteFile(_ url: URL) {
474 let viewContext = PersistenceController.shared.container.viewContext
475 let remoteFile = CapturaRemoteFile(context: viewContext)
476 remoteFile.url = url.absoluteString
477 remoteFile.timestamp = Date()
478 try? viewContext.save()
479 let pasteboard = NSPasteboard.general
480 pasteboard.declareTypes([.URL], owner: nil)
481 pasteboard.setString(url.absoluteString, forType: .string)
484 private func deleteLocalFiles() {
485 if captureSessionConfiguration.shouldSaveGif {
486 if let url = outputFile?.gifURL {
487 try? FileManager.default.removeItem(at: url)
490 if captureSessionConfiguration.shouldSaveMp4 {
491 if let url = outputFile?.mp4URL {
492 try? FileManager.default.removeItem(at: url)