feat(capture): enhance capturing screen with options like superscale, codec selection and some other stuff

Author: jkuri

Reframed/Compositor/VideoCompositor.swift

@@ -128,8 +128,15 @@ enum VideoCompositor {
     let hasWebcam = result.webcamVideoURL != nil
     let hasCursor = cursorSnapshot != nil
     let hasZoom = zoomTimeline != nil
+    let sourceCodecMatchesExport: Bool = {
+      switch result.captureQuality {
+      case .veryHigh: return exportSettings.codec == .proRes4444
+      case .high: return exportSettings.codec == .proRes422
+      case .standard: return exportSettings.codec == .h264
+      }
+    }()
     let needsReencode =
-      exportSettings.codec != .h264 || exportSettings.resolution != .original
+      !sourceCodecMatchesExport || exportSettings.resolution != .original
       || exportSettings.fps != .original
     let needsCompositor =
       hasVisualEffects || hasWebcam || needsReencode || hasCursor || hasZoom

Reframed/Editor/EditorState.swift

@@ -785,7 +785,8 @@ final class EditorState {
         cursorMetadataURL: result.cursorMetadataURL,
         screenSize: result.screenSize,
         webcamSize: nil,
-        fps: result.fps
+        fps: result.fps,
+        captureQuality: result.captureQuality
       )
     }
 

Reframed/Editor/EditorTopBar.swift

@@ -65,7 +65,7 @@ struct EditorTopBar: View {
         }
         .buttonStyle(.plain)
         .disabled(editorState.isExporting)
-        .opacity(editorState.isExporting ? 0.4 : 1.0)
+        .opacity(editorState.isExporting ? 0.5 : 1.0)
       }
     }
     .padding(.leading, 16)

Reframed/Editor/EditorView+TransportBar.swift

@@ -18,7 +18,7 @@ extension EditorView {
 
       IconButton(
         systemName: "minus.magnifyingglass",
-        color: timelineZoom > 1.0 ? ReframedColors.primaryText : ReframedColors.tertiaryText
+        color: timelineZoom > 1.0 ? ReframedColors.primaryText : ReframedColors.disabledText
       ) {
         timelineZoom = max(1.0, timelineZoom / 1.5)
         baseZoom = timelineZoom
@@ -27,7 +27,7 @@ extension EditorView {
 
       IconButton(
         systemName: "plus.magnifyingglass",
-        color: timelineZoom < 30.0 ? ReframedColors.primaryText : ReframedColors.tertiaryText
+        color: timelineZoom < 30.0 ? ReframedColors.primaryText : ReframedColors.disabledText
       ) {
         timelineZoom = min(30.0, timelineZoom * 1.5)
         baseZoom = timelineZoom
@@ -36,7 +36,7 @@ extension EditorView {
 
       IconButton(
         systemName: "1.magnifyingglass",
-        color: timelineZoom > 1.0 ? ReframedColors.primaryText : ReframedColors.tertiaryText
+        color: timelineZoom > 1.0 ? ReframedColors.primaryText : ReframedColors.disabledText
       ) {
         timelineZoom = 1.0
         baseZoom = 1.0
@@ -53,14 +53,14 @@ extension EditorView {
 
       IconButton(
         systemName: "arrow.uturn.backward",
-        color: editorState.history.canUndo ? ReframedColors.primaryText : ReframedColors.tertiaryText,
+        color: editorState.history.canUndo ? ReframedColors.primaryText : ReframedColors.disabledText,
         action: { editorState.undo() }
       )
       .disabled(!editorState.history.canUndo)
 
       IconButton(
         systemName: "arrow.uturn.forward",
-        color: editorState.history.canRedo ? ReframedColors.primaryText : ReframedColors.tertiaryText,
+        color: editorState.history.canRedo ? ReframedColors.primaryText : ReframedColors.disabledText,
         action: { editorState.redo() }
       )
       .disabled(!editorState.history.canRedo)

Reframed/Editor/EditorView.swift

@@ -171,7 +171,7 @@ struct EditorView: View {
                 in: RoundedRectangle(cornerRadius: 8)
               )
               .contentShape(Rectangle())
-              .opacity(disabled ? 0.35 : 1)
+              .opacity(disabled ? 0.45 : 1)
             }
             .buttonStyle(.plain)
             .hoverEffect(id: "tab.\(tab.rawValue)")

Reframed/Editor/PropertiesPanel.swift

@@ -157,19 +157,64 @@ struct PropertiesPanel: View {
       VStack(spacing: Layout.compactSpacing) {
         infoRow("Resolution", value: "\(Int(editorState.result.screenSize.width))x\(Int(editorState.result.screenSize.height))")
         infoRow("FPS", value: "\(editorState.result.fps)")
+        infoRow("Codec", value: codecLabel(editorState.result.captureQuality))
         infoRow("Duration", value: formatDuration(editorState.duration))
 
+        if let mode = editorState.project?.metadata.captureMode, mode != .none {
+          infoRow("Capture Mode", value: captureModeLabel(mode))
+        }
+
+        infoRow("File Size", value: formattedFileSize(url: editorState.result.screenVideoURL))
+
         if let ws = editorState.result.webcamSize {
           infoRow("Webcam", value: "\(Int(ws.width))x\(Int(ws.height))")
         }
 
         infoRow("System Audio", value: editorState.result.systemAudioURL != nil ? "Yes" : "No")
         infoRow("Microphone", value: editorState.result.microphoneAudioURL != nil ? "Yes" : "No")
         infoRow("Cursor Data", value: editorState.cursorMetadataProvider != nil ? "Yes" : "No")
+
+        if let date = editorState.project?.metadata.createdAt {
+          infoRow("Recorded", value: formattedDate(date))
+        }
       }
     }
   }
 
+  private func codecLabel(_ quality: CaptureQuality) -> String {
+    switch quality {
+    case .standard: "H.264"
+    case .high: "ProRes 422"
+    case .veryHigh: "ProRes 4444"
+    }
+  }
+
+  private func captureModeLabel(_ mode: CaptureMode) -> String {
+    switch mode {
+    case .none: "None"
+    case .entireScreen: "Entire Screen"
+    case .selectedWindow: "Window"
+    case .selectedArea: "Area"
+    case .device: "iOS Device"
+    }
+  }
+
+  private func formattedFileSize(url: URL) -> String {
+    guard let attrs = try? FileManager.default.attributesOfItem(atPath: url.path),
+      let size = attrs[.size] as? Int64
+    else {
+      return "—"
+    }
+    return ByteCountFormatter.string(fromByteCount: size, countStyle: .file)
+  }
+
+  private func formattedDate(_ date: Date) -> String {
+    let formatter = DateFormatter()
+    formatter.dateStyle = .medium
+    formatter.timeStyle = .short
+    return formatter.string(from: date)
+  }
+
   private func infoRow(_ label: String, value: String) -> some View {
     HStack {
       Text(label)

Reframed/Project/ProjectMetadata.swift

@@ -13,6 +13,7 @@ struct ProjectMetadata: Codable, Sendable {
   var hasCursorMetadata: Bool = false
   var hasWebcam: Bool = false
   var captureMode: CaptureMode?
+  var captureQuality: String? = nil
   var editorState: EditorStateData?
 }
 

Reframed/Project/ReframedProject.swift

@@ -10,7 +10,11 @@ struct ReframedProject: Sendable {
   }
 
   var screenVideoURL: URL {
-    bundleURL.appendingPathComponent("screen.mp4")
+    let movURL = bundleURL.appendingPathComponent("screen.mov")
+    if FileManager.default.fileExists(atPath: movURL.path) {
+      return movURL
+    }
+    return bundleURL.appendingPathComponent("screen.mp4")
   }
 
   var webcamVideoURL: URL? {
@@ -51,7 +55,8 @@ struct ReframedProject: Sendable {
       cursorMetadataURL: cursorMetadataURL,
       screenSize: metadata.screenSize.cgSize,
       webcamSize: metadata.webcamSize?.cgSize,
-      fps: metadata.fps
+      fps: metadata.fps,
+      captureQuality: CaptureQuality(rawValue: metadata.captureQuality ?? "standard") ?? .standard
     )
   }
 
@@ -68,7 +73,8 @@ struct ReframedProject: Sendable {
     let bundleURL = directory.appendingPathComponent(bundleName)
     try fm.createDirectory(at: bundleURL, withIntermediateDirectories: true)
 
-    try fm.moveItem(at: result.screenVideoURL, to: bundleURL.appendingPathComponent("screen.mp4"))
+    let screenExt = result.screenVideoURL.pathExtension
+    try fm.moveItem(at: result.screenVideoURL, to: bundleURL.appendingPathComponent("screen.\(screenExt)"))
 
     if let webcamURL = result.webcamVideoURL {
       try fm.moveItem(at: webcamURL, to: bundleURL.appendingPathComponent("webcam.mp4"))
@@ -97,7 +103,8 @@ struct ReframedProject: Sendable {
       hasMicrophoneAudio: result.microphoneAudioURL != nil,
       hasCursorMetadata: result.cursorMetadataURL != nil,
       hasWebcam: result.webcamVideoURL != nil,
-      captureMode: captureMode
+      captureMode: captureMode,
+      captureQuality: result.captureQuality.rawValue
     )
 
     let encoder = JSONEncoder()

Reframed/Recording/FileManager+Reframed.swift

@@ -17,8 +17,9 @@ extension FileManager {
     reframedTempDir().appendingPathComponent("reframed-\(timestamp()).mp4")
   }
 
-  func tempVideoURL() -> URL {
-    reframedTempDir().appendingPathComponent("video-\(timestamp()).mp4")
+  func tempVideoURL(captureQuality: CaptureQuality = .standard) -> URL {
+    let ext = captureQuality.isProRes ? "mov" : "mp4"
+    return reframedTempDir().appendingPathComponent("video-\(timestamp()).\(ext)")
   }
 
   func tempWebcamURL() -> URL {

Reframed/Recording/RecordingCoordinator.swift

@@ -26,6 +26,7 @@ actor RecordingCoordinator {
   private var webcamPixelW: Int = 0
   private var webcamPixelH: Int = 0
   private var recordingFPS: Int = 60
+  private var captureQualityUsed: CaptureQuality = .standard
 
   func startRecording(
     target: CaptureTarget,
@@ -35,7 +36,9 @@ actor RecordingCoordinator {
     cameraDeviceId: String? = nil,
     cameraResolution: String = "1080p",
     existingWebcam: (WebcamCapture, VerifiedCamera)? = nil,
-    cursorMetadataRecorder: CursorMetadataRecorder? = nil
+    cursorMetadataRecorder: CursorMetadataRecorder? = nil,
+    captureQuality: CaptureQuality = .standard,
+    retinaCapture: Bool = false
   ) async throws -> Date {
     var verifiedCam: (capture: WebcamCapture, info: VerifiedCamera)?
     var verifiedMic: MicrophoneCapture?
@@ -97,7 +100,12 @@ actor RecordingCoordinator {
 
     pixelW = Int(round(sourceRect.width * displayScale)) & ~1
     pixelH = Int(round(sourceRect.height * displayScale)) & ~1
+    if retinaCapture {
+      pixelW = (pixelW * 2) & ~1
+      pixelH = (pixelH * 2) & ~1
+    }
     recordingFPS = fps
+    captureQualityUsed = captureQuality
 
     var streamCount = 1
     if verifiedMic != nil { streamCount += 1 }
@@ -108,11 +116,12 @@ actor RecordingCoordinator {
     self.recordingClock = clock
 
     let vidWriter = try VideoTrackWriter(
-      outputURL: FileManager.default.tempVideoURL(),
+      outputURL: FileManager.default.tempVideoURL(captureQuality: captureQuality),
       width: pixelW,
       height: pixelH,
       fps: fps,
-      clock: clock
+      clock: clock,
+      captureQuality: captureQuality
     )
     self.videoWriter = vidWriter
 
@@ -136,14 +145,15 @@ actor RecordingCoordinator {
       self.cursorMetadataRecorder = cursorMetadataRecorder
     }
 
-    let session = ScreenCaptureSession(videoWriter: vidWriter)
+    let session = ScreenCaptureSession(videoWriter: vidWriter, captureQuality: captureQuality)
     do {
       try await session.start(
         target: target,
         display: display,
         displayScale: displayScale,
         fps: fps,
-        hideCursor: cursorMetadataRecorder != nil
+        hideCursor: cursorMetadataRecorder != nil,
+        retinaCapture: retinaCapture
       )
     } catch {
       verifiedCam?.capture.stop()
@@ -217,7 +227,9 @@ actor RecordingCoordinator {
     microphoneDeviceId: String? = nil,
     cameraDeviceId: String? = nil,
     cameraResolution: String = "1080p",
-    existingWebcam: (WebcamCapture, VerifiedCamera)? = nil
+    existingWebcam: (WebcamCapture, VerifiedCamera)? = nil,
+    captureQuality: CaptureQuality = .standard,
+    retinaCapture: Bool = false
   ) async throws -> Date {
     var verifiedCam: (capture: WebcamCapture, info: VerifiedCamera)?
     var verifiedMic: MicrophoneCapture?
@@ -271,10 +283,15 @@ actor RecordingCoordinator {
       pW = 1920
       pH = 1080
     }
+    if retinaCapture {
+      pW = (pW * 2) & ~1
+      pH = (pH * 2) & ~1
+    }
 
     pixelW = pW
     pixelH = pH
     recordingFPS = fps
+    captureQualityUsed = captureQuality
 
     var streamCount = 1
     if verifiedMic != nil { streamCount += 1 }
@@ -286,11 +303,12 @@ actor RecordingCoordinator {
     self.recordingClock = clock
 
     let vidWriter = try VideoTrackWriter(
-      outputURL: FileManager.default.tempVideoURL(),
+      outputURL: FileManager.default.tempVideoURL(captureQuality: captureQuality),
       width: pW,
       height: pH,
       fps: fps,
-      clock: clock
+      clock: clock,
+      captureQuality: captureQuality
     )
     self.videoWriter = vidWriter
     deviceCapture.attachVideoWriter(vidWriter)
@@ -473,7 +491,8 @@ actor RecordingCoordinator {
       cursorMetadataURL: cursorMetadataURL,
       screenSize: CGSize(width: screenW, height: screenH),
       webcamSize: webcamURL != nil ? CGSize(width: camW, height: camH) : nil,
-      fps: fps
+      fps: fps,
+      captureQuality: captureQualityUsed
     )
   }