Immibridge

<p align="center"> <img src="./assets/icon-transparent.png" alt="ImmiBridge" width="128"> </p> <h1 align="center">ImmiBridge</h1> <p align="center"> <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a> <a href="https://www.apple.com/macos/"><img src="https://img.shields.io/badge/macOS-12.0+-blue.svg" alt="macOS"></a> </p> <p align="center"> <a href="https://github.com/emerysilb/immibridge/releases/"><img src="https://img.shields.io/badge/Download-Latest%20Release-blue?style=for-the-badge" alt="Download latest release"></a> </p>

Back up your Apple Photos library to a folder organized by capture date, or directly to an Immich server. Exports originals (including Live Photo paired videos) and optionally rendered edits.

<p align="center"> <img src="./assets/screenshot.png" alt="ImmiBridge Screenshot" width="700"> </p>

Features

• Export photos to local folders organized by date
• Upload directly to Immich photo servers
• Incremental, full, or mirror backup modes
• Filter by albums, media type, or date
• Pause and resume backups
• Scheduled automatic backups
• Menu bar integration
• iCloud photo download with progress tracking
• Metadata-only sync (update metadata without re-uploading files)
• Automatic updates via Sparkle

Installation

Download (Recommended)

1. Download ImmiBridge-x.x.x.dmg from the Releases page
2. Open the DMG and drag ImmiBridge to your Applications folder
3. Launch ImmiBridge from Applications
4. Grant Photos access when prompted

Build from Source

See CONTRIBUTING.md for detailed build instructions.

Quick start:

# Clone the repository
git clone https://github.com/emerysilb/immibridge.git
cd immibridge

# Open in Xcode
open ImmiBridge/ImmiBridge.xcodeproj

Building Signed Releases

To build a notarized DMG for distribution, you need an Apple Developer ID certificate ($99/year). See CONTRIBUTING.md for details.

Usage

Launch ImmiBridge and configure:

1. Source: Choose Photos library and/or custom folders
2. Destination: Local folder and/or Immich server
3. Options: Backup mode, filters, scheduling

Backup Modes

| Mode | Exports | Uses Manifest | Deletes from Destination | |------|---------|---------------|--------------------------| | Smart Incremental | Only new/changed files | Yes | No | | Full | Everything, every time | No | No | | Mirror | Only new/changed files | Yes | Yes (orphaned files) |

Immich Integration

To connect to your Immich server:

1. Go to the Destination tab
2. Enter your Immich server URL (e.g., http://192.168.1.100:2283)
3. Enter your API key (generate one in Immich under User Settings → API Keys)
4. Click Test Connection

Features:

• Uses SHA1 checksums to avoid duplicate uploads
• Live Photos are uploaded as paired video + still image
• Supports album syncing to Immich

Permissions

On first run, macOS will prompt for:

• Photos access: Required to read your photo library
• Local network access: Required if your Immich server is on your local network

If you deny a permission, re-enable it in System Settings → Privacy & Security.

Contributing

Contributions are welcome! See CONTRIBUTING.md for guidelines.

License

MIT License - see LICENSE for details.