feat(export): add GIF export for short recordings

.mise.toml

@@ -21,7 +21,7 @@ run = "swiftformat ."
 
 [tasks.build]
 description = "Build the app"
-run = "xcodebuild -scheme CaptureThis -configuration Debug -derivedDataPath .build -destination 'platform=macOS' build"
+run = ["mise run generate", "xcodebuild -scheme CaptureThis -configuration Debug -derivedDataPath .build -destination 'platform=macOS' build"]
 
 [tasks.test]
 description = "Run unit tests"

Sources/App/AppState+GIFExport.swift

@@ -0,0 +1,43 @@
+import AppKit
+import CaptureThisCore
+import Foundation
+
+extension AppState {
+  func exportGIF(for recording: Recording) {
+    Task { @MainActor in
+      await exportGIF(recording)
+    }
+  }
+
+  func exportGIFFromNotification(fileURL: URL) {
+    let recording = recentRecordings.first { $0.url == fileURL } ?? Recording(
+      id: UUID(),
+      url: fileURL,
+      createdAt: Date(),
+      duration: nil,
+      captureType: .display
+    )
+
+    Task { @MainActor in
+      await exportGIF(recording)
+    }
+  }
+
+  private func exportGIF(_ recording: Recording) async {
+    gifExportState = .exporting(recording.id)
+    errorMessage = nil
+
+    do {
+      let outputURL = try await withRecordingsDirectoryAccess {
+        let gifExportService = GIFExportService(policy: GIFExportPolicy(quality: settings.gifExportQuality))
+        return try await gifExportService.export(recording: recording)
+      }
+      gifExportState = .idle
+      notificationService.sendGIFExportCompleteNotification(url: outputURL)
+      revealRecordingURL(outputURL)
+    } catch {
+      gifExportState = .idle
+      errorMessage = error.localizedDescription
+    }
+  }
+}

Sources/App/AppState.swift

@@ -24,6 +24,7 @@ final class AppState: ObservableObject {
   @Published var presenterOverlayEnabled = false
   @Published var recordingStartDate: Date?
   @Published var permissionSetupState = PermissionSetupState()
+  @Published var gifExportState: GIFExportState = .idle
 
   let engine: RecordingEngine
   let cameraService = CameraService()
@@ -143,4 +144,24 @@ final class AppState: ObservableObject {
       }
     }
   }
+
+  func withRecordingsDirectoryAccess<T>(_ operation: () async throws -> T) async throws -> T {
+    _ = try await fileAccessService.ensureRecordingsDirectoryAccess()
+    defer {
+      fileAccessService.stopAccessingIfNeeded()
+    }
+    return try await operation()
+  }
+}
+
+enum GIFExportState: Equatable {
+  case idle
+  case exporting(UUID)
+
+  func isExporting(_ recording: Recording) -> Bool {
+    if case let .exporting(id) = self {
+      return id == recording.id
+    }
+    return false
+  }
 }

Sources/Core/Extensions/RecordingSettings+Updating.swift

@@ -8,6 +8,7 @@ public extension RecordingSettings {
     systemAudioEnabled: Bool? = nil,
     outputFormat: RecordingFileFormat? = nil,
     recordingQuality: RecordingQuality? = nil,
+    gifExportQuality: GIFExportQuality? = nil,
     debugModeEnabled: Bool? = nil
   ) -> RecordingSettings {
     var copy = self
@@ -29,6 +30,9 @@ public extension RecordingSettings {
     if let recordingQuality {
       copy.recordingQuality = recordingQuality
     }
+    if let gifExportQuality {
+      copy.gifExportQuality = gifExportQuality
+    }
     if let debugModeEnabled {
       copy.isDebugModeEnabled = debugModeEnabled
     }

Sources/Core/Models/RecordingSettings.swift

@@ -36,13 +36,51 @@ public enum RecordingQuality: String, Codable, CaseIterable, Identifiable, Senda
   }
 }
 
+public enum GIFExportQuality: String, Codable, CaseIterable, Identifiable, Sendable {
+  case compact
+  case balanced
+  case high
+
+  public var id: String {
+    rawValue
+  }
+
+  public var displayName: String {
+    switch self {
+    case .compact:
+      String(localized: "Compact", bundle: .captureThisCore)
+    case .balanced:
+      String(localized: "Balanced", bundle: .captureThisCore)
+    case .high:
+      String(localized: "High", bundle: .captureThisCore)
+    }
+  }
+
+  public var targetWidth: Double {
+    switch self {
+    case .compact: 1080
+    case .balanced: 1440
+    case .high: 2160
+    }
+  }
+
+  public var framesPerSecond: Double {
+    switch self {
+    case .compact: 15
+    case .balanced: 24
+    case .high: 24
+    }
+  }
+}
+
 public struct RecordingSettings: Codable, Sendable {
   public var countdownSeconds: Int
   public var isCameraEnabled: Bool
   public var isMicrophoneEnabled: Bool
   public var isSystemAudioEnabled: Bool
   public var outputFormat: RecordingFileFormat
   public var recordingQuality: RecordingQuality
+  public var gifExportQuality: GIFExportQuality
   public var isDebugModeEnabled: Bool
 
   public init(
@@ -52,6 +90,7 @@ public struct RecordingSettings: Codable, Sendable {
     isSystemAudioEnabled: Bool = false,
     outputFormat: RecordingFileFormat = .mp4,
     recordingQuality: RecordingQuality = .standard,
+    gifExportQuality: GIFExportQuality = .balanced,
     isDebugModeEnabled: Bool = false
   ) {
     self.countdownSeconds = countdownSeconds
@@ -60,6 +99,7 @@ public struct RecordingSettings: Codable, Sendable {
     self.isSystemAudioEnabled = isSystemAudioEnabled
     self.outputFormat = outputFormat
     self.recordingQuality = recordingQuality
+    self.gifExportQuality = gifExportQuality
     self.isDebugModeEnabled = isDebugModeEnabled
   }
 
@@ -76,6 +116,7 @@ public struct RecordingSettings: Codable, Sendable {
     isSystemAudioEnabled = try value(.isSystemAudioEnabled, defaults.isSystemAudioEnabled)
     outputFormat = try value(.outputFormat, defaults.outputFormat)
     recordingQuality = try value(.recordingQuality, defaults.recordingQuality)
+    gifExportQuality = try value(.gifExportQuality, defaults.gifExportQuality)
     isDebugModeEnabled = try value(.isDebugModeEnabled, defaults.isDebugModeEnabled)
   }
 }

Sources/Core/Models/RecordingState.swift

@@ -9,7 +9,9 @@ public enum RecordingState: Equatable, Sendable {
   case error(String)
 
   public var isRecording: Bool {
-    if case .recording = self { return true }
+    if case .recording = self {
+      return true
+    }
     return false
   }
 

Sources/Core/RecordingEngine+Flow.swift

@@ -84,12 +84,16 @@ extension RecordingEngine {
 
   func runCountdown(total: Int, filter: SCContentFilter) async {
     for remaining in stride(from: total, through: 1, by: -1) {
-      if Task.isCancelled { return }
+      if Task.isCancelled {
+        return
+      }
       setState(.countdown(remaining))
       try? await Task.sleep(nanoseconds: 1_000_000_000)
     }
 
-    if Task.isCancelled { return }
+    if Task.isCancelled {
+      return
+    }
     await beginRecording(with: filter)
   }
 
@@ -207,12 +211,16 @@ extension RecordingEngine {
 
     if settings.isCameraEnabled {
       let granted = await permissionService.requestCameraAccess()
-      if !granted { throw AppError.permissionDenied }
+      if !granted {
+        throw AppError.permissionDenied
+      }
     }
 
     if settings.isMicrophoneEnabled {
       let granted = await permissionService.requestMicrophoneAccess()
-      if !granted { throw AppError.permissionDenied }
+      if !granted {
+        throw AppError.permissionDenied
+      }
     }
   }