# LineageOS-TV-x86 install notes

Project Page: https://github.com/LineageOS-TV-x86
ISO download: https://sourceforge.net/projects/lineageos-tv-x86/files/
Installed Version: lineage-21.0-20250829-UNOFFICIAL-x86_64 (Latest, Pre-release)

## Hints

### skiping "Searching for accessories..." using keyboard

On first boot, a screen would pop up showing "Searching for accessories..."

To skip this, you can try pressing:
* <kbd>Win</kbd> + <kbd>F11</kbd> （[Reference](https://youtu.be/yl5k1GUj8Gc?t=250)）
* <kbd>F10</kbd> （[Reference](https://github.com/LineageOS-TV-x86/x86_64_tv_go/issues/1)）
* If using a 2.4GHz Android TV remote, press <kbd>Back</kbd> button

### bundled libhoudini broken since 2026 (because of time bomb)

`libhoudini` is a library developed by Intel, acting as the translation layer (native bridge) between ARM instruction set and x86 instruction set.

Without this library working properly, all Android apps built for arm architecture wouldn't be able to be launched. (Most of the apps are not intentionally developed for x86 systems)

However, there's a hidden time bomb in the library files bundled in the latest iso, so that since 2026, apps for arm architecture just stopped working as expected.

> [!Tip] Update:
> **Fixed in latest version (2026-03)**

#### related issues:
- https://github.com/LineageOS-TV-x86/x86_64_tv/issues/3
- https://github.com/waydroid-helper/waydroid-helper/issues/78

As a result, we have to replace the lib files with currently working ones.

#### tutorial of replacing libhoudini

I've commented under the github issue:
https://github.com/LineageOS-TV-x86/x86_64_tv/issues/3#issuecomment-3943378906

> [!Tip] Fix
> **On personal computer:**
>
> - **Download:**
>https://github.com/supremegamers/vendor_intel_proprietary_houdini/archive/9e77896350caccd228b36b2e1b4a994aa4bd48da.zip <br/>
> (comes from [supremegamers/vendor_intel_proprietary_houdini](https://github.com/supremegamers/vendor_intel_proprietary_houdini/commits/hpe-14): **branch hpe-14, commit 9e77896**, lib files pulled **from GooglePlayGames PC UKW1.251130.001**)
>
> - extract `prebuilts`, navigate to it in `terminal`
> - run `md5sum ./lib/libhoudini.so`: **should return `3d2191eccb2381e432429bdb6deb9ddb`**
>
> **On machine to install LineageOS-TV-x86:**
>
> - clean install => boot LineageOS-TV-x86
> - connect to Wi-Fi => turn on adb via Wi-Fi (in dev options)
> - you shouldn't change anything else or install third-party apps at this point.
>
> **Back to personal computer:**
> - use `adb` to push the files:
> ```
> adb connect <lineageos-tv-ip>:5555
> adb root
> adb shell 'mount -o rw,remount /'
>
> # push files to /vendor/ instead!!!
> adb push ./* /vendor/
>
> # checksum BEFORE reboot, expect 3d2191eccb2381e432429bdb6deb9ddb
> adb shell 'md5sum /lib/libhoudini.so'
> adb shell 'md5sum /vendor/lib/libhoudini.so'
> ```
> - run `adb shell 'reboot'` to reboot the system
> - After reboot, use `adb` to inspect checksum again:
> ```
> # checksum AFTER reboot, both should also return 3d2191eccb2381e432429bdb6deb9ddb
> adb connect <lineageos-tv-ip>:5555
> adb shell 'md5sum /lib/libhoudini.so'
> adb shell 'md5sum /vendor/lib/libhoudini.so'
> ```
>
> **After all of the steps are done**, you can install Gapps (optional) and third-party apps.
> (I've tried to install Gapps before replacing libhoudini, but the system becomes weirdly laggy)

### Gapps install tutorial

#### related issues:
- https://github.com/LineageOS-TV-x86/x86_64_tv/issues/1

> [!Tip] Update:
> **Fixed in latest version (2026-03)**

#### Gapps Opptions
* [Custom MindTheGapps](https://github.com/supremegamers/MTG-14.0.0-x86_64-ATV)
* [NotSoGapps](https://github.com/supremegamers/NSG-14.0.0-x86_64-ATV): Play Services is being replaced with microG Services

> [!Tip] Tutorial
> - from grub menu, select **"Recovery Mode"**
> - select second option: **Recovery (debug)**
> - on first shell, run `cp /mnt/initrd_a.img /mnt/initrd.img`
> (**this step is essential** or you'll get the `could not mount /mnt/system` error)
> - type `exit` then press <kbd>Enter</kbd> **(repeat twice)**, and you'll get into recovery
> - insert usb storage containing gapps zip file
> - select apply update from recovery menu, and select the zip file from usb
> - wait until install process complete, reboot into "**recovery (debug)**" again
> - on first shell, run `rm /mnt/initrd.img`, then `exit` twice.
(**this step is essential** or you'll get boot loop when booting system)
> - choose reboot system in recovery. Gapps should be successfully installed

### set custom TV-launcher

original launcher package: `org.lineageos.launcher-tv`

You can use ADB to change default launcher:

cmd package set-home-activity "<package-name>"

if not sure about the package name, you can use this command to list packages:

pm list packages

you can filter keyword of packages using:

pm list packages | grep <keyword>