Project threads
English
German
Currently supported & unsupported devices
Supported:
- Generic AMD & Intel systems with IGP and/or discrete AMD or Nvidia GPU
- Raspberry Pi 2B, 3B, 3B+
WIP:
- Amlogic S905 | AMLGXL
- Rockchip Rk3399 - ROCKPro64
Currently unsupported:
- other Rockchip based devices -> need a testing device first
Basics
- LibreELEC 9.x-devel | 9.1
- Kodi 18 - v18.2
- Linux 5.1.x - generic x86-64 builds
- Linux 5.1.x - Amlogic S905 | AMLGXL builds
- Linux 5.1.x - RPi2 & RPi3 builds
- Linux 4.4.154 - Rockchip RK3399 builds
Addons & tools for generic builds
- Google Chrome - latest | autoupdate script
- Spotify - latest | autoupdate script
Minor features
- Updated "51-these-are-not-joysticks.rules" udev rules for input devices
- Increased system partion size to 1024MB for new installations
Updated video driver versions
- AMDGPU - v19.0.1
- ATI - v19.0.1
- Intel-video - git 6afed33
- Intel - µcode 2018-08-07a
- Mesa 3D - v19.1.1
- Nvidia - v430.26
- Nvidia-legacy - v340.107
Updated daemons / backends
- GCC - v8.3
- glibc - v2.29
- LLVM - v8.0.0
- Vulkan-Loader - v1.1.112
- openssl - v1.1.1b
- PulseAudio - 12.2
- Samba - v4.9.9
- SDL2 - git eebad73 | v2.0.9-dev
- systemd - v242
- Qt - v5.12.0
- Xorg-Server - v1.20.5
Sysutils
- mesa-demos - git 317f67f | 8.4.0
- sdl-jstest - git 53b89cc2 | v0.2.1
- spectre-meltdown-checker - git c705afe | v0.41
- Skyscraper by Lars Muldjord - v3.1.4
- vulkan-tools -git 4951cdb | 1.1.112
Emulator Frontends
- Emulationstation-Retropie - v2.8.3
- Pegasus-Frontend - Alpha 11+
- RetroArch - v1.7.7
Emulators included in all builds
- dosbox-sdl2 - git d4380b0 | r4156 | DOS
- hatari - git 50bf142 | v2.2.1+ | Atari ST/STE/TT/Falcon
- moonlight-embedded - git 212eac63 | v2.4.10 | NVIDIA GameStream client
- PPSSPP-SDL - git 4b124a7 | v1.8.0 / v1.7.5 for ARM | Sony PSP
- libretro-2048 - git 8284300 | 2048
- libretro-atari800 - git b3931bb | Atari 5200
- libretro-beetle-dc - git d9f44d0 | Sega Dreamcast
- libretro-beetle-pce-fast - git 7f6f061 | PC-Engine
- libretro-beetle-wswan - git b231cff | Bandai WonderSwan
- libretro-blueMSX - git 4be0a24 | MSX
- libretro-chailove - v0.31.0 | 2D Game Framework with ChaiScript
- libretro-desmume - git 3101540 | Nintendo DS
- libretro-dosbox - git 8f2d731 | DOS
- libretro-fbneo - git 189b99f | Multiple Arcade Machine Emulator
- libretro-fceumm - git e4de631 | Nintendo Entertainment System
- libretro-fuse - git 69a4442 | ZX Spectrum
- libretro-gambatte - git 611cbfd | Nintendo Game Boy (Color)
- libretro-genplus - git 53e043d | Sega Mega Drive
- libretro-mame2003-plus - git c59c1f7 | Romset 0.78 | Multiple Arcade Machine Emulator
- libretro-mgba - git bf8c1d1 | 0.7.1+ | Nintendo Game Boy Advance
- libretro-mrboom - git 7f18b80a | v4.7+ | Bomberman clone
- libretro-mupen64plus - git 501d298 | Nintendo N64
- libretro-mupen64plus-nx - git 504ec2c | Nintendo N64
- libretro-nestopia - git 44800c5 | Nintendo Entertainment System
- libretro-pcsx-rearmed - git e1d8eb0 | Sony Playstation
- libretro-prboom - git 5371c88 | Doom Clone
- libretro-scummvm - git d6fb141 | Engine for LucasArts adventure games
- libretro-snes9x - git e5ee711 | v1.59.2 | Nintendo Super Nintendo Entertainment System
- libretro-stella - git 3ed8154 | Atari 2600
- libretro-tyrquake - git 7d18c40 | Quake Clone
Emulators included in generic x86-64 builds
- citra - git daeba65 | QT GUI | Nintendo 3DS
- Dolphin - r5.0-10289 | Qt GUI | Nintendo Wii / Gamecube
- fs-uae - git 3d6a8dc | 2.9.7dev4 | Commodore Amiga
- m64p - git bcbef77 | Nintendo N64
- moonlight-qt - v1.0.1 | NVIDIA GameStream client
- PCSX2 - git 5b9e93c | v1.5.0-dev | Docker addon needed | Sony PlayStation 2
- Vice - v3.3-release | Commodore C64
- libretro-beetle-psx - git c20eac9 | Sony Playstation
- libretro-beetle-saturn - git 052f6d6 | Sega Saturn
- libretro-bsnes-mercury git 4e221df | balanced & accuracy | Nintendo Super Nintendo Entertainment System
- libretro-citra - git a0c222c | Nintendo 3DS
- libretro-dolphin - git 1d973f4 | Nintendo Wii / Gamecube
- libretro-kronos - git 88d668c | Sega Saturn
- libretro-mame2016 - git e06d731 | Romset 0.174 | Multiple Arcade Machine Emulator
- libretro-mesen - git 96851e6 | v0.9.7 | Nintendo Entertainment System
- lr-nSide - git 5e965d0 | based on higan v106 | Nintendo Super Nintendo Entertainment System
- libretro-parallel-n64 - git 7e204b0 | Nintendo N64
- libretro-ppsspp - git 4b124a7 | v1.8.0 | Sony PSP
- libretro-yabasanshiro - git f702466 | Sega Saturn
Emulators included in Amlogic S905 | AMLGXL builds
- amiberry - git 780c020 | v2.25+ | Commodore Amiga
- libretro-mame2010 - git c87309d | Romset 0.139 | Multiple Arcade Machine Emulator
- libretro-snes9x2010 - git d857a31 | Nintendo Super Nintendo Entertainment System
- libretro-vice - git b35a177 | Commodore C64
- libretro-yabause - git aa15301 | Sega Saturn
Emulators included in RK3399 builds
- amiberry - git 780c020 | v2.25+ | Commodore Amiga
- libretro-mame2016 - git e06d731 | Romset 0.174 | Multiple Arcade Machine Emulator
- libretro-snes9x2010 - git d857a31 | Nintendo Super Nintendo Entertainment System
- libretro-vice - git b35a177 | Commodore C64
- libretro-yabasanshiro - git f702466 | Sega Saturn
Emulators included in RPi2 & RPi3 builds
- amiberry - git 780c020 | v2.25+ | Commodore Amiga
- libretro-mame2010 - git c87309d | Romset 0.139 | Multiple Arcade Machine Emulator
- libretro-snes9x2010 - git d857a31 | Nintendo Super Nintendo Entertainment System
- libretro-vice - git b35a177 | Commodore C64
- libretro-yabause - git aa15301 | Sega Saturn
Builds systems
I uses VirtualBox v6.0.4 to run a Linux Mint 19 Mate VM as building system and a Thinkpad X220 with Linux Mint 19.1 as well. So this distribution should be suitable for you too. For further information see LibreELEC Wiki / Compile.
Build dependencies
This should be handled automatically by the build script.
Download package source code (optional)
This command starts the download of all the source code packages you'll need for the build process. You can skip this and the source code is downloaded right before each package is build.
For generic x86-64 Intel & AMD CPU use:
PROJECT=Generic ARCH=x86_64 tools/download-tool
For Raspberry Pi (RPi2 & RPi3) use:
PROJECT=RPi DEVICE=RPi2 ARCH=arm tools/download-tool
Dashboard (optional)
This command starts a dashboard that gives you a brief overview which package is currently unpacked, build, installed etc.
For generic x86-64 Intel & AMD CPU use:
PROJECT=Generic ARCH=x86_64 tools/dashboard
For Raspberry Pi (RPi2 & RPi3) use:
PROJECT=RPi DEVICE=RPi2 ARCH=arm tools/dashboard
Build commands Generic
For generic x86-64 Intel & AMD CPU use:
PROJECT=Generic ARCH=x86_64 BUILD_PERIODIC=RR BUILDER_NAME=5schatten BUILDER_VERSION=9.80 make image
Build commands Raspberry
For Raspberry Pi (RPi2 & RPi3) use:
PROJECT=RPi DEVICE=RPi2 ARCH=arm BUILD_PERIODIC=RR BUILDER_NAME=5schatten BUILDER_VERSION=9.80 make image
Build commands Amlogic
For Amlogic S905/S905X AMLGXL use:
PROJECT=Amlogic DEVICE=AMLGXL ARCH=arm BUILD_PERIODIC=RR BUILDER_NAME=5schatten BUILDER_VERSION=9.80 make image
Build commands Rockchip
For ROCKPro64 use:
PROJECT=Rockchip DEVICE=RK3399 ARCH=arm UBOOT_SYSTEM=rockpro64 BUILD_PERIODIC=RR BUILDER_NAME=5schatten BUILDER_VERSION=9.80 make image
Build commands single packages / addons
To build single packages use:
scripts/build "package"
In example for package linux:
PROJECT=Generic ARCH=x86_64 scripts/build linux
Clean up
In case the build process fails try this and build again:
scripts/clean "package"
i.e. this cleans the linux package:
PROJECT=Generic ARCH=x86_64 scripts/clean linux
If you want to start a clean build:
make clean
If you want to start a clean build without buildcache:
make distclean
Issues
Visit the LibreELEC 9 Remix issue page or LibreELEC 9.0 Reborn Remix [Emulationstation|Retroarch|DolphinQT |Chrome|Spotify] for issues pertaining to this specific fork.
For everything else, see the LibreELEC Forum.
Original README below:
LibreELEC
LibreELEC is a 'Just enough OS' Linux distribution for running the award-winning Kodi software on popular mediacentre hardware. LibreELEC is a conservative fork of the popular OpenELEC project with a stronger focus on pre-release testing and post-release change management. Further information on the project can be found on the LibreELEC website.
Issues & Support
Please report issues via the LibreELEC forum: Bug Reports. Please ask support questions in the LibreELEC forum: Help & Support or ask a member of project staff in the #libreelec IRC channel on Freenode.
Donations
Contributions towards current project funding goals can be sent via PayPal to donations@libreelec.tv
License
LibreELEC original code is released under GPLv2.
Copyright
As LibreELEC includes code from many upstream projects it includes many copyright owners. LibreELEC makes NO claim of copyright on any upstream code. However all original LibreELEC authored code is copyright LibreELEC.tv. Patches to upstream code have the same license as the upstream project, unless specified otherwise. For a complete copyright list please checkout the source code to examine license headers. Unless expressly stated otherwise all code submitted to the LibreELEC project (in any form) is licensed under GPLv2 and copyright is donated to LibreELEC.tv. This approach allows the project to stay manageable in the long term by giving us freedom to maintain the code as part of the whole without the management overhead of preserving contact with every submitter, e.g. GPLv3. You are absolutely free to retain copyright. To retain copyright simply add a copyright header to each submitted code page. If you submit code that is not your own work it is your responsibility to place a header stating the copyright.