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.cancelTrackingWithoutAnimation()
136 if captureState == .selectingArea {
137 NotificationCenter.default.post(name: .startRecording, object: nil, userInfo: nil)
140 if captureState == .recording {
141 NotificationCenter.default.post(name: .stopRecording, object: nil, userInfo: nil)
147 @objc private func onClickStartRecording() {
148 NotificationCenter.default.post(name: .startAreaSelection, object: nil, userInfo: nil)
151 @objc private func onOpenPreferences() {
152 NSApp.activate(ignoringOtherApps: true)
153 if preferencesWindow == nil {
154 preferencesWindow = PreferencesWindow()
156 preferencesWindow?.makeKeyAndOrderFront(nil)
157 preferencesWindow?.orderFrontRegardless()
161 @objc private func onOpenFolder() {
162 if let directory = FileManager.default.urls(for: .picturesDirectory, in: .userDomainMask).first?.appendingPathComponent("captura") {
163 NSWorkspace.shared.open(directory)
167 @objc private func onClickRemoteFile(_ sender: NSMenuItem) {
168 if let remoteFile = sender.representedObject as? CapturaRemoteFile {
169 if let urlString = remoteFile.url {
170 if let url = URL(string: urlString) {
171 NSWorkspace.shared.open(url)
177 @objc private func onQuit() {
178 NSApplication.shared.terminate(self)
181 // MARK: - App State Event Listeners
183 @objc func didReceiveNotification(_ notification: Notification) {
184 switch(notification.name) {
185 case .startAreaSelection:
187 case .startRecording:
191 case .finalizeRecording:
192 DispatchQueue.main.async {
193 self.finalizeRecording()
198 DispatchQueue.main.async {
201 case .failedtoUpload:
202 DispatchQueue.main.async {
206 if let frame = notification.userInfo?["frame"] {
207 receivedFrame(frame as! CVImageBuffer)
209 case .setConfiguration:
210 DispatchQueue.main.async {
211 if let userInfo = notification.userInfo {
212 if let config = userInfo["config"] as? ConfigureAction {
213 self.setConfiguration(config)
217 case .reloadConfiguration:
218 reloadConfiguration()
219 case .setCaptureSessionConfiguration:
220 if let userInfo = notification.userInfo {
221 if let config = userInfo["config"] as? RecordAction {
222 setCaptureSessionConfiguration(config)
225 case .NSManagedObjectContextObjectsDidChange:
226 DispatchQueue.main.async {
227 self.fetchRemoteItems()
236 func startAreaSelection() {
238 if captureState != .selectingArea {
239 captureState = .selectingArea
240 if let button = statusItem.button {
241 let rectInWindow = button.convert(button.bounds, to: nil)
242 let rectInScreen = button.window?.convertToScreen(rectInWindow)
243 NSApp.activate(ignoringOtherApps: true)
244 recordingWindow = RecordingWindow(captureSessionConfiguration, rectInScreen)
245 recordingWindow?.makeKeyAndOrderFront(nil)
246 recordingWindow?.orderFrontRegardless()
247 boxListener = recordingWindow?.recordingContentView.$box
248 .debounce(for: .seconds(0.3), scheduler: RunLoop.main)
253 self.helpShown = true
254 self.showPopoverWithMessage("Click here when you're ready to record.")
262 func startRecording() {
263 captureState = .recording
267 pixelDensity = recordingWindow?.pixelDensity ?? 1.0
268 recordingWindow?.recordingContentView.startRecording()
269 if let box = recordingWindow?.recordingContentView.box {
270 if let screen = recordingWindow?.screen {
271 captureSession = CapturaCaptureSession(screen, box: box)
273 if let captureSession {
275 stopTimer = DispatchWorkItem {
278 DispatchQueue.main.asyncAfter(deadline: .now() + Double(captureSessionConfiguration.maxLength), execute: stopTimer!)
280 outputFile = CapturaFile()
281 if captureSessionConfiguration.shouldSaveMp4 {
282 captureSession.startRecording(to: outputFile!.mp4URL)
284 captureSession.startRunning()
290 NotificationCenter.default.post(name: .failedToStart, object: nil, userInfo: nil)
293 func stopRecording() {
294 captureState = .uploading
299 if self.captureSessionConfiguration.shouldSaveGif {
300 if let outputFile = self.outputFile {
301 await GifRenderer.render(self.images, at: self.captureSessionConfiguration.frameRate, to: outputFile.gifURL)
304 let wasSuccessful = await self.uploadOrCopy()
306 NotificationCenter.default.post(name: .finalizeRecording, object: nil, userInfo: nil)
308 NotificationCenter.default.post(name: .failedtoUpload, object: nil, userInfo: nil)
313 func finalizeRecording() {
314 captureState = .uploaded
316 DispatchQueue.main.asyncAfter(deadline: .now() + 2.0) {
317 NotificationCenter.default.post(name: .reset, object: nil, userInfo: nil)
324 captureSessionConfiguration = CaptureSessionConfiguration()
328 func receivedFrame(_ frame: CVImageBuffer) {
329 let now = ContinuousClock.now
331 if now - gifCallbackTimer > .nanoseconds(1_000_000_000 / UInt64(captureSessionConfiguration.frameRate)) {
332 gifCallbackTimer = now
333 DispatchQueue.main.async {
334 if var cgImage = frame.cgImage {
335 if self.pixelDensity > 1 {
336 cgImage = cgImage.resize(by: self.pixelDensity) ?? cgImage
338 self.images.append(cgImage)
344 func failed(_ requestPermission: Bool = false) {
345 captureState = .error
347 if requestPermission {
348 requestPermissionToRecord()
351 DispatchQueue.main.asyncAfter(deadline: .now() + 2.0) {
352 NotificationCenter.default.post(name: .reset, object: nil, userInfo: nil)
356 func setConfiguration(_ config: ConfigureAction) {
357 CapturaSettings.apply(config)
360 func reloadConfiguration() {
361 self.captureSessionConfiguration = CaptureSessionConfiguration()
364 func setCaptureSessionConfiguration(_ config: RecordAction) {
365 self.captureSessionConfiguration = CaptureSessionConfiguration(from: config)
370 private func fetchRemoteItems() {
371 let viewContext = PersistenceController.shared.container.viewContext
372 let fetchRequest = NSFetchRequest<CapturaRemoteFile>(entityName: "CapturaRemoteFile")
373 fetchRequest.fetchLimit = 5
374 fetchRequest.sortDescriptors = [NSSortDescriptor(key: "timestamp", ascending: false)]
376 let results = try? viewContext.fetch(fetchRequest)
377 remoteFiles = results ?? []
380 // MARK: - Presentation Helpers
383 private func requestPermissionToRecord() {
384 showPopoverWithMessage("Please grant Captura permission to record")
385 if let url = URL(string: "x-apple.systempreferences:com.apple.preference.security?Privacy_ScreenRecording") {
386 NSWorkspace.shared.open(url)
390 private func showPopoverWithMessage(_ message: String) {
391 if let button = statusItem.button {
392 (self.popover?.contentViewController as? HelpPopoverViewController)?.updateLabel(message)
393 self.popover?.show(relativeTo: button.bounds, of: button, preferredEdge: NSRectEdge.minY)
394 DispatchQueue.main.asyncAfter(deadline: .now() + 2.0) {
395 self.popover?.performClose(nil)
400 private func updateImage() {
401 if let button = statusItem.button {
402 let image: String = switch captureState {
404 "rectangle.dashed.badge.record"
406 "circle.rectangle.dashed"
408 "checkmark.rectangle"
410 "dock.arrow.up.rectangle"
412 "checkmark.rectangle.fill"
414 "xmark.rectangle.fill"
416 button.image = NSImage(systemSymbolName: image, accessibilityDescription: "Captura")
420 private func stop() {
422 captureSession?.stopRunning()
424 boxListener?.cancel()
425 recordingWindow?.close()
426 recordingWindow = nil
429 private func uploadOrCopy() async -> Bool {
430 if captureSessionConfiguration.shouldUseBackend {
431 let result = await uploadToBackend()
432 if result && !captureSessionConfiguration.shouldKeepLocalFiles {
437 copyLocalToClipboard()
442 private func copyLocalToClipboard() {
443 let fileType: NSPasteboard.PasteboardType = .init(rawValue: captureSessionConfiguration.shouldSaveGif ? "com.compuserve.gif" : "public.mpeg-4")
444 if let url = captureSessionConfiguration.shouldSaveGif ? outputFile?.gifURL : outputFile?.mp4URL {
445 if let data = try? Data(contentsOf: url) {
446 let pasteboard = NSPasteboard.general
447 pasteboard.declareTypes([fileType], owner: nil)
448 pasteboard.setData(data, forType: fileType)
453 private func uploadToBackend() async -> Bool {
454 let contentType = captureSessionConfiguration.shouldUploadGif ? "image/gif" : "video/mp4"
455 if let url = captureSessionConfiguration.shouldUploadGif ? outputFile?.gifURL : outputFile?.mp4URL {
456 if let data = try? Data(contentsOf: url) {
457 if let remoteUrl = captureSessionConfiguration.backend {
458 var request = URLRequest(url: remoteUrl)
459 request.httpMethod = "POST"
460 request.httpBody = data
461 request.setValue(contentType, forHTTPHeaderField: "Content-Type")
462 request.setValue("Captura/1.0", forHTTPHeaderField: "User-Agent")
465 let (data, response) = try await URLSession.shared.data(for: request)
467 if let httpResponse = response as? HTTPURLResponse {
468 if httpResponse.statusCode == 201 {
469 let answer = try JSONDecoder().decode(BackendResponse.self, from: data)
470 createRemoteFile(answer.url)
481 private func createRemoteFile(_ url: URL) {
482 let viewContext = PersistenceController.shared.container.viewContext
483 let remoteFile = CapturaRemoteFile(context: viewContext)
484 remoteFile.url = url.absoluteString
485 remoteFile.timestamp = Date()
486 try? viewContext.save()
487 let pasteboard = NSPasteboard.general
488 pasteboard.declareTypes([.URL], owner: nil)
489 pasteboard.setString(url.absoluteString, forType: .string)
492 private func deleteLocalFiles() {
493 if captureSessionConfiguration.shouldSaveGif {
494 if let url = outputFile?.gifURL {
495 try? FileManager.default.removeItem(at: url)
498 if captureSessionConfiguration.shouldSaveMp4 {
499 if let url = outputFile?.mp4URL {
500 try? FileManager.default.removeItem(at: url)