Skip to content

mensadilabs/Immich-Gallery

Repository files navigation

Build Status Platform Language

Immich Gallery for Apple TV

A native Apple TV app for browsing your self-hosted Immich photo library with a TV-optimized interface.

Features

  • πŸ–ΌοΈ Photo Grid View: Browse your library in a fast, infinite-scrolling grid

  • πŸ‘₯ People Recognition: Jump straight to people Immich detects in your photos

  • πŸ“ Album Support: Navigate personal and shared Immich albums

  • 🏷️ Tag Support with animated thumbnails: Optional tag tab with looping previews

  • πŸ—‚οΈ Folders Tab : View external libray folders.

  • πŸ” Explore Tab: Discover stats, locations, and highlights from your library

  • πŸ“Ί Top Shelf Customization: Pick featured or random photos for the Apple TV top shelf

  • 🎬 Slideshow Mode: Full-screen slideshow with optional clock overlay

  • πŸ‘€ Multi-User Support: Store multiple accounts and switch instantly

  • πŸ“Š EXIF Data: Inspect camera details and location metadata

  • πŸ”’ Privacy First: Pure client, keeps credentials local

    Buy Me A Coffee

Requirements

  • Apple TV (4th generation or later)
  • tvOS 15.0+
  • Immich server running and accessible
  • Network connectivity between Apple TV and Immich server

Quick Start

  1. Launch the app - You'll be prompted to sign in to your Immich server
  2. Enter credentials - Provide the server URL (e.g., https://your-immich-server.com) plus either email & password or an Immich API key
  3. Browse your photos - Navigate using the Apple TV remote or Siri Remote

Note

  • Stuck on "Data couldn't read because its missing"? Update Immich and retry: #67
  • OAuth / OIDC sign-in needs server-side changes (tracked in #77). Use an Immich API key instead.
  • FaceID / PIN locking is currently out of scope. #64

Building from Source

  1. Clone the repository
  2. Open Immich Gallery.xcodeproj in Xcode
  3. Select Apple TV target device
  4. Build and run
Simulator Screenshot - Apple TV 4K (3rd generation) - 2025-08-11 at 18 23 16 image
Untitled720p.mov
image image

Full screen view with people

Album tab

image Simulator Screenshot - Apple TV 4K (3rd generation) - 2025-07-29 at 16 59 04 Simulator Screenshot - Apple TV 4K (3rd generation) - 2025-07-29 at 17 00 05

Stats

Alt

Star History Chart

About

The most feature rich Apple TV client for Immich.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project