tdjb / EmuELEC

EmuELEC, retro emulation for Amlogic devices. Based on CoreELEC. or join us on Discord:

Home Page:

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

EmuELEC is now aarch64 ONLY, compiling and using the ARM version (after 3.9) is no longer supported, please check out the master_32bit branch if you wish to build the 32bit version.


Retro emulation for Amlogic devices.
Based on CoreELEC and Lakka with tidbits from Batocera. I just combine them with Batocera-Emulationstation and some standalone emulators (Advancemame, PPSSPP, Reicast, Amiberry and others). Discord

To build use:

sudo apt update && sudo apt upgrade
sudo apt-get install gcc make git unzip wget xz-utils libsdl2-dev libsdl2-mixer-dev libfreeimage-dev libfreetype6-dev libcurl4-openssl-dev rapidjson-dev libasound2-dev libgl1-mesa-dev build-essential libboost-all-dev cmake fonts-droid-fallback libvlc-dev libvlccore-dev vlc-bin texinfo premake4 golang libssl-dev curl patchelf xmlstarlet default-jre xsltproc
git clone EmuELEC    
cd EmuELEC  
git checkout master  
PROJECT=Amlogic ARCH=aarch64 DISTRO=EmuELEC make image   

For the Odroid N2/s905x2/s905x3/a311d:
PROJECT=Amlogic-ng ARCH=aarch64 DISTRO=EmuELEC make image

For the Odroid Go Advance/Super:
PROJECT=Rockchip DEVICE=OdroidGoAdvance ARCH=aarch64 DISTRO=EmuELEC make image

Note: In some cases you may also need to install tzdata, xfonts-utils and/or lzop sudo apt-get install tzdata xfonts-utils lzop

Remember to use the proper DTB for your device!

If you want to open a PR please do so on the dev branch :)

Need help? have suggestions? check out the Wiki at or join us on our EmuELEC Discord:


Please note, this is mostly a personal project, I can't guarantee that it will work for your box, I've spent many hours trying to optimize and make sure everything works, but I can't test everything and things might just not work at all, also keep in mind the limitations of the hardware and don't expect everything to run at 60FPS (specially N64, PSP and Reicast) I can't guarantee changes to fit your personal needs, but I do appreciate any PRs, help on testing other boxes and fixing issues in general.
I work on this project on my personal time, I don't make any money out of it, so it takes a while for me to properly test any changes, but I will do my best to help you fix issues you might have on other boxes limited to my time and experience.


EmuELEC is based on CoreELEC which in turn is licensed under the GPLv2 (and GPLv2-or-later), all original files created by the EmuELEC team are licensed as GPLv2-or-later and marked as such.

However, the distro includes many non-commercial emulators/libraries/cores/binaries and as such, it cannot be sold, bundled, offered, included, or anything similar, in any commercial product/application including but not limited to: Android Devices, Smart-TVs, TV-boxes, Hand-held Devices, Computers, SBCs, or anything else that can run EmuELEC. with those emulators/libraries/cores/binaries included.

I will also add this from the CoreELEC readme, adapted to EmuELEC:

As EmuELEC includes code from many upstream projects it includes many copyright owners. EmuELEC makes NO claim of copyright on any upstream code. 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 EmuELEC project (in any form) is licensed under GPLv2-or-later. 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.


All EmuELEC related logos, videos, images and branding in general are the sole property of EmuELEC and they are all Copyrighted by the EmuELEC team and are not to be included in any commercial application whatsoever without the proper authorization, (yes, this includes EmuELEC bundled with ROMS for donations!).

You are however granted permission to include/modify them in your forks/projects as long as they are completely open-source, freely available (as in [but not limited to] not under a bunch of "click this sponsored ad to get the link!"), and do not infringe on any copyright laws, even if you receive donations for such project (we are not against donations for honest people!), we only ask that you give us the proper credit and if possible a link to this repo.

Happy retrogaming!

ezoic increase your site revenue


EmuELEC, retro emulation for Amlogic devices. Based on CoreELEC. or join us on Discord:


Language:Makefile 52.4%Language:Shell 33.1%Language:Python 10.4%Language:GLSL 1.7%Language:C 1.6%Language:CMake 0.4%Language:Emacs Lisp 0.3%Language:Dockerfile 0.1%Language:Jinja 0.0%