Skip to content

Home

Display your Immich photos as a slideshow or screensaver on Roku. A small self-hosted companion lets you choose the photos, tune the display, and schedule different profiles.
Get started Installation GitHub
Mountain lake playing full screen on Roku, with the Alpine Escapes album name, photo date, and clock
Your photos on the TV, with optional photo information, clock, and date.
Add the Roku apps to your account:
App Channel Store Add Link
Immich Lounge Open in Store Add to Account
Immich Lounge Screensaver Open in Store Add to Account

What you can do

Choose your photos

Build slideshows from albums, people, tags, and on-this-day memories. Use location filters to focus on a place.

Tune the display

Choose transitions, photo motion, backgrounds, and overlays. Add a clock, date, or weather.

Use profiles and schedules

Keep different photo selections for rooms or occasions. Switch between profiles automatically with weekly schedules.

Keep channel and screensaver separate

Use the same profile for both, or choose different profiles and schedules for each.

Mountain reflection and waterfall portrait photos playing side by side with background glow
Pair portrait photos side by side and choose a background that suits the room.

Make it your own

Alpine Escapes album selected in the companion, with previews of three matching photos
Choose an album and preview the photos that will play.
Companion appearance settings for photo information, backgrounds, clock, and date
Choose the background and the details shown on your TV.
Alpine Escapes, Quiet Evenings, and Travel Favourites profiles in the companion
Keep different photo selections and display settings in named profiles.
Living Room schedule with a weekday Alpine Escapes time slot and Travel Favourites as the fallback
Switch profiles by time and day, with a fallback for the rest of the week.

How it connects

Use the companion web app to manage profiles and schedules. The Roku gets its playlist from the companion and loads photos directly from Immich. Cached data helps playback continue through temporary outages.

See Architecture for the technical details.

Requirements

Component Minimum Version
Immich 3.1
Roku OS 15.0
Docker 24.0 (for companion)

Immich 3.1 or later is supported. Birthday memories require Immich 3.3 or later. Older versions may work but are not actively tested.

Getting Started Installation Configuration Using the Companion Using the Roku Apps Troubleshooting Support