👁️ PeekOCR v1.8.1 - Light Mode Permission Polish

💡 Light Mode Permission Polish · 🛡️ Guided Setup Refinement

This patch release polishes the permission guidance introduced in v1.8.0 so every onboarding surface stays readable and calm in both Light Mode and Dark Mode.

💡 Light/Dark permission guidance

• Permission guidance surfaces now render cleanly in Light Mode and Dark Mode.
• The floating System Settings assistant now uses adaptive AppKit colors instead of dark-only material assumptions.
• The draggable PeekOCR app card resolves dynamic system colors against the active macOS appearance.
• The missing-permissions requirements window, menu bar reminder, and Settings permission rows now use contrast-aware fills and borders.
• The requirements window activation button has improved contrast across permission accent colors.

🛠️ Technical Highlights

• Added shared PermissionAppearance helpers for AppKit permission overlays.
• Kept the permission UI docs and project guide aligned with the adaptive appearance behavior.
• Version bumped to 1.8.1 with build 5.

📦 Installation

1. Download PeekOCR-v1.8.1.dmg
2. Open the DMG
3. Drag PeekOCR to Applications
4. First launch: right-click Open (not double-click) to bypass Gatekeeper, then confirm
5. If needed, use the in-app permission flow to enable Screen Recording and Accessibility

💻 Requirements

• macOS 13.0 (Ventura) or later
• Apple Silicon or Intel Mac

---

Full changelog: v1.8.0...v1.8.1

👁️ PeekOCR v1.8.0 - Guided Permission Onboarding

🛡️ Guided Permission Onboarding · ✅ Live Status Feedback

This release makes PeekOCR feel much more polished the first time you install it: permissions are now explained through explicit in-app UI, guided System Settings navigation, and live visual feedback instead of launch-time interruptions.

🛡️ Guided permission onboarding

• PeekOCR no longer interrupts users with permission prompts on launch.
• Missing permissions now surface through explicit UI: the menu bar reminder banner, Settings activation rows, or the dedicated Missing Permissions window when capture is blocked.
• Activating a permission opens the correct System Settings pane and shows a floating helper aligned with the settings window.
• Capture attempts that need Screen Recording now stop cleanly and route through onboarding instead of failing silently.

✅ Live permission status

• The Missing Permissions window now keeps a fixed size and always shows both required permissions: Screen Recording and Accessibility.
• Mixed states are now clear: if one permission is already active, it stays visible with a green success state instead of disappearing and shifting the layout.
• The requirements window stays open while setup continues, so users can return from System Settings and immediately see updated status.
• Accessibility-backed hotkeys refresh when the app becomes active again after the permission is enabled.

✨ UX polish

• Refined the missing-permissions preview/runtime layout so the window matches the shipped build more closely.
• Cleaned up extra window chrome and border artifacts in the onboarding preview path.
• Updated onboarding copy and docs to match the final user-facing behavior.

📦 Installation

1. Download PeekOCR-v1.8.0.dmg
2. Open the DMG
3. Drag PeekOCR to Applications
4. First launch: right-click Open (not double-click) to bypass Gatekeeper, then confirm
5. If needed, use the in-app permission flow to enable Screen Recording and Accessibility

💻 Requirements

• macOS 13.0 (Ventura) or later
• Apple Silicon or Intel Mac

---

Full changelog: v1.7.0...v1.8.0

👁️ PeekOCR v1.7.0 - Multi-Display, Capture Sound & Clip Editor Refresh

🖥️ Multi-Display · 🔊 Capture Sound · ✨ Clip Editor Refresh

This release brings overlays to every connected display, adds an optional shutter sound for captures, and redesigns the GIF/Video clip editor for a cleaner, more focused workflow.

🖥️ Multi-display overlays

• ⌘⇧5 (annotated screenshot) and ⌘⇧6 (GIF recording) overlays now span every connected display — start a selection from any monitor, not just the main one.
• The first mousedown claims the session and dismisses sibling overlays on other displays.
• Fixed overlays landing off-screen on secondary displays when macOS has "Displays have separate Spaces" enabled.

🔊 Capture sound

• Optional shutter sound after successful screenshots, plus the clip editor's frame-capture button.
• Toggle and volume slider under Settings → General → Sonido, with a test button.
• Clip exports (GIF/MP4) stay silent by design — the editor workflow is quiet on completion.
• OCR captures do not fire the sound.

✨ Clip editor redesign (⌘⇧6)

• The GIF ↔ Video picker now lives inline next to the "Exportación" title — one less section in the sidebar.
• Settings grouped into three homogeneous cards: Calidad, Salida, Estimación.
• FPS for video exports is now an informative row inside the Calidad card (it's not user-editable for video), so the real decisions — Resolución and Codec — read first.
• Timeline trim uses the system accent color with tick marks and a visible playhead dot — no more dominant yellow bar.
• Preview canvas is a solid black with a subtle vignette instead of the old hardcoded gradient, so the trimmer never competes with the real video.
• Playback controls use frame-step SF Symbols (backward.frame.fill / forward.frame.fill) with shortcut hints, and the export button is promoted to the large control size with Enter as default action.
• The "Frame guardado" toast is now a compact chip matching the timeline chip style; slides in from the bottom edge.

🛠️ Technical Highlights

• New DisplayEnumerator utility wrapping CGGetActiveDisplayList with mirror-set filtering.
• New CaptureSoundService singleton (lazy AVAudioPlayer, fire-and-forget playback) and SoundSettings ObservableObject backed by UserDefaults.
• GifClipSidebarView consolidates its card styling through a reusable cardSection(title:content:) helper.
• Fixed NSWindow(contentRect:...:screen:) doubling the content origin on non-primary displays by switching to the 4-parameter init + explicit setFrame(screen.frame, display: false).
• Removed a hard-coded local path from a SwiftUI #Preview scaffold.

📦 Installation

1. Download PeekOCR-v1.7.0.dmg
2. Open the DMG
3. Drag PeekOCR to Applications
4. First launch: right-click Open (not double-click) to bypass Gatekeeper, then confirm
5. Grant Accessibility and Screen Recording permissions if prompted

💻 Requirements

• macOS 13.0 (Ventura) or later
• Apple Silicon or Intel Mac

---

Full changelog: v1.6.0...v1.7.0

👁️ PeekOCR v1.6.0 - Live Annotation Overlay

✍️ Live Annotation Overlay

This release replaces the old ⌘⇧5 post-capture annotation editor with a much faster live overlay workflow.

✨ What's New

• Live pre-capture annotations for ⌘⇧5

  • Drag to select the capture region
  • Move or resize the selection before exporting
  • Add arrows, text, and highlight boxes directly on the live screen overlay
  • Press Enter to export the final annotated screenshot

• Inline editing and manipulation

  • Move existing arrows, text, and highlights without leaving the overlay
  • Resize highlight boxes individually
  • Double-click text to edit it
  • Contextual cursor behavior for drawing, moving, resizing, and editing

• Safer, smoother annotation UX

  • Outside clicks no longer accidentally create extra text or arrows
  • Changing tools clears stale selection state correctly
  • ⌘Z undoes the last live overlay annotation change

🔧 Settings Integration

• Live overlay arrows and highlights now respect the configured default stroke width from Settings
• Live text uses the configured default font size
• Preview and exported output now stay visually aligned with the annotation defaults

🛠️ Technical Highlights

• New LiveAnnotationOverlayWindowController for the full-screen pre-capture session
• New LiveAnnotationRenderer shared by the overlay preview and final exported image
• New lightweight LiveAnnotation model for live overlay interactions
• Direct rect capture finalization in NativeScreenCaptureService
• Legacy post-capture editor path kept only for compatibility/testing

📦 Installation

1. Download PeekOCR-v1.6.0.dmg
2. Open the DMG
3. Drag PeekOCR to Applications
4. Run PeekOCR from Applications
5. Grant Accessibility and Screen Recording permissions if prompted

💻 Requirements

• macOS 13.0 (Ventura) or later
• Apple Silicon or Intel Mac

⌨️ Default Keyboard Shortcuts

Shortcut	Action
⇧ Space	Capture text (OCR)
⌘⇧4	Capture screenshot
⌘⇧5	Live annotated screenshot
⌘⇧6	Capture GIF clip

🔐 DMG SHA-256

27dc37b14085e96a36d02eedfbbc67ea42a44b8723453f62a362bc437a01b030

v1.5.1 - Permission Persistence Fix

What's New

Permission Persistence Fix

• Root cause: PeekOCR was using ad-hoc code signing, causing macOS TCC to lose track of granted permissions after every reboot
• Fix: App is now signed with Apple Development certificate (Team ID: NXT93S55FY), so Screen Recording and Accessibility permissions persist across reboots
• Added PeekOCR.entitlements for proper entitlements declaration

Improved Permission Handling

• Use modern CGPreflightScreenCaptureAccess() API for reliable screen capture permission checks (replaces unreliable CGWindowListCopyWindowInfo)
• Request Screen Capture permission proactively at app launch
• Permission status in Settings now auto-refreshes every 2 seconds

Post-Update Note

After installing this version, you may need to re-grant permissions once:

1. Go to System Settings > Privacy & Security > Screen Recording
2. Remove PeekOCR from the list if present
3. Relaunch PeekOCR — it will prompt for permissions
4. Grant permissions — they will now persist across reboots

Installation

1. Download PeekOCR-v1.5.1.dmg
2. Open the DMG file
3. Drag PeekOCR to your Applications folder
4. Open PeekOCR from Applications
5. Grant necessary permissions (Accessibility & Screen Recording)

System Requirements

• macOS 13.0 (Ventura) or later
• Apple Silicon or Intel Mac

Default Keyboard Shortcuts

Shortcut	Action
⇧ Space	Capture text (OCR)
⌘⇧4	Capture screenshot
⌘⇧5	Capture with annotations
⌘⇧6	Capture GIF clip

v1.5.0 - Frame Capture + UX Polish

What's New

Frame Capture in Clip Editor

• Added a Capture Frame button in the GIF/Video clip editor playback controls
• Save the current frame as an image using your configured screenshot format (PNG/JPG/TIFF/HEIC) and quality
• Frame captures are saved in the same output directory configured in Settings

Export + Build Stability

• Updated video export internals to modern async AVFoundation loading where applicable
• Fixed sendable/deprecation warning paths in clip video export flow
• Stabilized release build pipeline for packaging/distribution

Settings UX Polish

• Fixed slider layout in Capturas and Clips tabs so controls use full row width consistently
• Improved visual alignment for min/max slider indicators

Installation

1. Download PeekOCR-v1.5.0.dmg
2. Open the DMG file
3. Drag PeekOCR to your Applications folder
4. Open PeekOCR from Applications
5. Grant necessary permissions (Accessibility & Screen Recording)

System Requirements

• macOS 13.0 (Ventura) or later
• Apple Silicon or Intel Mac

Default Keyboard Shortcuts

Shortcut	Action
⇧ Space	Capture text (OCR)
⌘⇧4	Capture screenshot
⌘⇧5	Capture with annotations
⌘⇧6	Capture GIF clip

v1.4.0 - Clip Export GIF/Video

What's New

Clip Export (GIF + Video)

• Export recorded clips as GIF (Baja / AI Debug / Alta) or MP4 Video (H.264 or HEVC, 720p–4K, no audio)
• AI Debug profile uses 1 FPS for easier frame-by-frame debugging
• Export overlay now shows loading + success confirmation

Recording UX

• Recording HUD is shown outside the captured region (won’t appear in the output)
• Clear blue border highlight during recording

Settings

• New Clip settings tab for max recording duration (3–60s) and default export preferences

Installation

1. Download PeekOCR-v1.4.0.dmg
2. Open the DMG file
3. Drag PeekOCR to your Applications folder
4. Open PeekOCR from Applications
5. Grant necessary permissions (Accessibility & Screen Recording)

System Requirements

• macOS 13.0 (Ventura) or later
• Apple Silicon or Intel Mac

Default Keyboard Shortcuts

Shortcut	Action
⇧ Space	Capture text (OCR)
⌘⇧4	Capture screenshot
⌘⇧5	Capture with annotations
⌘⇧6	Capture GIF clip

v1.3.0 - GIF Clip Capture

What's New

GIF Clip Capture

• New GIF Clip capture mode (record up to 10s) with an interactive region selector
• Post-recording editor with timeline trimming, preview playback, and frame-by-frame stepping
• Export to an optimized GIF with configurable quality, FPS, and max size

Installation

1. Download PeekOCR-v1.3.0.dmg
2. Open the DMG file
3. Drag PeekOCR to your Applications folder
4. Open PeekOCR from Applications
5. Grant necessary permissions (Accessibility & Screen Recording)

System Requirements

• macOS 13.0 (Ventura) or later
• Apple Silicon or Intel Mac

Default Keyboard Shortcuts

Shortcut	Action
⇧ Space	Capture text (OCR)
⌘⇧4	Capture screenshot
⌘⇧5	Capture with annotations
⌘⇧6	Capture GIF clip

v1.2.0 - Annotation Editor Improvements

What's New

Annotation Editor Enhancements

• Text Resizing: You can now resize text annotations by dragging the selection handles (font size range: 8-72pt)
• Wider Toolbar: Increased toolbar width to prevent text wrapping in Spanish UI
• Auto-save Text: Text annotations are now automatically saved when clicking outside or switching tools
• Settings Integration: Stroke width and font size from Settings are now properly applied when opening the editor

Settings Improvements

• Removed misleading "50%" label from the image scale slider for clearer visual feedback

Installation

1. Download PeekOCR-v1.2.0.dmg
2. Open the DMG file
3. Drag PeekOCR to your Applications folder
4. Open PeekOCR from Applications
5. Grant necessary permissions (Accessibility & Screen Recording)

System Requirements

• macOS 14.0 (Sonoma) or later
• Apple Silicon or Intel Mac

Keyboard Shortcuts

Shortcut	Action
⌘⇧1	Capture text (OCR)
⌘⇧2	Capture screenshot
⌘⇧5	Capture with annotations

PeekOCR v1.1.0 - Modular Architecture Refactor

What's New in v1.1.0

This release focuses on code quality and maintainability through a major architectural refactor. The codebase has been reorganized into a modular, component-based architecture following Single Responsibility Principle.

🏗️ Architecture Improvements

• 52% reduction in code complexity across major files
• 35+ new modular components for better code organization
• Comprehensive documentation added in docs/ folder

📁 New Project Structure

Models/
├── Annotations/     → Data types (Annotation, AnnotationTool, ResizeHandle)
├── State/           → State managers (UndoRedoManager, SelectionManager)

Services/
├── Screenshot/      → Image processing (Scaling, Encoding)
├── Annotation/      → Window management (Factory, Geometry)
├── HotKey/          → Hotkey configuration

Views/
├── Annotation/
│   ├── Canvas/      → Drawing components
│   ├── Editor/      → Editor components  
│   └── Toolbar/     → Toolbar components
├── MenuBar/         → Menu bar components
├── Settings/Sections/ → Modular form sections
├── Components/      → Reusable UI components
└── Helpers/         → Hit testing, transforms

📉 File Size Reductions

File	Before	After	Reduction
AnnotationState.swift	527	258	-51%
AnnotationCanvasView.swift	412	182	-56%
AnnotationEditorView.swift	387	125	-68%
ScreenshotSettingsTab.swift	246	36	-85%
ScreenshotService.swift	207	93	-55%

📚 New Documentation

• docs/ARCHITECTURE.md - Layer diagram, data flow, patterns
• docs/COMPONENTS.md - Reusable UI components catalog
• docs/MODELS.md - Data models and state managers
• docs/SERVICES.md - Service classes documentation
• docs/VIEWS.md - View hierarchy and modules

✨ Component Highlights

New Reusable Components:

• UndoRedoManager<T> - Generic undo/redo with configurable history
• SelectionManager - Annotation selection and drag state
• ImageScalingService - High-quality image scaling
• ImageEncodingService - Multi-format encoding (PNG, JPEG, HEIC, TIFF)
• AnnotationWindowFactory - Window creation and configuration
• HitTestEngine - Collision detection for annotations
• AnnotationTransformer - Move/resize operations

New Settings Sections:

• Modular form sections for Settings tabs
• Easy to reuse and maintain

🔧 Technical Details

• 50 files changed
• 3,625 insertions, 1,905 deletions
• All features remain fully functional
• No breaking changes to user experience

📦 Installation

1. Download PeekOCR.dmg
2. Open the DMG file
3. Drag PeekOCR to Applications
4. Launch from Applications or Spotlight

⚙️ System Requirements

• macOS 13.0 (Ventura) or later
• Apple Silicon or Intel Mac

---

Full Changelog: v1.0.0...v1.1.0