The release contains an update to Kodi Omega 21.3.

CHANGES SINCE 12.2.0

• Kodi: updated to 21.3
• linux: update to 6.16.12 (RPi2-5 6.12.56)
• several small updates and fixes

Generic-Legacy nVidia Changes

The nVidia Legacy 340.xx driver remained usable for six years after nVidia discontinued support, but it no longer compiles with the latest Xorg release so has been dropped from the Generic-Legacy image for LibreELEC 12.2 and the future 13.0 release. This impacts older nVidia cards, which are unfortunately the majority of active nVidia installations. We have investigated ‘Nouveau’ and may add support to the main Generic image in the future to assist Lakka retrogaming, but it creates more problems than it solves for video playback and is not a solution for LibreELEC use. Future nVidia GPU support remains a grey area and we continue our long-running advice to avoid purchasing nVidia GPU cards for LibreELEC use.

Tvheadend 4.3

Tvheadend developers declared v4.3 to be a stable rolling release some time ago and v4.2 has not been maintained or supported since 2019 so v4.2 is not available from the LibreELEC 12.2 repo and users are advised to move to Tvheadend v4.3. There is no direct update path from v4.2 to v4.3 so users will need to install v4.3 and configure a new installation. Issues with v4.3 should ideally be reported to Tvheadend developers via their forum (with detailed logs and info) but if reported in our forum we will do our best to assist too.

NXP (iMX6/iMX8) and Qualcomm

Limited support for iMX8 and Qualcomm chips was added in 2018 to assist the early stages of Kodi GBM/V4L2 development. They are mostly used with industrial hardware designs and tablet devices and this relects in no active LibreELEC installs. iMX6 was used widely in the past, but there are now few active installs, and those are using self-built images. Support remains part of our codebase but we have stopped building and releasing official images.

UPDATING

Users with 12.0 installs, or 11.0 installs on x86_64 hardware, can manually update as normal using the LibreELEC settings add-on or by placing an update file in the /storage/.update folder.

Users with 11.x or 10.x installs on ARM hardware need to read below:

• 64-bit capable ARM SoC devices including Raspberry Pi 4/5 have switched from ‘arm’ to ‘aarch64’ userspace. Manual update in LibreELEC settings will not list LibreELEC 12.2 releases as there are no arm images (only aarch64). You can manually update by placing a LibreELEC 12 release file (.tar or .img.gz) in /storage/.update and rebooting.

• If using Widevine to access DRM protected streaming services (Prime, Netflix, etc.) the Widevine CDN folder in /storage/.kodi/cdm must be deleted first as the existing arm libraries do not work on aarch64 systems. On first use after deletion new aarch64 Widevine libraries will be downloaded and installed.

• If using Docker containers via LinuxServer.io add-ons the arch change should be handled automatically. If using containers installed directly from the console: arm containers must be removed before updating as they will not run on aarch64. After updating you can (re)install aarch64 (arm64) compatible versions of your containers.

Users with 9.0 or older installs must perform a clean install due to the Python 3 changes introduced since LibreELEC 10.x (Kodi v19).

BACKUPS

Kodi supports upgrades not downgrades. Create a backup BEFORE upgrading else rolling back to the previous release can be complicated.

SUPPORT

Project staff are available in the forum to answer questions and provide advice. If you have a problem, technical issues are best accompanied by system and Kodi debug logs - help us to help you.

Enjoy! :)

** Click here to go to the download page **

Please send donations to our Open Collective account or use the button below.

SHA256

Append ?mirrorlist to download links to see the file SHA256 hash, e.g. https://releases.libreelec.tv/LibreELEC-RPi5.arm-12.2.1.img.gz?mirrorlist.

The main purpose of the LibreELEC 12.2 release is hardware support: bumping kernels and display components to better handle current and recent Intel hardware and keeping Raspberry Pi boards aligned with RPiOS. The release contains Kodi Omega 21.2 with a small number of additional improvements that Kodi backported to Omega since the Kodi 21.2 release (no 21.3 release is planned).

Generic-Legacy nVidia Changes

The nVidia Legacy 340.xx driver remained usable for six years after nVidia discontinued support, but it no longer compiles with the latest Xorg release so has been dropped from the Generic-Legacy image for LibreELEC 12.2 and the future 13.0 release. This impacts older nVidia cards, which are unfortunately the majority of active nVidia installations. We have investigated ‘Nouveau’ and may add support to the main Generic image in the future to assist Lakka retrogaming, but it creates more problems than it solves for video playback and is not a solution for LibreELEC use. Future nVidia GPU support remains a grey area and we continue our long-running advice to avoid purchasing nVidia GPU cards for LibreELEC use.

Tvheadend 4.3

Tvheadend developers declared v4.3 to be a stable rolling release some time ago and v4.2 has not been maintained or supported since 2019 so v4.2 is not available from the LibreELEC 12.2 repo and users are advised to move to Tvheadend v4.3. There is no direct update path from v4.2 to v4.3 so users will need to install v4.3 and configure a new installation. Issues with v4.3 should ideally be reported to Tvheadend developers via their forum (with detailed logs and info) but if reported in our forum we will do our best to assist too.

NXP (iMX6/iMX8) and Qualcomm

Limited support for iMX8 and Qualcomm chips was added in 2018 to assist the early stages of Kodi GBM/V4L2 development. They are mostly used with industrial hardware designs and tablet devices and this relects in no active LibreELEC installs. iMX6 was used widely in the past, but there are now few active installs, and those are using self-built images. Support remains part of our codebase but we have stopped building and releasing official images.

UPDATING

Users with 12.0 installs, or 11.0 installs on x86_64 hardware, can manually update as normal using the LibreELEC settings add-on or by placing an update file in the /storage/.update folder.

Users with 11.x or 10.x installs on ARM hardware need to read below:

• 64-bit capable ARM SoC devices including Raspberry Pi 4/5 have switched from ‘arm’ to ‘aarch64’ userspace. Manual update in LibreELEC settings will not list LibreELEC 12.2 releases as there are no arm images (only aarch64). You can manually update by placing a LibreELEC 12 release file (.tar or .img.gz) in /storage/.update and rebooting.

• If using Widevine to access DRM protected streaming services (Prime, Netflix, etc.) the Widevine CDN folder in /storage/.kodi/cdm must be deleted first as the existing arm libraries do not work on aarch64 systems. On first use after deletion new aarch64 Widevine libraries will be downloaded and installed.

• If using Docker containers via LinuxServer.io add-ons the arch change should be handled automatically. If using containers installed directly from the console: arm containers must be removed before updating as they will not run on aarch64. After updating you can (re)install aarch64 (arm64) compatible versions of your containers.

Users with 9.0 or older installs must perform a clean install due to the Python 3 changes introduced since LibreELEC 10.x (Kodi v19).

BACKUPS

Kodi supports upgrades not downgrades. Create a backup BEFORE upgrading else rolling back to the previous release can be complicated.

SUPPORT

Project staff are available in the forum to answer questions and provide advice. If you have a problem, technical issues are best accompanied by system and Kodi debug logs - help us to help you.

Enjoy! :)

** Click here to go to the download page **

Please send donations to our Open Collective account or use the button below.

SHA256

Append ?mirrorlist to download links to see the file SHA256 hash, e.g. https://releases.libreelec.tv/LibreELEC-RPi5.arm-12.2.0.img.gz?mirrorlist.

IMPORTANT

64-bit capable ARM SoC devices including Raspberry Pi 4/5 have been switched from ‘arm’ to ‘aarch64’ userspace. Manual update in LibreELEC settings will not list LibreELEC 12.0 releases on switched devices as there are no matching arm images (only aarch64). You can manually update by placing a LibreELEC 12 release file (.tar or .img.gz) in /storage/.update and rebooting.

If using Widevine to access DRM protected streaming services like Prime Video, Netflix, etc. the Widevine CDN folder in /storage/.kodi/cdm on switched devices must be deleted before first use as the existing arm libraries do not work on aarch64 systems. On first use after deletion aarch64 Widevine libraries will be downloaded and installed.

If using Docker containers via LinuxServer.io add-ons the arch change should be handled automatically. If using containers installed from the console: arm containers must be removed before updating as they will not run on aarch64. After updating aarch64 (arm64) compatible versions of your containers can be (re)installed.

Updating from LibreELEC 9.x and older requires a clean install due to the Python 3 changes introduced since LibreELEC 10.x (Kodi v19).

CHANGES SINCE 12.0.1

• Kodi: updated to 21.2
• linux: update to 6.6.71 (RPi2-5 6.6.70)
• several small updates and fixes

RPi gpiozero

• RPi gpiozero is broken (due kernel version) and requires a workaround for now at LE 12.0.2
  If you want to use it change line 66 of /storage/.kodi/addons/virtual.rpi-tools/lib/gpiozero/pins/lgpio.py

from
chip = 4 if (self._get_revision() & 0xff0) >> 4 == 0x17 else 0

to
chip = 0

KNOWN PROBLEMS

• Allwinner OrangePi Win does not work properly, currently unfixed.
• Allwinner and Rockchip devices are not widely tested. If there are problems please report them.
• Rockchip RK3328 (Rock64 …) devices are currently are not working.

RASPBERRY PI

• 50/60fps H264 HW decoding may need force_turbo=1 or core_freq_min=500 in config.txt to avoid AV-sync-issues/skipping

GENERIC (x86_64)

The Generic image uses GBM/V4L2 graphics stack and supports HDR/HDR10/HLG with recent AMD and Intel GPUs. The Generic-Legacy image runs X11 graphics stack and does not support HDR. Use Generic-Legacy if:

• You need support for nVidia GPUs
• You need support for the Chrome Browser add-on
• You see graphical glitches on older hardware, e.g. NUC 6th Gen

Intel and AMD hardware can switch between Generic/Generic-Legacy versions. Note that Generic (GBM) uses OpenGLES while Generic-Legacy (X11) uses OpenGL so visualiser and screensaver add-ons need to be removed and reinstalled when switching. You also need to clear the package cache in /storage/.kodi/addons/packages else reinstalling reuses the (wrong) cached package instead of downloading from the LibreELEC repo.

NB: nVidia made progress in support for modern graphics standards and recent cards (with recent drivers) can use mesa. However the mesa (GBM) drivers depend on Wayland which lacks automatic refresh-rate switching for a good Kodi experience and Kodi supports VDPAU not NVDEC. In short: there is still no clear technical path for modern nVidia cards to use the Generic (GBM) image, only Generic-Legacy (X11) and we continue to recommend users do not invest in nVidia GPUs.

AMLOGIC

The AMLGX image allows older Amlogic hardware to run the latest Kodi version and add-ons but it is not as feature-complete or stable as older vendor-kernel releases. It is not perfect but quite usable with typical 1080p-oriented media collections:

• Supports Amlogic S905, S905D/X, and S912 hardware
• H264 1080p playback and seeking work well
• HEVC and VP9 1080p/4K playback work well but seeking is 50/50
• HDR works on S905X/D and S912 devices
• Multi-Channel PCM and Pass-Through audio works on HDMI up to 7.1 channels
• Software-only decoding on S905X2/D2/Y2, S905X3, S922X,and A311D devices

To set expectations the ‘No’ list includes:

• No support for updates from older LibreELEC and CE releases (clean install is mandatory)
• No support for internal eMMC install on box hardware except WeTek Hub/Play2
• No support for SSV6501 and S908CS WiFi chips
• No drivers for in-box DVB tuners
• No hardware deinterlacing
• No HDR to SDR tonemapping

The AMLGX image has a different boot and SD card preparation process so PLEASE READ THIS WIKI ARTICLE for more info on differences between AMLGX and older LibreELEC (and CE) releases.

BACKUPS

Kodi supports upgrades not downgrades. We recommend creating a backup BEFORE upgrading else rolling back to the previous release can be complicated.

SUPPORT

Project staff are available in the forum to answer questions and provide advice. If you have a problem, technical issues are best accompanied by system and Kodi debug logs - help us to help you.

Enjoy! :)

** Click here to go to the download page **

Please send donations to our Open Collective account or use the button below.

SHA256

Append ?mirrorlist to download links to see the file SHA256 hash, e.g. https://releases.libreelec.tv/LibreELEC-RPi4.arm-12.0.2.img.gz?mirrorlist.

This long-overdue update to LibreEEC USB-SD Creator adds Arabic and Korean language translations, switches Windows to x64, and reinstates support for macOS. The updated installer files are now live on mirrors and website download links are updated.

Huge thanks to @kambala-decapitator, @phunkyfish, @CvH, @lrusak, @chewitt for their efforts on bumping Qt, modernising code, reworking the build processes to use CMake and auto-build the app using GitHub actions. We now sign macOS bits correctly to prevent gatekeeper issues. Translation changes from Transifex are now synced automatically so language updates need less effort.

The creator app contains a version check. Older releases will prompt that a new version is available but will not auto-download or auto-update; newer app versions must installed manually. Older Linux 32/64 and Win32 versions will also show the update prompt but no udpates are available: Windows Win32 has been discontinued and Linux needs more work before we can reinstate support.

Download Links:

• LibreELEC USB-SD Creator (macOS) - mirrors/sha256
• LibreELEC USB-SD Creator (Windows x64) - mirrors/sha256

Enjoy! :)

Please send donations to our Open Collective account or use the button below.

IMPORTANT

64-bit capable ARM SoC devices including Raspberry Pi 4/5 have been switched from ‘arm’ to ‘aarch64’ userspace. Manual update in LibreELEC settings will not list LibreELEC 12.0 releases on switched devices as there are no matching arm images (only aarch64). You can manually update by placing a LibreELEC 12 release file (.tar or .img.gz) in /storage/.update and rebooting.

If using Widevine to access DRM protected streaming services like Prime Video, Netflix, etc. the Widevine CDN folder in /storage/.kodi/cdm on switched devices must be deleted before first use as the existing arm libraries do not work on aarch64 systems. On first use after deletion aarch64 Widevine libraries will be downloaded and installed.

If using Docker containers via LinuxServer.io add-ons the arch change should be handled automatically. If using containers installed from the console: arm containers must be removed before updating as they will not run on aarch64. After updating aarch64 (arm64) compatible versions of your containers can be (re)installed.

Updating from LibreELEC 9.x and older requires a clean install due to the Python 3 changes introduced since LibreELEC 10.x (Kodi v19).

CHANGES SINCE 12.0.0

• Kodi: updated to 21.1
• linux: update to 6.6.46
• several small updates and fixes

RPi gpiozero

• RPi gpiozero is broken (due kernel version) and requires a workaround for now at LE 12.0.1
  If you want to use it change line 66 of /storage/.kodi/addons/virtual.rpi-tools/lib/gpiozero/pins/lgpio.py

from
chip = 4 if (self._get_revision() & 0xff0) >> 4 == 0x17 else 0

to
chip = 0

KNOWN PROBLEMS

• Allwinner OrangePi Win does not work properly, currently unfixed.
• Allwinner and Rockchip devices are not widely tested. If there are problems please report them.
• Rockchip RK3328 (Rock64 …) devices are currently are not working.

RASPBERRY PI

• 50/60fps H264 HW decoding may need force_turbo=1 or core_freq_min=500 in config.txt to avoid AV-sync-issues/skipping

GENERIC (x86_64)

The Generic image uses GBM/V4L2 graphics stack and supports HDR/HDR10/HLG with recent AMD and Intel GPUs. The Generic-Legacy image runs X11 graphics stack and does not support HDR. Use Generic-Legacy if:

• You need support for nVidia GPUs
• You need support for the Chrome Browser add-on
• You see graphical glitches on older hardware, e.g. NUC 6th Gen

Intel and AMD hardware can switch between Generic/Generic-Legacy versions. Note that Generic (GBM) uses OpenGLES while Generic-Legacy (X11) uses OpenGL so visualiser and screensaver add-ons need to be removed and reinstalled when switching. You also need to clear the package cache in /storage/.kodi/addons/packages else reinstalling reuses the (wrong) cached package instead of downloading from the LibreELEC repo.

NB: nVidia made progress in support for modern graphics standards and recent cards (with recent drivers) can use mesa. However the mesa (GBM) drivers depend on Wayland which lacks automatic refresh-rate switching for a good Kodi experience and Kodi supports VDPAU not NVDEC. In short: there is still no clear technical path for modern nVidia cards to use the Generic (GBM) image, only Generic-Legacy (X11) and we continue to recommend users do not invest in nVidia GPUs.

AMLOGIC

The AMLGX image allows older Amlogic hardware to run the latest Kodi version and add-ons but it is not as feature-complete or stable as older vendor-kernel releases. It is not perfect but quite usable with typical 1080p-oriented media collections:

• Supports Amlogic S905, S905D/X, and S912 hardware
• H264 1080p playback and seeking work well
• HEVC and VP9 1080p/4K playback work well but seeking is 50/50
• HDR works on S905X/D and S912 devices
• Multi-Channel PCM and Pass-Through audio works on HDMI up to 7.1 channels
• Software-only decoding on S905X2/D2/Y2, S905X3, S922X,and A311D devices

To set expectations the ‘No’ list includes:

• No support for updates from older LibreELEC and CE releases (clean install is mandatory)
• No support for internal eMMC install on box hardware except WeTek Hub/Play2
• No support for SSV6501 and S908CS WiFi chips
• No drivers for in-box DVB tuners
• No hardware deinterlacing
• No HDR to SDR tonemapping

The AMLGX image has a different boot and SD card preparation process so PLEASE READ THIS WIKI ARTICLE for more info on differences between AMLGX and older LibreELEC (and CE) releases.

BACKUPS

Kodi supports upgrades not downgrades. We recommend creating a backup BEFORE upgrading else rolling back to the previous release can be complicated.

SUPPORT

Project staff are available in the forum to answer questions and provide advice. If you have a problem, technical issues are best accompanied by system and Kodi debug logs - help us to help you.

Enjoy! :)

** Click here to go to the download page **

Please send donations to our Open Collective account or use the button below.

SHA256

Append ?mirrorlist to download links to see the file SHA256 hash, e.g. https://releases.libreelec.tv/LibreELEC-RPi4.arm-12.0.1.img.gz?mirrorlist.

IMPORTANT

64-bit capable ARM SoC devices including Raspberry Pi 4/5 have been switched from ‘arm’ to ‘aarch64’ userspace. Manual update in LibreELEC settings will not list LibreELEC 12.0 releases on switched devices as there are no matching arm images (only aarch64). You can manually update by placing a LibreELEC 12 release file (.tar or .img.gz) in /storage/.update and rebooting.

If using Widevine to access DRM protected streaming services like Prime Video, Netflix, etc. the Widevine CDN folder in /storage/.kodi/cdm on switched devices must be deleted before first use as the existing arm libraries do not work on aarch64 systems. On first use after deletion aarch64 Widevine libraries will be downloaded and installed.

If using Docker containers via LinuxServer.io add-ons the arch change should be handled automatically. If using containers installed from the console: arm containers must be removed before updating as they will not run on aarch64. After updating aarch64 (arm64) compatible versions of your containers can be (re)installed.

Updating from LibreELEC 9.x and older requires a clean install due to the Python 3 changes introduced since LibreELEC 10.x (Kodi v19).

CHANGES SINCE 11.95.2

• linux: update to 6.6.28
• a complete list of fixes

KNOWN PROBLEMS

• Allwinner OrangePi Win does not work properly, currently unfixed.
• Allwinner and Rockchip devices are not widely tested. If there are problems please report them.
• Rockchip RK3328 (Rock64 …) devices are currently are not working.

RASPBERRY PI

• 50/60fps H264 HW decoding may need force_turbo=1 or core_freq_min=500 in config.txt to avoid AV-sync-issues/skipping

GENERIC (x86_64)

The Generic image uses GBM/V4L2 graphics stack and supports HDR/HDR10/HLG with recent AMD and Intel GPUs. The Generic-Legacy image runs X11 graphics stack and does not support HDR. Use Generic-Legacy if:

• You need support for nVidia GPUs
• You need support for the Chrome Browser add-on
• You see graphical glitches on older hardware, e.g. NUC 6th Gen

Intel and AMD hardware can switch between Generic/Generic-Legacy versions. Note that Generic (GBM) uses OpenGLES while Generic-Legacy (X11) uses OpenGL so visualiser and screensaver add-ons need to be removed and reinstalled when switching. You also need to clear the package cache in /storage/.kodi/addons/packages else reinstalling reuses the (wrong) cached package instead of downloading from the LibreELEC repo.

NB: nVidia made progress in support for modern graphics standards and recent cards (with recent drivers) can use mesa. However the mesa (GBM) drivers depend on Wayland which lacks automatic refresh-rate switching for a good Kodi experience and Kodi supports VDPAU not NVDEC. In short: there is still no clear technical path for modern nVidia cards to use the Generic (GBM) image, only Generic-Legacy (X11) and we continue to recommend users do not invest in nVidia GPUs.

AMLOGIC

The AMLGX image allows older Amlogic hardware to run the latest Kodi version and add-ons but it is not as feature-complete or stable as older vendor-kernel releases. It is not perfect but quite usable with typical 1080p-oriented media collections:

• Supports Amlogic S905, S905D/X, and S912 hardware
• H264 1080p playback and seeking work well
• HEVC and VP9 1080p/4K playback work well but seeking is 50/50
• HDR works on S905X/D and S912 devices
• Multi-Channel PCM and Pass-Through audio works on HDMI up to 7.1 channels
• Software-only decoding on S905X2/D2/Y2, S905X3, S922X,and A311D devices

To set expectations the ‘No’ list includes:

• No support for updates from older LibreELEC and CE releases (clean install is mandatory)
• No support for internal eMMC install on box hardware except WeTek Hub/Play2
• No support for SSV6501 and S908CS WiFi chips
• No drivers for in-box DVB tuners
• No hardware deinterlacing
• No HDR to SDR tonemapping

The AMLGX image has a different boot and SD card preparation process so PLEASE READ THIS WIKI ARTICLE for more info on differences between AMLGX and older LibreELEC (and CE) releases.

BACKUPS

Kodi supports upgrades not downgrades. We recommend creating a backup BEFORE upgrading else rolling back to the previous release can be complicated.

SUPPORT

Project staff are available in the forum to answer questions and provide advice. If you have a problem, technical issues are best accompanied by system and Kodi debug logs - help us to help you.

Enjoy! :)

** Click here to go to the download page **

Please send donations to our Open Collective account or use the button below.

SHA256

Append ?mirrorlist to download links to see the file SHA256 hash, e.g. https://releases.libreelec.tv/LibreELEC-RPi4.arm-12.0.0.img.gz?mirrorlist.

NEWS

With the new release cycle we changed many devices to 64-bit, including Rasberry Pi 4 and 5.

If using Widevine DRM (required for various copyprotected video add-ons like Prime Video, Netflix, etc.) on one of these devices and updating from LibreELEC 11, Widevine DRM will need to be reinstalled on these devices due to the changed architecture.

LibreELEC 11.0 installs will not automatically update, but you can manually update. LibreELEC installs from before LibreELEC 10.0 must make a clean install due to the Python 3 changes since Kodi v19.

CHANGES SINCE Beta 1

• Kodi: update to final 21.0 Omega
• xz: revert to 5.4.6 due security concerns
• linux: update to 6.6.25
• fixes nVidia ION
• a complete list of fixes

KNOWN PROBLEMS

• Allwinner and Rockchip devices are not widely tested. If there are problems please report them.
• Rockchip RK3328 (Rock64 …) devices are currently are not working.

RASPBERRY PI

• 50/60fps H264 HW decoding may need force_turbo=1 or core_freq_min=500 in config.txt to avoid AV-sync-issues/skipping

GENERIC (x86_64)

The Generic image runs the same GBM/V4L2 graphics stack we have long used with ARM devices. It supports HDR with recent AMD and Intel GPUs. We added a Generic-legacy image that runs the older X11 graphics stack used in LibreELEC 7.0-10.0. Devices may update between the GBM and X11 images without issues.

Use the Generic-legacy image if:

• You need support for nVidia GPUs
• You need support for the Chrome Browser add-on
• You see graphical glitches on older hardware, e.g. NUC 6th Gen

NB: In the last year nVidia has made progress in their support for modern graphics standards. Drivers are now mesa/GBM compatible but still have dependencies on Wayland which we do not use, and Kodi has no plan to support proprietary NVDEC decoding (but VDPAU remains). We still recommend users avoid investing in nVidia GPUs.

AMLOGIC

Support for Amlogic S905, S905X/D, and S912 devices resumes. H264 playback and seeking is solid. HEVC playback is okay and seeking recently improved from 2/10 to maybe 7/10. HDR works with HEVC/VP9 media on S905X/D and S912 devices. Multi-Channel PCM and Pass-Through audio works on HDMI up to 7.1 channels. With typical 1080p oriented media collections the AMLGX image is quite usable and provides access to the latest Kodi release and compatible add-ons. To be crystal clear: the AMLGX image is not perfect, but cost-of-living is high and $0 updates to old hardware are more appealing to users than $150+ purchases of new hardware. If we resume support (with caveats) fewer old boxes end up in landfill. There’s also an increased chance of people contributing improvements to smooth the rough edges that exist.

To set expectations, here’s the ‘No’ list:

• No support for updates from older LibreELEC releases (clean install is mandatory)
• No support for internal eMMC install except WeTek Hub/Play2 and SBC boards
• No support for SSV6501 and S908CS WiFi chips
• No drivers for in-box DVB tuners
• No hardware deinterlacing
• No HDR to SDR tonemapping
• No formal support for newer S905X2/D2/Y2, S905X3, S922X, A312D devices (read below)

The reason for not formally supporting newer hardware generations is all about hardware decode drivers and user expectations. Amlogic hardware video decoding requires the “VDEC” driver for older GXBB/GXL/GXM hardware and “HEVC” driver (driver, not codec) for newer G12A/G12B/SM1 hardware, and both generations prefer a later iteration of “multi” decoder firmware. The current upstream driver code attempts to mix both drivers in a common codebase with partial success and does not support multi firmware blobs. As a result, the current drivers work well on older hardware, but bugs prevent 10-bit and 4K output on newer hardware, and users with newer and (on paper) more capable hardware generally have higher expectations and more demanding media. To avoid negative feedback and user frustration; if you have newer Amlogic hardware our recommendation is to run Kodi on the Android install that shipped with the box. If you choose to run AMLGX images on newer hardware; expect 1080p maximum output, and minimum interest from developers if you post known issues in the forums.

AMLGX has a different boot and SD card preparation process, i.e. no renaming of device-tree files, so PLEASE READ THIS WIKI ARTICLE for more info on differences between AMLGX and legacy images.

MAKE BACKUPS

We always recommend creating a backup BEFORE upgrades. Otherwise, a quick roll back to the previous version is significantly more difficult. Kodi does not support downgrades; if it ever worked for you in the past it was luck, not design. The Python 3 changes that took place between LibreELEC 9 and LibreELEC 10 guarantee in-situ upgrade challenges, so unless you are already running LibreELEC 10 a clean install is mandatory.

SUPPORT

Project staff are available in the forum to answer questions and provide advice. If you have a problem, technical issues are best accompanied by system and Kodi debug logs - help us to help you.

Enjoy! :)

Donating

Please send donations to our Open Collective account or use the button below.

Click here to go to the download page.

SHA256 Hashes

Just add ?mirrorlist after the link to show the SHA256 hash, for example https://releases.libreelec.tv/LibreELEC-RPi4.arm-11.95.2.img.gz?mirrorlist. We are working at a proper integration into the website.

NEWS

With the new release cycle we changed many devices to 64-bit, including Rasberry Pi 4 and 5.

If using Widevine DRM (required for various copyprotected video add-ons like Prime Video, Netflix, etc.) on one of these devices and updating from LibreELEC 11, Widevine DRM will need to be reinstalled on these devices due to the changed architecture.

LibreELEC 11.0 installs will not automatically update, but you can manually update. LibreELEC installs from before LibreELEC 10.0 must make a clean install due to the Python 3 changes since Kodi v19.

KNOWN PROBLEMS

• Allwinner and Rockchip devices are not widely tested. If there are problems please report them.
• nVidia ION is broken in this beta. It is fixed in the upcoming Beta2.
• Rockchip RK3328 (Rock64 …) devices are currently are not working.

RASPBERRY PI

• 50/60fps H264 HW decoding may need force_turbo=1 or core_freq_min=500 in config.txt to avoid AV-sync-issues/skipping

GENERIC (x86_64)

The Generic image runs the same GBM/V4L2 graphics stack we have long used with ARM devices. It supports HDR with recent AMD and Intel GPUs. We added a Generic-legacy image that runs the older X11 graphics stack used in LibreELEC 7.0-10.0. Devices may update between the GBM and X11 images without issues.

Use the Generic-legacy image if:

• You need support for nVidia GPUs
• You need support for the Chrome Browser add-on
• You see graphical glitches on older hardware, e.g. NUC 6th Gen

NB: In the last year nVidia has made progress in their support for modern graphics standards. Drivers are now mesa/GBM compatible but still have dependencies on Wayland which we do not use, and Kodi has no plan to support proprietary NVDEC decoding (but VDPAU remains). We still recommend users avoid investing in nVidia GPUs.

AMLOGIC

Support for Amlogic S905, S905X/D, and S912 devices resumes. H264 playback and seeking is solid. HEVC playback is okay and seeking recently improved from 2/10 to maybe 7/10. HDR works with HEVC/VP9 media on S905X/D and S912 devices. Multi-Channel PCM and Pass-Through audio works on HDMI up to 7.1 channels. With typical 1080p oriented media collections the AMLGX image is quite usable and provides access to the latest Kodi release and compatible add-ons. To be crystal clear: the AMLGX image is not perfect, but cost-of-living is high and $0 updates to old hardware are more appealing to users than $150+ purchases of new hardware. If we resume support (with caveats) fewer old boxes end up in landfill. There’s also an increased chance of people contributing improvements to smooth the rough edges that exist.

To set expectations, here’s the ‘No’ list:

• No support for updates from older LibreELEC releases (clean install is mandatory)
• No support for internal eMMC install except WeTek Hub/Play2 and SBC boards
• No support for SSV6501 and S908CS WiFi chips
• No drivers for in-box DVB tuners
• No hardware deinterlacing
• No HDR to SDR tonemapping
• No formal support for newer S905X2/D2/Y2, S905X3, S922X, A312D devices (read below)

The reason for not formally supporting newer hardware generations is all about hardware decode drivers and user expectations. Amlogic hardware video decoding requires the “VDEC” driver for older GXBB/GXL/GXM hardware and “HEVC” driver (driver, not codec) for newer G12A/G12B/SM1 hardware, and both generations prefer a later iteration of “multi” decoder firmware. The current upstream driver code attempts to mix both drivers in a common codebase with partial success and does not support multi firmware blobs. As a result, the current drivers work well on older hardware, but bugs prevent 10-bit and 4K output on newer hardware, and users with newer and (on paper) more capable hardware generally have higher expectations and more demanding media. To avoid negative feedback and user frustration; if you have newer Amlogic hardware our recommendation is to run Kodi on the Android install that shipped with the box. If you choose to run AMLGX images on newer hardware; expect 1080p maximum output, and minimum interest from developers if you post known issues in the forums.

AMLGX has a different boot and SD card preparation process, i.e. no renaming of device-tree files, so PLEASE READ THIS WIKI ARTICLE for more info on differences between AMLGX and legacy images.

MAKE BACKUPS

We always recommend creating a backup BEFORE upgrades. Otherwise, a quick roll back to the previous version is significantly more difficult. Kodi does not support downgrades; if it ever worked for you in the past it was luck, not design. The Python 3 changes that took place between LibreELEC 9 and LibreELEC 10 guarantee in-situ upgrade challenges, so unless you are already running LibreELEC 10 a clean install is mandatory.

SUPPORT

Project staff are available in the forum to answer questions and provide advice. If you have a problem, technical issues are best accompanied by system and Kodi debug logs - help us to help you.

Enjoy! :)

Donating

Please send donations to our Open Collective account or use the button below.

Click here to go to the download page.

SHA256 Hashes

Just add ?mirrorlist after the link to show the SHA256 hash, for example https://releases.libreelec.tv/LibreELEC-RPi4.arm-11.95.1.img.gz?mirrorlist. We are working at a proper integration into the website.

NEWS

With the final release of LibreELEC 11 we are adding experimental RPi5 support. The focus of RPi5 development is on Kodi 21, which will be released in early 2024. The only known issue so far is that updating the EEPROM is not yet supported in the LE setting (run rpi-eeprom-update -a from the shell).

CHANGES SINCE 11.0.5

updates:

• linux: update to 6.1.74
• a complete list of fixes

RASPBERRY PI

• 50/60fps H264 HW decoding may need force_turbo=1 or core_freq_min=500 in config.txt to avoid AV-sync-issues/skipping
• Kodi at RPi4 runs in 4096x2160 instead of 3840x2160 on 4k TVs after fresh installation. Configure Kodi as described at the wiki and optionally add hdmi_enable_4kp60=1 to config.txt and enable HDMI UltraHD Deep Color in your TV’s HDMI port configuration to get 4kp60 modes

GENERIC (x86_64)

The Generic image now runs the same GBM/V4L2 graphics stack we have long used with ARM platforms. It now supports HDR with recent AMD and Intel GPUs. We have added a Generic-Legacy image that runs the older X11 graphics stack used in LE v7-v10. You can update between the GBM and X11 images without issues.

Use the Generic-Legacy image if:

• You need support for nVidia GPUs
• You need support for the Chrome Browser add-on
• You see graphical glitches on older hardware, e.g. NUC 6th Gen, AMD GPUs

NB: In the last year nVidia has made progress in their support for modern graphics standards. Drivers are now mesa/GBM compatible but still have dependencies on Wayland which we do not use, and Kodi has no plan to support proprietary NVDEC decoding (but VDPAU remains). We still recommend users avoid investing in nVidia GPUs.

ALLWINNER

Support for the Orange Pi 3 LTS board is still “work in progress” and there are known problems.

AMLOGIC

Support for Amlogic S905, S905X/D, and S912 devices resumes. H264 playback and seeking is solid. HEVC playback is okay and seeking recently improved from 2/10 to maybe 7/10. HDR works with HEVC/VP9 media on S905X/D and S912 devices. Multi-Channel PCM and Pass-Through audio works on HDMI up to 7.1 channels. With typical 1080p oriented media collections the AMLGX image is quite usable and provides access to the latest Kodi release and compatible add-ons. To be crystal clear: the AMLGX image is not perfect, but cost-of-living is high and $0 updates to old hardware are more appealing to users than $150+ purchases of new hardware. If we resume support (with caveats) fewer old boxes end up in landfill. There’s also an increased chance of people contributing improvements to smooth the rough edges that exist.

To set expectations, here’s the ‘No’ list:

• No support for updates from older LE releases (clean install is mandatory)
• No support for internal eMMC install except WeTek Hub/Play2 and SBC boards
• No support for SSV6501 and S908CS WiFi chips
• No drivers for in-box DVB tuners
• No hardware deinterlacing
• No HDR to SDR tonemapping
• No formal support for newer S905X2/D2/Y2, S905X3, S922X, A311D devices (read below)

The reason for not formally supporting newer hardware generations is all about hardware decode drivers and user expectations. Amlogic hardware video decoding requires the “VDEC” driver for older GXBB/GXL/GXM hardware and “HEVC” driver (driver, not codec) for newer G12A/G12B/SM1 hardware, and both generations prefer a later iteration of “multi” decoder firmware. The current upstream driver code attempts to mix both drivers in a common codebase with partial success and does not support multi firmware blobs. As a result, the current drivers work well on older hardware, but bugs prevent 10-bit and 4K output on newer hardware, and users with newer and (on paper) more capable hardware generally have higher expectations and more demanding media. To avoid negative feedback and user frustration; if you have newer Amlogic hardware our recommendation is to run Kodi on the Android install that shipped with the box. If you choose to run AMLGX images on newer hardware; expect 1080p maximum output, and minimum interest from developers if you post known issues in the forums.

AMLGX has a different boot and SD card preparation process, i.e. no renaming of device-tree files, so PLEASE READ THIS WIKI ARTICLE for more info on differences between AMLGX and legacy images.

DVB ADD-ONS

DVB Add-Ons are currently deactivated. Digital Devices and TBS have currently no support for recent kernels so we are out of options. If you require support for those devices please stay at LE10.

MAKE BACKUPS

We always recommend you to create a backup BEFORE you upgrade. Otherwise, rolling back is basically impossible. Kodi does not support downgrades; if it ever worked for you in the past it was luck, not design. The Python3 changes that took place between LE9.x and LE10.x guarantee in-situ upgrade challenges, so unless you are already running LE10 a clean install is mandatory.

SUPPORT

Project staff are available in the forum to answer questions and provide advice. If you have a problem, technical issues are best accompanied by system and Kodi debug logs - help us to help you.

Enjoy! :)

Donating

Please send donations to our Open Collective account or use the button below.

Click here to go to the download page.

SHA256 Hashes

Just add ?mirrorlist after the link to show the SHA256 hash, for example https://releases.libreelec.tv/LibreELEC-RPi4.arm-11.0.6.img.gz?mirrorlist .
We are working at a proper integration into the website.

NEWS

With the final release of LibreELEC 11 we are adding experimental RPi5 support. The focus of RPi5 development is on Kodi 21, which will be released in early 2024. The only known issue so far is that updating the EEPROM is not yet supported in the LE setting (run rpi-eeprom-update -a from the shell).

CHANGES SINCE 11.0.4

updates:

• kodi: update to 20.3
• linux: update to 6.1.71
• a complete list of fixes

RASPBERRY PI

• 50/60fps H264 HW decoding may need force_turbo=1 or core_freq_min=500 in config.txt to avoid AV-sync-issues/skipping
• Kodi at RPi4 runs in 4096x2160 instead of 3840x2160 on 4k TVs after fresh installation. Configure Kodi as described at the wiki and optionally add hdmi_enable_4kp60=1 to config.txt and enable HDMI UltraHD Deep Color in your TV’s HDMI port configuration to get 4kp60 modes

GENERIC (x86_64)

The Generic image now runs the same GBM/V4L2 graphics stack we have long used with ARM platforms. It now supports HDR with recent AMD and Intel GPUs. We have added a Generic-Legacy image that runs the older X11 graphics stack used in LE v7-v10. You can update between the GBM and X11 images without issues.

Use the Generic-Legacy image if:

• You need support for nVidia GPUs
• You need support for the Chrome Browser add-on
• You see graphical glitches on older hardware, e.g. NUC 6th Gen, AMD GPUs

NB: In the last year nVidia has made progress in their support for modern graphics standards. Drivers are now mesa/GBM compatible but still have dependencies on Wayland which we do not use, and Kodi has no plan to support proprietary NVDEC decoding (but VDPAU remains). We still recommend users avoid investing in nVidia GPUs.

ALLWINNER

Support for the Orange Pi 3 LTS board is still “work in progress” and there are known problems.

AMLOGIC

Support for Amlogic S905, S905X/D, and S912 devices resumes. H264 playback and seeking is solid. HEVC playback is okay and seeking recently improved from 2/10 to maybe 7/10. HDR works with HEVC/VP9 media on S905X/D and S912 devices. Multi-Channel PCM and Pass-Through audio works on HDMI up to 7.1 channels. With typical 1080p oriented media collections the AMLGX image is quite usable and provides access to the latest Kodi release and compatible add-ons. To be crystal clear: the AMLGX image is not perfect, but cost-of-living is high and $0 updates to old hardware are more appealing to users than $150+ purchases of new hardware. If we resume support (with caveats) fewer old boxes end up in landfill. There’s also an increased chance of people contributing improvements to smooth the rough edges that exist.

To set expectations, here’s the ‘No’ list:

• No support for updates from older LE releases (clean install is mandatory)
• No support for internal eMMC install except WeTek Hub/Play2 and SBC boards
• No support for SSV6501 and S908CS WiFi chips
• No drivers for in-box DVB tuners
• No hardware deinterlacing
• No HDR to SDR tonemapping
• No formal support for newer S905X2/D2/Y2, S905X3, S922X, A311D devices (read below)

The reason for not formally supporting newer hardware generations is all about hardware decode drivers and user expectations. Amlogic hardware video decoding requires the “VDEC” driver for older GXBB/GXL/GXM hardware and “HEVC” driver (driver, not codec) for newer G12A/G12B/SM1 hardware, and both generations prefer a later iteration of “multi” decoder firmware. The current upstream driver code attempts to mix both drivers in a common codebase with partial success and does not support multi firmware blobs. As a result, the current drivers work well on older hardware, but bugs prevent 10-bit and 4K output on newer hardware, and users with newer and (on paper) more capable hardware generally have higher expectations and more demanding media. To avoid negative feedback and user frustration; if you have newer Amlogic hardware our recommendation is to run Kodi on the Android install that shipped with the box. If you choose to run AMLGX images on newer hardware; expect 1080p maximum output, and minimum interest from developers if you post known issues in the forums.

AMLGX has a different boot and SD card preparation process, i.e. no renaming of device-tree files, so PLEASE READ THIS WIKI ARTICLE for more info on differences between AMLGX and legacy images.

DVB ADD-ONS

DVB Add-Ons are currently deactivated. Digital Devices and TBS have currently no support for recent kernels so we are out of options. If you require support for those devices please stay at LE10.

MAKE BACKUPS

We always recommend you to create a backup BEFORE you upgrade. Otherwise, rolling back is basically impossible. Kodi does not support downgrades; if it ever worked for you in the past it was luck, not design. The Python3 changes that took place between LE9.x and LE10.x guarantee in-situ upgrade challenges, so unless you are already running LE10 a clean install is mandatory.

SUPPORT

Project staff are available in the forum to answer questions and provide advice. If you have a problem, technical issues are best accompanied by system and Kodi debug logs - help us to help you.

Enjoy! :)

Donating

Please send donations to our Open Collective account or use the button below.

Click here to go to the download page.

SHA256 Hashes

Just add ?mirrorlist after the link to show the SHA256 hash, for example https://releases.libreelec.tv/LibreELEC-RPi4.arm-11.0.5.img.gz?mirrorlist .
We are working at a proper integration into the website.