Relive your favorite memories on the big screen. Transform your Apple TV into a stunning digital photo frame that brings your self-hosted Immich photo library to life in your living room.
Ready to see your photos on the big screen?
Download from the App Store:
https://apps.apple.com/us/app/immich-viewer/id6757225201
Or try the latest features in beta:
Join the TestFlight Beta
| Feature | Description |
|---|---|
| Photos | Scroll through all your memories in a beautiful grid that showcases every moment |
| Albums | Jump straight to your vacation photos, family gatherings, or any collection you've created |
| People | See all the photos of your loved ones, automatically grouped by face |
| Tags | Find exactly what you're looking for using the tags you've added to organize your photos |
| Folders | Browse your photos the way you organized them originally — your structure, your way |
| Favorites | Instantly access the photos you've starred as your absolute favorites |
| Feature | Description |
|---|---|
| World Map | Travel back through your adventures on an interactive globe showing everywhere you've been |
| Places | Relive your trips by exploring photos from specific continents, countries, and cities |
| Memories | Rediscover what you were doing on this day in years past — a delightful trip down memory lane |
| Search | Simply describe what you're looking for — "beach sunset" or "birthday cake" — and find it instantly |
| Statistics | See your photo collection at a glance with totals and insights about your memories |
Create the perfect ambiance in your home with a continuous slideshow of your memories. Whether you're hosting guests or relaxing with family, your TV becomes a window into your favorite moments:
| Setting | What You Can Do |
|---|---|
| Ken Burns Effect | Add gentle, cinematic motion to your photos, or keep them perfectly still |
| Ambilight Background | Let each photo's colors glow softly around the edges for a stunning effect |
| Reflections | Add an elegant mirror reflection beneath your photos |
| Custom Backgrounds | Choose the backdrop that matches your room's mood — from classic black to soft purple |
| Slide Timing | Control how long you linger on each memory, from 3 seconds to 2 minutes |
| Shuffle Mode | Keep things fresh with photos appearing in random order |
| Auto-Start | Let the slideshow begin automatically when you're not actively browsing |
| Info Overlay | See (or hide) when and where each photo was taken, plus the current time |
| Clock Format | Display time in your preferred 12-hour or 24-hour format |
Tip: Press Play/Pause on your remote to pause and admire a moment. Tap anywhere to exit and browse your library.
| Feature | Description |
|---|---|
| Crystal Clear Quality | See every detail with full-resolution photos on your big screen |
| Video Support | Watch your video memories with smooth, native playback |
| Professional Photo Formats | Even if you shoot in RAW format with a professional camera, your photos display beautifully |
| Photo Information | Swipe up to see when and where each photo was taken, plus camera settings if you're curious |
| Easy Navigation | Simply swipe left or right to move between photos — it's that intuitive |
| Feature | Description |
|---|---|
| Multiple Users | Everyone in your household can view their own photo library — just add their accounts |
| Easy Switching | Switch between family members' libraries in seconds from Settings |
| Flexible Login | Sign in with your regular email and password, or use an API key for advanced setups |
| Setting | What You Can Do |
|---|---|
| Navigation Style | Choose the layout that feels most comfortable — tabs at the top or a sidebar |
| Visible Tabs | Simplify your view by hiding sections you don't use, like Albums, Tags, or Folders |
| Default Tab | Start where you want — pick which view greets you when you open the app |
| Explore Mode | Prefer browsing by location (Places) or by date (Memories)? You decide |
| Sort Order | See your newest memories first, or start from the beginning with oldest first |
| Folder View | Browse folders your way — as a grid, a tree structure, or a timeline |
Your photos greet you right on your Apple TV home screen — before you even open the app:
| Setting | What You Can Do |
|---|---|
| Display Style | Show your photos in a fullscreen carousel or a compact grid |
| Image Selection | Display your most recent photos or surprise yourself with random picks |
| Quick Access | Tap any photo on your home screen to jump straight into the app |
Note: For the best look on your TV, only landscape-oriented photos appear on the home screen.
| What | Details |
|---|---|
| Apple TV | 4th generation or newer (any recent Apple TV will work) |
| tvOS | Version 15.0 or later |
| Immich Server | Your self-hosted Immich server, accessible on your home network |
Getting started takes just a few minutes:
- Install the app from the App Store on your Apple TV
- Open the app and enter where your Immich server lives (usually something like
http://192.168.1.x:2283orhttps://photos.yourdomain.com) - Sign in with the same email and password you use on Immich (or an API key if you prefer)
- Start exploring — your entire photo library is now on your TV!
💡 Need help finding your server address? It's the same URL you use to access Immich on your computer or phone.
The app works naturally with your Apple TV remote — if you can navigate Apple TV, you already know how to use this app:
| What You Want to Do | How to Do It |
|---|---|
| Browse around | Swipe on the touchpad |
| Open something | Click the touchpad |
| Go back | Press the Menu button |
| Pause the slideshow | Press Play/Pause |
| Stop the slideshow | Tap the touchpad |
| See photo details | Swipe up while viewing a photo |
| Hide photo details | Swipe down |
| Zoom the map | Play/Pause to zoom in, long press to zoom out |
For technical architecture details, see ARCHITECTURE.md.
GPL-3.0 — See LICENSE for details.
- Built for Immich — the self-hosted photo and video management solution
- Forked from mensadilabs/Immich-Gallery
