A native Apple TV app for browsing your self-hosted Immich photo library with a TV-optimized interface.
-
πΌοΈ 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
- Apple TV (4th generation or later)
- tvOS 15.0+
- Immich server running and accessible
- Network connectivity between Apple TV and Immich server
- Launch the app - You'll be prompted to sign in to your Immich server
- Enter credentials - Provide the server URL (e.g.,
https://your-immich-server.com) plus either email & password or an Immich API key - Browse your photos - Navigate using the Apple TV remote or Siri Remote
Note
- Clone the repository
- Open
Immich Gallery.xcodeprojin Xcode - Select Apple TV target device
- Build and run
Untitled720p.mov


