📸 Imagin Raw: A Lean, Open-Source Adobe Bridge Alternative for macOS

Imagin Raw is a high-performance, native macOS utility designed specifically for photographers who need to browse, cull, and organize RAW imagery without the bloat of heavy enterprise software. It targets the "read $\rightarrow$ rate $\rightarrow$ organize" workflow, providing a streamlined experience that prioritizes speed and system efficiency.

Project Goal: To provide a lightweight yet powerful tool for managing RAW photos, avoiding the resource-heavy nature of Adobe Bridge.

---

🛠 Technical Architecture

The application is engineered for maximum performance, utilizing a hybrid approach to UI and data processing.

The Tech Stack

• User Interface: Built using AppKit and UIKit for the thumbnail galleries, as SwiftUI proved insufficient for high-performance scrolling.
• RAW Processing: Leverages LibRaw (C++) via an Objective-C++ bridge, with CoreImage serving as a fallback and handler for other formats.
• Metadata Handling:
  • EXIF: Extracted directly from binary structures of RAW/JPEG files.
  • XMP: Sidecar files are used to ensure full compatibility with Adobe Lightroom and Bridge.
• System Integration:
  • FSEvents for instantaneous folder monitoring.
  • NSMetadataQuery (Spotlight) for rapid indexing and searching.
  • Tasks and OperationQueue for efficient concurrency.

Data Flow Visualization

---

🌟 Key Features

Imagin Raw removes the friction from photo management. It eliminates the need for managed libraries or lengthy import processes.

Core Capabilities

• Multi-Root Browsing: Access an unlimited number of folders across local disks, SD cards, or external drives simultaneously.
• Live File Monitoring: Any changes to the folder structure (additions/deletions) are reflected in the UI in real-time.
• Broad Format Support: Extensive camera manufacturer support via LibRaw.
• Non-Destructive Rating:
  • Star ratings and color labels are saved to XMP sidecars for RAWs.
  • For JPEG/HEIC, data is embedded directly without requiring a full re-encode.
• Culling Workflow: Includes a session-based "Rejection" label. These marks are temporary (not saved to disk) to allow for quick batch-deletion via right-click.
• Smart Deduplication: Automatically hides JPEGs when a corresponding RAW file is present.
• Flexible Viewing: Toggle between a Compact Grid (optimized for previews) and a Large Grid (optimized for browsing).
• Advanced Ingest: Copy photos from SD cards into date-organized folders, with an optional secondary backup destination.
• Burst Management: A dedicated "Review Mode" helps users identify and resolve near-duplicate shots.
• Social Export: A specialized Instagram tool that fits $2:3$ RAW images into a $3:4$ canvas, exporting as PNG to maintain quality.

Export Ratio Logic: $\text{Aspect Ratio} = \frac{\text{Width}}{\text{Height}} \rightarrow \frac{2}{3} \approx 0.66 \implies \text{Target} \frac{3}{4} = 0.75$

---

📊 Imagin Raw vs. Adobe Bridge

[!IMPORTANT] Where Bridge still wins: Bridge renders thumbnails using Adobe Camera Raw (ACR) adjustments. Imagin Raw currently displays unprocessed previews. While basic crop/exposure previews are being considered, replicating the full ACR pipeline is currently unfeasible.

---

⌨️ Keyboard Shortcuts

---

🚀 Installation & Requirements

System Specs

• OS: macOS $14.6$ or newer.
• Hardware: Intel or Apple Silicon.

Getting Started

• App Store: Best for automatic updates and supporting the developer.
• GitHub Releases: Download the latest binary directly.
• Source Code: Compile manually from the repository.

# Example: If cloning to build from source
git clone https://github.com/cristibaluta/Imagin-Raw.git
cd Imagin-Raw
open Imagin\ Raw.xcodeproj

---

📝 Project Details

• License: MIT License
• Language Composition:
  • C++: $73.1\%$
  • Swift: $25.3\%$
  • Other: $1.6\%$
• Contributions: The author welcomes issue reports, ideas, and small bug fixes.

Example of the lightweight browsing interface.