bytePatrol

bytePatrol / Immich-iCloud

Public

Native macOS app that syncs your iCloud Photos library to a self-hosted Immich server. Ledger-backed one-time upload guarantee.

github.combytePatrolImmich-iCloud backup icloud immich macos photo-management
16
0
100% credibility
Found Feb 09, 2026 at 12 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Swift
AI Summary

A native macOS menu bar app that one-time uploads photos and videos from the iCloud Photos library to a self-hosted Immich server while preventing duplicates via local content tracking.

How It Works

1
🔍 Discover the photo sync app

You find Immich-iCloud, the easy way to move your iPhone photos from iCloud to your home photo server without endless duplicates.

2
💻 Download and install on Mac

Grab the app file, drag it to Applications, and open it—approve the one-time security check to get started.

3
🔗 Connect your photo server

Enter your home server's web address and a secure passcode, then allow access to your Photos app so it can see your pictures.

4
👀 Preview what will sync

Run a safe test mode to scan your library, see exactly which photos and videos are new, and confirm no surprises before the real thing.

5
🚀 Start the real upload

Hit sync and watch as your photos flow to your server—live progress shows counts, speeds past duplicates using smart tracking, and resumes if interrupted.

6
⏰ Set it to run automatically

Turn on scheduled backups so new photos sync on their own, even after sleep or restarts, with easy pause anytime.

✅ Perfect photo backup achieved

Your entire iCloud library lives safely on your home server—zero duplicates, full control, effortless ongoing syncs.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 12 to 16 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is Immich-iCloud?

Immich-iCloud is a native macOS app built in Swift that syncs your iCloud Photos library directly to a self-hosted Immich server. It pulls photos, videos, and shared albums via PhotoKit, ensuring one-time uploads with a local ledger tracking asset IDs and SHA-256 fingerprints to prevent duplicates. Users get dry-run previews, resume support, and filters for dates, favorites, or specific albums before real immich icloud sync.

Why is it gaining traction?

It solves common immich icloud pains like manual imports, stuck downloads, or endless duplicates by guaranteeing uploads happen exactly once, even across Macs via cloud-synced ledgers. Features like concurrent uploads, album mapping to Immich, selective sync, and two-way reconciliation stand out as a polished immich icloud alternative to scripts or web UIs. The native app macos experience with menu bar status, notifications, and keyboard shortcuts hooks developers tired of brittle workarounds.

Who should use this?

macOS users self-hosting Immich with large iCloud Photos libraries needing reliable immich icloud backup or immich icloud photos sync. Perfect for those handling shared albums, wanting immich icloud import without data loss, or multi-Mac setups via Dropbox/iCloud Drive. Skip if you're on Linux/Windows or prefer CLI tools.

Verdict

Worth testing as a github native alpha for immich icloud sync needs—strong docs, 52 tests, and thoughtful UX despite 12 stars and 1.0% credibility score. Gatekeeper bypass required (unsigned), and automerge not enabled in repo settings means watch for upstream changes, but it's mature enough for dry-run validation.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.