# Android TV Background

Android TV Background is a self-hosted tool that sets rotating background wallpapers on your Android TV from your Plex, Jellyfin, TMDB, Radarr/Sonarr, or Trakt library, designed for use with alternative Android TV. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2494/android-tv-background

## Description

Android TV Background is a self-hosted tool that sets rotating background wallpapers on your Android TV from your Plex, Jellyfin, TMDB, Radarr/Sonarr, or Trakt library, designed for use with alternative Android TV launchers like Project Ivy.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

50/100 (Fair), based on 5 of 5 factors.
- Maintained: 75 (last commit 19 days ago)
- Popular: 40 (99 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 70 (1 GB minimum RAM)
- Security check: 10 (3 serious findings, 27 minor)

## Security check

3 serious findings: Uses pillow 10.3.0, which has a known critical vulnerability; Uses pillow 10.3.0, which has a known critical vulnerability; Uses pillow 10.3.0, which has a known critical vulnerability.
Automated checks on commit 923d9dc, 10 Nov 2026. Not an audit.

## Links

- GitHub: https://github.com/adelatour11/androidtvbackground
- Docker Hub: https://hub.docker.com/r/ninthwalker/androidtvbackground
- Unraid: https://ca.unraid.net/apps/android-tv-background-0k8tmeb1x89qj3?q=android-tv-background

## Common questions

### What API credentials do I need to configure?

Create a .env file from .env.example and add the credentials needed by the script: Plex token/server URL, TMDB API token, Radarr/Sonarr API keys, Trakt client key/username/list name, or Jellyfin URL/API token/user_id.

### Does the script keep old background images after a new run?

No. Each run deletes the contents of the image folder and generates new images from the selected latest media.

### Can I set a specific language for TMDB artwork?

Set TMDB_LANGUAGE in the .env file to a language code such as pt-BR. If no logo exists in that language, the script falls back to English.

### Where is the Docker version?

The project README says the Docker version is in the docker branch of the repository.

### Can I generate colorized backgrounds?

Yes. Separate scripts such as plex_color.py, TMDB_color.py, radarrsonarr_color.py, and plexfriends_color.py create colorized versions.

---
Source: Our Local Host (https://ourlocalhost.com/app/2494/android-tv-background), the self-hosted and open-source app directory.
