Skip to content

Latest commit

 

History

340 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Platform Language Unit Tests

☕️ Buy me a coffee, Help cover app store fee ☕️ or See supporters list hee

Ok, ok, I'm no wordsmith, don't judge my rhymes!

Download on the App Store

Immich Gallery for Apple TV

Bring your Immich photo library to the biggest screen in your home.

Immich Gallery is a native Apple TV app for browsing, searching, and enjoying your self-hosted photo library from the comfort of your couch.

Beautiful full-screen slideshow mode with customizable playback options makes it easy to relive family memories, share vacation photos, or turn your television into an ambient display during gatherings.

Screenshots

Top Shelf Login
All Photos Filter
All Photos Filter
Albums FoldersTab
Search Settings
Slideshow Stats

Features

  • Slideshow Mode: Beautiful full-screen slideshow mode with customizable playback options, timing, transitions, and optional overlays
  • Photo Grid View: Browse your entire library in a fast, infinite-scrolling grid
  • People Recognition: Jump straight to people Immich detects in your photos
  • Albums: Browse personal and shared Immich albums
  • Tags and External Folders: Browse tags with animated thumbnails and view external library folders
  • Search and Filters: Find photos using Immich content search, locations, dates, and metadata
  • Explore: Discover statistics, locations, and highlights from your library
  • Top Shelf: Choose featured or random photos for the Apple TV Top Shelf
  • Multiple Accounts: Store multiple Immich accounts and switch between servers
  • Flexible Authentication: Sign in with a password or Immich API key
  • EXIF Data: Inspect camera details and location metadata

Private by Design

Your photos stay on your own Immich server. Immich Gallery connects directly to your existing Immich instance and does not upload, store, or process your photo library on third-party servers. The app includes zero telemetry.

Immich Gallery is an independent client for Immich and is not affiliated with or endorsed by the Immich project.

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

API Key Permissions

See the Immich Gallery API key permissions guide for the exact scoped permissions required for complete app functionality.

Stats

Alt

About

A fast, native, and beautiful Apple TV app for your Immich Library. Lean back and browse your gallery on the big screen or start a slideshow and watch with the beautiful animations as a replacement for your screensaver. Comes with sensible defaults for a beautiful out-of-the-box experience or customize for your niche needs.

Topics

Resources

Stars

193 stars

Watchers

4 watching

Forks

Releases

Sponsor this project

Used by

Contributors

Languages