Repolode
Submit
IGOLz

IGOLz/ImmichGallery

A native macOS SwiftUI client for browsing and managing your self-hosted Immich photo and video library.

Open-source alternative to:Apple Photos

View on GitHub
Stars
140
Forks
1
Open issues
1
Last commit
yesterday

What is it?

Immich Gallery is an independent macOS app that connects to an Immich server and presents its library in a native interface. It is built with SwiftUI and includes a sidebar, toolbar, keyboard shortcuts, multiple windows and tabs, Quick Look, drag and drop with the Finder, the share sheet, and Shortcuts actions.

The app covers much of the Immich feature set: timeline browsing, albums, people, map and places, smart (CLIP), OCR and filename search, uploads with duplicate detection, metadata editing, sharing, and an administration area for admins. It requires an Immich server v2.0 or later and can sign in with an email and password or an API key.

The project is an early preview and can edit, move and delete photos on the server. It is not affiliated with the Immich project, and it does not provide automatic background backup or an offline library.

Key features

  • 01Timeline, favorites, videos, archive and recently deleted views
  • 02Viewer with zoom, Live Photos, slideshow and HDR display support
  • 03Albums, people, map and places, and smart and OCR search
  • 04Uploads with duplicate detection and ZIP downloads
  • 05Multiple accounts and servers, with credentials stored in the macOS Keychain

Use cases

  • Browsing a self-hosted Immich library on a Mac without using a browser tab
  • Organizing albums, people and metadata from a desktop app
  • Uploading folders of photos to an Immich server from Finder

Quick start

  1. 1

    Download the DMG from the latest release and drag the app to Applications

  2. 2

    Clone the repository

    git clone https://github.com/IGOLz/ImmichGallery.git
  3. 3

    Build the app from the command line

    xcodebuild -project ImmichGallery.xcodeproj -scheme ImmichGallery -configuration Release -derivedDataPath build/DerivedData build

Things to know

  • This is an early preview that can edit, move and delete photos on your Immich server.
  • It requires an Immich server, v2.0 or later, and only runs on macOS 15 or later.
  • Building from source requires Xcode 26 or later.

In collections

Self-hosted photo librariesSelf-hosted appsOpen-source Mac apps

Topics

#immich#macos#swift#swiftui#photos#self-hosted#gallery

FAQ

What is ImmichGallery?
A native macOS SwiftUI client for browsing and managing your self-hosted Immich photo and video library. Immich Gallery is an independent macOS app that connects to an Immich server and presents its library in a native interface. It is built with SwiftUI and includes a sidebar, toolbar, keyboard shortcuts, multiple windows and tabs, Quick Look, drag and drop with the Finder, the share sheet, and Shortcuts actions.
Is ImmichGallery free to use? What license does it have?
ImmichGallery is open source under the MIT license. Check the license terms before using it in commercial products.
Is ImmichGallery still maintained?
Actively maintained. The last commit to ImmichGallery was on Nov 6, 2026.
What can I use ImmichGallery for?
Browsing a self-hosted Immich library on a Mac without using a browser tab Organizing albums, people and metadata from a desktop app Uploading folders of photos to an Immich server from Finder
How do I install ImmichGallery?
Download the DMG from the latest release and drag the app to Applications Clone the repository: git clone https://github.com/IGOLz/ImmichGallery.git Build the app from the command line: xcodebuild -project ImmichGallery.xcodeproj -scheme ImmichGallery -configuration Release -derivedDataPath build/DerivedData build
Where can I get ImmichGallery?
The source code and installation instructions are on GitHub: https://github.com/IGOLz/ImmichGallery

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects