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…

  • Media Applications
  • Media Servers
  • Tools & Utilities
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
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

50/100 Fair

Maintained
75last commit 19 days ago
Popular
4099 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
701 GB minimum RAM
Security check
103 serious findings, 27 minor

Availability: platform listings confirmed today, links checked 25 days ago

GitHub stars
99
Open issues
1
Last commit
2026-11-02
License
MIT
Activity
stale

Checked 8 days ago - source: GitHub (adelatour11/androidtvbackground)

Resources & Compatibility

Minimum requirements: 1 GB RAM. ARM (e.g. Raspberry Pi) is not supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Pick your Firebase project first Run the firebase use command and replace {your_firebase_project_id} with the actual name of your Firebase project. This tells the server which cloud project to deploy to, and skipping it can make the deployment fail or use the wrong account. source
  • Install server packages before deploying Run npm install in the server folder before you deploy the server. This downloads the code libraries the Cloud Functions (small server programs that run on demand) need, so they won't be missing pieces that stop them from starting. source
  • Install web packages before deploying Run npm install in the web folder before you deploy the web app. It fetches the extra files the web interface needs, so the hosted app won't be incomplete or fail to load. source
  • Set up your API keys Create a .env file from .env.example and add your Plex token and server URL, TMDB API Read Access Token, Radarr and Sonarr API keys, and Trakt client key, username, and list name. source
  • Deploy the Docker container Run the maintained ninthwalker/androidtvbackground image from Docker Hub or Unraid; it is the Docker build of the script. source

Fetched 39 days ago - each note links to its source

Alternatives

No alternatives collected yet.

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.

Answers sourced from github.com

Community

Collected 53 days ago - public community threads