WayDroid-ATV/waydroid-androidtv-builds 20260106

20260106 (Android TV 13)

on GitHub

# equivalent to factory reset, all data will be LOST
rm -rf ~/.local/share/waydroid
rm -rf /var/lib/waydroid/overlay*
sudo waydroid init -f

Notes on video payback/hardware-accelerated decoding support

• If you encounter any video-related issues, try setting media.sf.hwaccel=0 in /var/lib/waydroid/waydroid_base.prop to disable VA-API video decoding acceleration
• (For Intel iGPU only) Zero-copy video decoding support is disabled by default (set ro.hardware.gralloc to minigbm_intel in /var/lib/waydroid/waydroid_base.prop to activate it)

Notes for non-GApps (vanilla) builds

• Try this if the home button/developer options does not work:

sudo waydroid shell
settings put global device_provisioned 1
settings --user 0 put secure user_setup_complete 1
settings --user 0 put secure tv_user_setup_complete 1

Changelog

• A new OTA server for my ATV builds is now ready-to-use, which enables OTA updates through the Settings app 🎉
• Non-GApps builds are available now (#58)
• Update to December security patch
• Update libhoudini to 14.0.0_z.GoogleGame_com1.2, which fixes the 2026 time bomb issue in previous version
• Enable DocumentUI for file picker support (#56)
• Fix for persistent home screen issue when running in multi-window mode (#62)
• Fix for TV apps not creating a desktop entry in the host (#42)
• Initial support for running inside Docker/LXC without Waydroid
• Update Mesa to 25.3.3
• Update FFmpeg to 7.0.3
• Merge new patches from Waydroid upstream:
  • Add patches for WiFi connection spoofing (waydroid/android_vendor_waydroid#44)
  • Add a notification manager service for forwarding notifications from Android to the host OS (waydroid/android_vendor_waydroid@2ae39f4) (disabled by default, enable it with persist.waydroid.forward_notifications=true)

Installation

Method 1: Install with waydroid command (recommended)

• Re-initialize Waydroid with WayDroid-ATV OTA server (NOTE: replace GAPPS with VANILLA if you want non-GApps build)

sudo waydroid init -f \
  -c https://waydroid-atv.github.io/ota/system \
  -v https://waydroid-atv.github.io/ota/vendor \
  -r lineage \
  -s GAPPS

• Download images with Waydroid

sudo waydroid upgrade

Method 2: Download and install manually

• Download lineage-20.0-xxxxxxx-GAPPS-waydroid_tv_xxxxx-system.zip and lineage-20.0-xxxxxxx-MAINLINE-waydroid_tv_xxxxx-vendor.zip below (NOTE: replace GAPPS with VANILLA if you want non-GApps build)
• Extract system.img and vendor.img from the downloaded archives
• Copy system.img and vendor.img to /etc/waydroid-extra/images/:

sudo mkdir -p /etc/waydroid-extra/images/
sudo cp <PATH TO SYSTEM IMAGE> /etc/waydroid-extra/images/system.img
sudo cp <PATH TO VENDOR IMAGE> /etc/waydroid-extra/images/vendor.img

• Re-initialize Waydroid setup:

sudo waydroid init -f