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…
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
Security check: 3 serious findings
- Uses pillow 10.3.0, which has a known critical vulnerability (PyPI)
- Uses pillow 10.3.0, which has a known critical vulnerability (PyPI)
- Uses pillow 10.3.0, which has a known critical vulnerability (PyPI)
Automated checks on commit 923d9dc, 10 Nov 2026. Not an audit.
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
Variants
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
- Self hosting on an android TV box : r/selfhosted - Reddit (reddit)
- TvOverlay app - Displays notifications (and more) over your ... - Reddit (reddit)
- Android TV box : r/selfhosted - Reddit (reddit)
- Android TV device management : r/selfhosted - Reddit (reddit)
- Alternative Launcher Setup : r/AndroidTV - Reddit (reddit)
Collected 53 days ago - public community threads