Immich Android TV

Immich is a self hosted backup solution for photos and videos. Current features include:

• Upload and view videos and photos
• Auto backup when the app is opened
• Selective album(s) for backup
• Multi-user support
• Album and Shared albums

More info here: https://github.com/immich-app/immich

This Android TV app will allow you to view those uploaded photos and videos. Current features include:

Features	Status
Sign in by phone (https://github.com/giejay/Immich-Android-TV-Authentication)	Done
Sign in by entering API key	Done
Demo environment	Done
Album fetching + Lazy loading	Done
Showing the photos inside an album	Done
Showing people, random, recent or seasonal photos	Done
Slideshow of the photos and videos with a configured interval	Done
Setting the app as the screensaver	Done
Setting the albums to show in the screensaver	Done
Configure the interval of the screensaver	Done
Add generic sorting of albums and photos	Done
Add sorting for specific album (select last item in row and press right again)	Done
Showing the 4K thumbnail instead of the full image to speed up loading	Done
Showing the EXIF data and improving the slideshow view	Done
Configure whether to play sound with videos	Done
Smarter merging of portrait photos (same people, same date, same city)	Todo
Add transitions to slideshow	Todo
Add places/tags view	Todo
Add background media playing info to screensaver	Todo
Casting capabilities	Todo
Searching in and for albums	Todo
Dependency injection with Hilt/Dagger	Todo

Required API Permissions

When setting up your API key in Immich, make sure to grant the following permissions for the app to function properly:

• album.read - Read album information
• activity.read - Read activity data
• asset.read - Read asset metadata
• asset.view - View assets (photos/videos)
• asset.download - Download assets for viewing
• album.download - Download album content
• archive.read - Read archived items
• face.read - Read face detection data
• library.read - Read library information
• timeline.read - Read timeline data
• memory.read - Read memory/moment data
• partner.read - Read partner sharing data
• person.read - Read person/people data
• session.read - Read session information
• tag.read - Read tag information
• tag.asset - Read asset tag associations

Screenshots

Build steps

1. Clone project with git clone --recurse git@github.com:giejay/Immich-Android-TV.git
2. Create an account at firebase and create a google-services.json file, or cp apps/google-services.example apps/google-services.json
3. copy app/src/strings_other.xml.example to app/src/main/res/values/strings_other.xml and modify the address and API keys for your demo server.
4. Build apk with ./gradlew assembleRelease

Support the project

You can support the project in several ways. The first one is by creating nice descriptive bug reports if you find any: https://github.com/giejay/Immich-Android-TV/issues/new/choose.

Even better is creating a PR: https://github.com/giejay/Immich-Android-TV/pulls.

Lastly, if you feel this Android TV app is a useful addition to the already great Immich app, you might consider buying me a coffee or a beer:

FAQ

I'n not able to set the app as a screensaver

1. Enable development mode on the device (click the build number or "Android TV OS Build" 7 times in the System->About settings).
2. Go to System -> Developer Options and enable USB Debugging.
3. If you don't have ADB installed on your PC, follow these instructions: https://www.xda-developers.com/install-adb-windows-macos-linux/
4. After downloading/installing ADB on the PC, connect to the device using it's IP: adb connect 192.168.xx.xx.
5. Once you are connected, execute the following command: 'adb shell settings put secure screensaver_components nl.giejay.android.tv.immich/.screensaver.ScreenSaverService'
6. Done!