KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

Immich-Viewer

★ 97 Open GitHub ↗

A sleek Apple TV viewer for your self-hosted Immich photo & video library. Turn your Apple TV into a beautiful digital photo frame and browse your media on the big screen with high-quality viewing, slideshow mode, interactive navigation, and support for albums, tags, maps, and more — all powered by your Immich server.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Immich for Apple TV

**Relive your favorite memories on the big screen.** Transform your Apple TV into a stunning digital photo frame that brings your self-hosted [Immich](https://immich.app) photo library to life in your living room.

---

## 🎬 Get Started

**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](https://testflight.apple.com/join/7nGMT7cz)

---

## ✨ Features

### 📸 Browse Your Library

| 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 |

### 🗺️ Explore & Discover

| 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 |

### 🖼️ Slideshow — Your Digital Photo Frame

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.

### 🎥 Media Playback

| 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 |

### 👥 Multi-Account Support

| 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 |

### 🎨 Customization

| 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 |

### 📺 Home Screen Integration

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 You Need

| 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 |

---

## 🚀 Quick Setup

Getting started takes just a few minutes:

1. **Install** the app from the App Store on your Apple TV
2. **Open** the app and enter where your Immich server lives (usually something like `http://192.168.1.x:2283` or `https://photos.yourdomain.com`)
3. **Sign in** with the same email and password you use on Immich (or an API key if you prefer)
4. **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.

---

## 🎮 Using Your Remote

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 Developers

For technical architecture details, see [ARCHITECTURE.md](ARCHITECTURE.md).

---

## 📄 License

GPL-3.0 — See [LICENSE](LICENSE) for details.

---

## 🙏 Acknowledgments

- Built for [Immich](https://immich.app) — the self-hosted photo and video management solution
- Forked from [mensadilabs/Immich-Gallery](https://github.com/mensadilabs/Immich-Gallery)

Immich-Viewer

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README