Here’s my build of LineageOS 16.0 Android TV for Raspberry Pi 4 Model B. It is unofficial and unsupported by the LineageOS team. It’s for advanced users only. This build currently uses Google’s SwiftShader software renderer so graphics performance is probably not what you’d expect. Pi 4 model with at least 2GB of RAM is required to run this build.
Important! This image includes parts that are licensed under non-commercial license (Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International). You may use this build freely in personal/educational/etc use. Commercial use is not allowed with this build!
Do not mirror my builds! Please post a link to this page instead.
- Audio (HDMI, 3.5mm jack, USB microphones, bluetooth speakers/headsets, etc)
- Audio DAC (using PCM512x DACs e.g. Hifiberry DAC+)
- Camera (using official Pi camera modules & UVC USB webcams)
- GPS (using external USB modules e.g. U-Blox 7)
- HDMI display
- IR remotes (using external GPIO IR modules e.g. TSOP4838)
- RTC (using external GPIO I2C modules e.g. DS3231)
- Serial console (using external GPIO serial console adapters e.g. PL2303)
- Touchscreen/multi-touch (using official 7” display)
- USB (mouse, keyboard, storage, etc)
- Wifi tethering
- Hardware accelerated graphics (V3D)
- Hardware video decoding & encoding
- Chromecast functionality is not supported on uncertified Android TV devices
- SELinux is in permissive mode
- and more…
- peyo-hd and everyone who has contributed to android-rpi
- brobwind for bluetooth fixes
- Google for Android Things platform
- Android-x86 project
- LineageOS team & everyone who has contributed to LineageOS 16.0
How to install:
- Follow the official Raspberry Pi instructions for writing the image to the SD card.
Q: I can’t find developer options, why?
A: Settings -> Device Preferences -> About -> Click ‘Build number’ several times
Q: I have no root, why? What is that hashtag on my status bar?
A: You need enable root access under Settings -> Device Preferences -> Developer options -> Root access. Root management is now integrated as part of LineageOS’ Privacy Guard and you can manage per app permissions under Settings -> Device Preferences -> Developer options -> Manage root access. You’ll have a persistent notification in the status bar when you’re running an app that uses root permissions.
Q: Settings -> Storage shows total system size of 4 GB. There’s unallocated space on my sdcard. What should I do?
A: This is a 4 GB image, remaining space on your sdcard will remain unallocated. Easiest way to extend /data partition is to simply flash my resize zip in TWRP.
Alternative option is to use e.g. GParted and extend /data partition (/dev/block/mmcblk0p4) to cover the unallocated space. Resizing the partition manually will break support for encrypting /data. Format /data in TWRP recovery (Wipe -> Format data) after resizing to leave required space for crypto footer.
Q: My display is not working. I can only see the rainbow screen but no Android boot animation. What should I do?
A: This build uses 1280x720 resolution by default so you need to use a HDMI display that supports it. If your display doesn’t support 1280x720 resolution, you can try changing values in /boot/config.txt to something it does (see this page). 720p is still the maximum resolution that is supported by the graphics drivers used in this build.
Q: I have official 7” LCD display and touchscreen. What should I do?
A: Official 7” touchscreen is supported without any modifications. You will only need to change display size under Settings -> Display -> Display size (or change ro.sf.lcd_density to 120 in /system/build.prop) to adapt to the smaller resolution.
Q: Raspberry Pi doesn’t have power button, how do I power off/reboot my device?
A: Following keyboard keys work as Android buttons: F1 = Home, F2 = Back, F3 = Multi-tasking, F4 = Menu, F5 = Power, F11 = Volume down, and F12 = Volume up. You can also use one of many third party reboot applications.
Q: How to create a DIY hardware power button?
A: You can send power button events by connecting GPIO21 to ground.
Execute following commands in ‘adb shell’/serial console/terminal (you can enable built-in terminal app from Settings -> Device Preferences -> Developer options -> Local terminal) to enable the feature and reboot your device:
You can also use the DIY power button to boot the device to TWRP recovery. Press and hold the button while powering on the device until you see the TWRP screen. If you use this method to boot to recovery, you can ignore what is said about booting into/out of TWRP later in the FAQ.
Q: How to enable audio through 3.5mm jack?
A: Execute following commands in ‘adb shell’/serial console/terminal (you can enable built-in terminal app from Settings -> Device Preferences -> Developer options -> Local terminal) to enable the feature and reboot your device:
Q: How to boot from USB device?
A: Warning, this is an experimental feature and there’s still some issues with it. Android shows USB storage notification for each partition and you should ignore these. TWRP shows errors in few places but everything seems to be working regardless of this.
- Install EEPROM that supports booting from USB
- Write image to your USB device as above
- Mount the USB device on your computer and rename following files on the boot partition:
mv ramdisk.img ramdisk-sdcard.img mv ramdisk-usb.img ramdisk.img mv ramdisk-recovery.img ramdisk-recovery-sdcard.img mv ramdisk-recovery-usb.img ramdisk-recovery.img
- Plug in the USB device to your Raspberry Pi, remove any sdcard, and boot
Q: How to boot to TWRP recovery?
A: There’s currently no proper way to boot between Android and TWRP, but this can achieved by renaming the ramdisk you want to boot. Execute following commands in ‘adb shell’/serial console/terminal (you can enable built-in terminal app from Settings -> Device Preferences -> Developer options -> Local terminal) and reboot your device:
If mouse cursor doesn’t appear, try replugging your mouse.
Q: How to boot out of TWRP recovery?
A: You can execute the same script in TWRP terminal (Advanced -> Terminal) if you have boot and system partitions mounted (Mount -> Boot & Mount -> System):
Or you can flash my recovery2boot zip in TWRP.
Q: My device keeps booting into TWRP recovery. What should I do?
A: If you have GPIO21 connected to ground (or if you have something drawing power from it) your device will always boot to TWRP recovery (see FAQ section about DIY power button). If you have a hardware failure on GPIO21 you can edit /boot/config.txt to remove the GPIO21 related logic (see ‘Ramdisk’ and ‘Graphics acceleration’ sections).
Q: How to update from previous LineageOS 16.0 build without losing data?
- Boot to TWRP recovery with the build you want to keep the data (see FAQ)
- Plug in an external USB storage device and select ‘Backup’
- Use ‘Select Storage’ to choose the USB device and ‘Swipe to backup’ (it’s only necessary to backup the data partition so you can uncheck other partitions to speed up the process)
- Write new LineageOS 16.0 image to the sdcard following installation instructions
- Boot to TWRP recovery with the new build (see FAQ)
- Select ‘Restore’ and find the backup you created from the USB device (‘Select Storage’)
- Make sure you only have data selected as partitions to restore (uncheck other partitions if available) and select ‘Swipe to Restore’
- (Flash Google apps package/other add-ons you had previously installed)
- Boot out of recovery (see FAQ)
Q: How to install Google apps?
- Download open_gapps-arm-9.0-tvstock-xxxxxxxx.zip and save it to your device’s internal storage or use an external USB drive
- Boot to TWRP recovery (see FAQ)
- Install open_gapps-arm-9.0-tvstock-xxxxxxxx.zip from your selected storage
- Wipe -> Factory reset!
- Boot out of recovery (see FAQ)
Merged commits not mentioned in the changelog.
- initial Android TV build