The files included in this repository are meant to be a TEST (beta) version of EmuELEC that might contain erros/bugs/issues!
While we do our best to test every change some changes might break your installation!
DO NOT INSTALL IF YOU DO NOT FEEL COMFORTABLE DEALING WITH POTENTIAL BUGS
For stable releases visit: https://github.com/EmuELEC/EmuELEC
For support: join us at discord: https://discord.gg/cbgtJTu
A new forum has been open for emuelec: https://emuelec.org
Based on commit: https://github.com/EmuELEC/EmuELEC/commit/2fa0f694480b04a0f574fffc967d1e2cfb2aa9ec
Way too many changes to list here, please check the commit history: https://github.com/EmuELEC/EmuELEC/commits/dev
As always before you do anything make sure you have a backup of your settings or SD card
-
New image available for older devices s905, s905x, s905(?) you can choose from
Amlogic-ng
orAmlogic-old
but this image is using a very old kernel and some emulators do not work including, duckstation, same_cdi, and probably others. This will hopefully fix issues that many older low end devices have with theAmlogic-ng
image. -
New devices supported, FireFly M2 (RK3566), FireFly P2 (RK3568)
EmuELEC-RK356x
and Hardkernel Odroid M1 (RK3568)EmuELEC-OdroidM1
are now supported. -
Untested image
EmuELEC-Radxa_Zero2
Based on commit: https://github.com/EmuELEC/EmuELEC/commit/50ea56f1b6cd435ad25c64fbd865765c2df6b59e
This version will not appear as automatic update as it needs to be thoroughly tested, if you want to test this version you need to manually update it using this method:
- Before you do anything make sure you have a backup of your settings or SD card
- Download and copy the corresponding
.tar
file as is (do not uncompress it) to the update samba share (using Samba/network shares//EMUELEC/Update
or by sftp/winscp/storage/.update
) or by copying the file to the.update
folder on the EEROMS partition. - Press "Start" to open the main ES menu. (This can be done before or after updating)
- Navigate to "EmuELEC settings" -> "Danger Zone" -> "RESET EMUELEC SCRIPTS AND BINARIES TO DEFAULT"
- The device will reboot, wait for the update to finish.
Please report any bugs/issues to https://github.com/EmuELEC/EmuELEC/issues
Known Issues under investigation:
- Sometimes the splash screen does not quit, so a reboot is needed
What needs testing:
- General testing for all devices to make sure the new base is working correctly
- Handheld devices, OGA, OGS and GameForce for general usage
- Mupen64plus Standalone
- Fbneo Standalone, in Arcade, Mame, NeoCD, fbneo, neogeo
- Yabasanshiro Standalone
- Bluetooth controllers in general as the BT backend was reworked
- Autogamepad configuration for Dolphin, Flycast and ADVMAME
Now for the change log
General:
Huge update to base build system:
- All Amlogic devices now use the same kernel 4.9-19!
- You might notice a bit more performance on some emulators as well usage in general.
- IMPORTANT: S905 (GXBB, p201) for the moment is no longer supported. If you have one of those devices (s905 no letter after the 5) DO NOT UPDATE, stay in 4.3.
Fixed Bugs:
- One of the most annoying bugs that plagued fbdev with Retroarch was also fixed (Issue #76)
fixed in PR
mali_fbdev fix for fps drop after egl_destroy
(#789) by spleen1981! This means that using retroarch as bootup option is now possible (some small changes need to be done). - Fixed bluetooth connectivity issues
- Fix zoom not working on manuals
- Fix many external mounting issues
- Backup will now rename the file instead of deleting it after restore.
- Fixed SuperTux and SuperTuxKart data download
- Fixed auto-update would show update available even if there was none.
Additions and other fixes:
- Added WIP Mupen64plus Standalone
- Added fbneo Standalone
- Added Duckstation Standalone
- Added Yabasanshiro Standalone
- Added Blake Stone to ports
- Added iotop
- Added VIM
- Added External Mount settings in ES
- Added option to create key remaps for Advance MAME
- Switch to SDL 2.0.16 for all devices
- Support for Pixelcade (Install script is in Setup)
- Retroachievements encore is now configurable from ES
- Added Enable Integer Overscaling in ES
- Use toggle for fast forward instead of hold
- Add .68k .68K .sgd .SGD to genesis/md
- Added gamepad auto configuration for Dolphin and Flycast EmuELEC/EmuELEC#812 (needs more testing)
- Reworked Advance MAME gamepad auto configuration EmuELEC/EmuELEC#812
And many other changes! for the full list check out the commit history.
S905 GXBB for the moment is no longer supported. So if you have one of those (s905 no letter after the 5) DO NOT UPDATE, stay in 4.3.
This version will not appear as automatic update as it needs to be tested, if you want to test this version you need to manually update it using this method:
- Before you do anything make sure you have a backup of your settings
- Download and copy the corresponding
.tar
file as is (do not uncompress it) to the update samba share (using Samba/network shares//EMUELEC/Update
or by sftp/winscp/storage/.update
). - Press "Start" to open the main ES menu.
- Navigate to "EmuELEC settings" -> "Danger Zone" -> "RESET EMUELEC SCRIPTS AND BINARIES TO DEFAULT"
- The device will reboot, wait for the update to finish.
Or better yet, do a clean install :)
Based on https://github.com/EmuELEC/EmuELEC/commit/6b11573caf3fd4efb910ad45025913530b7273cd
- Fix Stadia Gamepad. Thanks to amuzulo#1322
- Fix issue with lzdoom loading .doom files and sound on mods
- Update some sound packages
- Fix es_systems.cfg: Add extensions to c64/c128 and Amiga (#677)
- Add Cdogs-sdl to ports
- Add Abuse to ports NOTE: WIP controls
- Add Streets of Rage Remake
- Fix Retroarch display of CJK characters
- Fix SFC not scraping
- Updated most emulators and cores
- Create folders for fbneo consoles
Amlogic-ng:
- Add RTL8761 Bluetooth Support (#698)
- Include ssv6xxx-aml drivers
- Fix create /storage/roms/amstradgx4000 on boot
- Cleanup es_systems.cfg remove and add some extentions
- Add Hurrican port (Handhelds currently have no working controls)
- Atomiswave: Remove workaround for nvmem
General:
- Add Flycast Stand Alone
- Add Alternate version of Mupen64plus-nx
- Replace old filemanager for 351Files
- Fix Amstrad GX4000
General:
- Fix Autoupdate
- Fix no backup restore if EEROMS was set to fat32
- Fix no external ROMS if EEROMS was set to fat32
- Fix typo on Parallel N64 32b core name
- Unify Brightness between ES and RA
- Fix advmame.sh: unset DISPLAY for Amlogic and Amlogic-ng
- Fix SuperTux2: Fix sed in launch script
- Fix vertical mode not respecting index ratio
- Fix Connect to WiFi on first boot if using es_defaults.txt
- Fix volume resets to 98% using AV
- Fix Do not redirect stdout/stderr to /dev/null in maxperf and normperf. (#661)
- emuelecRunEmu.sh: remove hardcoded bin path, this allows to use most of the binaries/scripts be called from
/emuelec/bin
or/usr/bin
in that order - Add Megadrive MSU to es_systems.cfg
- Add fceumm-mod libretro core to play some additional NES ROM hacks. (#658)
- New Packages: Box64, Box86, GL4es, Axe11, libglu (for future use)
- Bump most cores and emulators to current versions
- Bump Retroarch to 1.9.6
Amlogic-ng:
- Add preliminary support for Raxda Zero
General:
- Bump Retroarch to 1.9.4
- Add auto gamepad configuration for Hypseus
- Add Non-Commercial Duckstation core (untested)
- always update es_systems.cfg on system update
Odroid Go Advance/Super & GameForce:
- Convert screenshots from pbm to png
GameForce:
- Update U-boot and Kernel
- Fix Opentyrian
- Fix Advancemame
General
- Hypseus replaced by Hypseus-singe
Odroid Go Advance/Super & GameForce:
- Update U-boot and Kernel
GameForce:
- Fix hypseus controls (#622)
General
- Fix latest test missing libs
- Bump RigelEnfgine to fix a bug
Odroid Go Advance/Super & GameForce:
- Use gptokeyb for controls on Solarus
- Fix reboot while charging
- Fix retrorun reversed analogs
- bump Retroarch to v1.9.3
- Switch Duckstation name to Swanstation
- Rework 32bit core detection on emuelecRunEmu.sh
- Yabasanshiro: Revert back to 7ae0de7 as it gives much better performance
- Added freej2me Java games emulator, it accepts .jar files and they should go into /storage/roms/freej2me. Internet is required only on first run to download the Java JDK.
- Update most cores and emulators to latest versions
Amlogic-ng:
- Enable qca6174 drivers (Fixes issues #611)
Odroid Go Advance/Super & GameForce:
- Introduce RetroRun, available for Flycast for the moment
GameForce:
- Move global hotkey to button 1 to avoid conflicting hotkeys in retroarch, 1+Dpad up/down for volume, 1+Dpad lef/right for brightness
- Brightness was not correctly calculated on GameForce (PR #619)
General:
- Add ee_fstype to set the EEROMS partitions to the desired file system, between FAT32 (default), EXT4, EXFAT and NTFS (read the warning about using NTFS). Instructions coming soon to Wiki/forum
- Fix OGG background music
- Update setres.sh and advmame.sh for resolution 1280x1024p60hz (PR #600)
- Fix drastic game saves & save states erased when resetting scripts & binaries to default (PR #595)
- Add Potator a Watara Supervision emulator core (not tested)
- gptokeyb bump and fix missing trigger actions
- Crystal bump to latest
- emuelec-emulationstation bump to latest
Odroid Go Advance/Super & GameForce:
- Bump kernel to use latest Mali G31 blobs
- Introduce RetroRun (not yet fully enabled)
General:
- Use gptokeyb as a fake keyboard for OpenBOR
- Bump Retroarch to 1.9.1
Additions:
- Added Chocolate-Doom with support for mods
- Added Flycast 32bit as core option for Dreamcast/Atomiswave/Naomi
- Added Amstrad GX4000
Fixes:
- Fixed OpenBor would not work after playing one game
- Fixed DevilutionX character voices were wrong
- ARM32 interpreter is now symlinked so no need for patchelf
General:
- Use DinguxFileManager as default on all platforms
- Bump Crystal theme which now includes a new panel (boxart), 16:9, 4:3 and CRT versions
Additions:
- Added Ecwolf with support for mods
- Added supermariowar to ports, on the first run a fake keyboard will be used, make sure you set your gamepad and restart the game, if you need to run the fake keyboard again delete /emuelec/configs/smw/nofakekeyb and run the game again.
General:
- Enable bezels on OGS, not fully tested yet
- Bump Genesis-plus-gx and Genesis-plus-gx-wide to support FM music
Additions:
- Added vertical aspect ratio option to OGA/S
- Added gptokeyb to enable video controls on all devices with SDL support!
- Replace jslisten with gptokeyb to kill emulators
- Added easyrpg to es_systems.cfg
Fixes:
- Fixed an issue with ES not playing .ogg music files in BGM
- Fixed some errors messages were not wrapped and could not be read
General:
- Emulationstation: While in a game list, pressing X will move to a random game, holding X will mark it as favorite (thanks to @lethal-guitar)
- Bump PPSSPPSDL to v1.11
- Bump Duckstation to abb7631
- Pico-8: Allow saving favorite carts, include binary in backup
- Update Sonic 1 and 2 so that they work with multiple gamepads
- Bump most emulators and cores to newest git hash (check commits for specifics)
- Bump Crystal theme which now includes a new panel (boxart)
Additions:
- Added Chocolate-Doom
- Added SuperTux and SuperTuxKart to ports
- Added Imagemagick (mainly for screenshot manipulation from CLI)
- Added logos to the ports (Thanks to Dim!)
Fixes:
- Removed unused scripts, and fixed many small issues with scripts
- Fixed many script that were causing hangups or other issues
- Fixed gamecontrollerdb.sh it will now replace the UUID from the one in the db, this fixes weird controllers that use the same UUID as others (but are not the same)
- Fixed an issue with unicode characters not displaying correctly on the EEROMS partition (CN, JP, etc)
- Fix SonicCD Gamepad for the OGS
- Fix Pico-8 disappearing splore file
- Fix Scummvm game scan
- Fix brightness not restored after reboot on OGA/S, thanks to @miwasp, fixes issue #470
- Fixed issue with OGA/S OC not beeing applied correctly (this does not solve the random lockups on some devices)
- Fix backup/restore issues
- Fixed Retroach video recording
- Fixed Eduke not running when having lots or ROMS in ES, by enabling swap (much testing needed!)
This version includes a big change on how binaries and scripts are stored, basically to deal with the issue of people not reading how to properly update and since I am getting tired of answering the same question over and over again, lets just move all binaries and scripts to RO /usr/bin, this will force update all of these and make updating much simpler.
If you use custom scripts /emuelec/bin and /emuelec/lib are still in the path so you will have to deal with it accordingly.
All configurations regarding emuelec will still be handled in /emuelec/config
Note that this is probably not final, I still need to do a lot of testing, but keep that in mind if you want to update
- Emulationstation: While in a game list, pressing X will move to a random game, holding X will mark it as favorite (thanks to @lethal-guitar)
- Fixed many script that were causing hangups or other issues
- Fixed gamecontrollerdb.sh it will now replace the UUID from the one in the db, this fixes weird controllers that use the same UUID as others (but are not the same)
- Fixed an issue with unicode characters not displaying correctly on the EEROMS partition (CN, JP, etc)
- Added SuperTux and SuperTuxKart to ports
- Fix SonicCD Gamepad for the OGS
- Fix Pico-8 disappearing splore file
- Added Imagemagick (mainly for screenshot manipulation from CLI)
- Bump PPSSPPSDL to v1.11
- Bump Duckstation to abb7631
- Fix Scummvm game scan
- Fix brightness not restored after reboot on OGA/S, thanks to @miwasp, fixes issue #470
- Removed unusued scripts, and fixed many small issues with scripts
- Fixed issue with OGA/S OC not beeing applied correctly (this does not solve the random lockups on some devices)
- Added Chocolate-Doom
Just a small release fixing some big bugs from last release
- Fixed ES slow downs when scrolling and changing settings
- Fixed gamepad not closing error/message window
- Fixed Pico-8 on OGS
- Fixed hotkeys not working on OGA
- Fixed ROMS on external HDD might not mount on boot
- Fixed snapshot manager (read important note)
A bug that was causing ES to lag on scrolling was fixed, but there has been a change on how ROM settings are saved, if you previously saved emuoptions.conf in a backup, you need to merge it with emuelec.conf.
After setting the gamepad in ES it will be automatically be added to the gamecontrollerdb.txt file making them work on all SDL2 programs that support it, including PPSSPPSDL.
Important note: To properly support the new snapshot (savestate) manager, save states are now saved/loaded from /storage/roms/savestates/[system] (example: /storage/roms/savestates/nes/)
- Add DOSBox scan script (#292) - Easier way to add DOSBox games (untested)
- Use GCC optim -O3 system-wide - Squeeze a bit more performance on some cases
- OdroidGoAdvance: use internal terminal to display error - Uses proper rotation and error message will properly close!
- Emulationstation: bump to 4416716
- S922x/A311D: Use a service to handle small cores - Fixes the reboot issue
- Add pcenginecd to bios check
- Add .mdf for Sega Saturn (#288)
- Odroid Go Advance: Enable rs97-commander-sdl2 (not yet properly implemented)
- VLC: bump to 3.0.11.1
- Fix MSX2 platform for scrapping
- Retroarch: Added some default core settings
- Amlogic-ng: Goodbye libhybris! - Use proper GLES headers, this fixes some gfx errors on some cores, like Mupen64
- Fix ports show error even on gracious exit
- SDLPoP: Fix settings not being saved
- Mupen64plus-nx: Use Gles3 for OdroidGoAdvance fixes #260
- emuelec-utils: Unify some small scripts for easy management
- Bios check will now be performed AFTER and ONLY if a game crashes
- OdroidGoAdvance: Added vertical mode for some cores (mostly arcade cores)
- Added a timezone selection to make it easier to set your current time
- S922x: Disabled small cores for a little performance boost
- Remove some unused cores for space ---beetle-lynx ---crocods ---dosbox-x (still available on aarch64) ---easyrpg ---xow ---libretro-bash-launcher They can be brought back if demand exists
- re-add ssv6xxx-aml: fixes #261 (hopefully)
- Bumped Retroarch
- Many other small under the hood fixes
Happy retrogaming!
- advmame: Another attempt at auto config joysticks that should work on
- Parallel64: bump to 76193f8
- fbterm.sh: add "error" to display a dialog box with an error for 10 secs
- emuelec-emulationstation: Bump to 7a19660
- emustation-config: make sure the BT agent is not running (this one is important)
- Add sanity checks when launching Cave Story (#218)
- missing-bios: add --filter
- updatecheck.sh: Add forceupdate test
For a more in depth list of changes check https://github.com/EmuELEC/EmuELEC/commits/dev
- Added NEC PC-9800 to es_systems.cfg
- Ports: Include OpenTyrian, HodeSDL, Bermuda but only OpenTyrian has a launch script, as soon as I test the others I will add the launch script
- Added a missing core "Quicknes"
- OdroidGoAdvance: Enable 3do and Saturn, I have no idea why people want to play these systems on the OGA, but by popular demand, here they are.
- Fix/improve Bluetooth pairing
- Enable auto-updates: This will be hard to test as they are only available for stable releases, still not sure if I should enable them for beta/test releases
- Bluetooth: Try to pair gamepads at boot, to make this work you need to set your game-pad in pairing mode when EmuELEC is booting
- Initial Bluetooth management menu (#209) under setup scripts you will find a new menu driven Bluetooth pairing method, by coach1988, very useful if the regular method does not work for you.
- YouTube search: Add default search word to ES. under the EmuELEC settings menu there is a new option to set the default word to search, in case you don't have a keyboard this can be used, not idea, but it works
- Remove tiggerhappy, was planing on using it but never got to, so it was just wasting space
- ES can now show PDF manuals from games. set_advmame_joy.sh: force button "a" as "ui_select"
This test includes many new features some of them that will require a bit of setting up if you are upgrading. The biggest change is that the getcores.sh file that was responsible for showing what emulators was used for what platform is no longer in use, this means that emuelec.conf and emuoptions.conf from earlier versions will no longer will compatible (well only the core/emulator part) so if you previously had set some games to run on certain emulators this needs to be redone.
It is always suggested to do a new install for tests releases and this is required before you report a bug/issue.
- New ES grouping by manufacturer, if you press B on the main screen of ES you will now get a group selection that will quick jump you to that manufacturer and all of its platforms.
- Added netplay to ES, although I tested it as much as I could it was a hit and miss, but I assume this is just how it works
- Fixed retro-achievements (cheevos)
- Bumped PPSSPPSDL to 1.10
- Many small fixes are also included.
- OdroidGoAdvance: Add support for V1.1 with extra buttons and WiFi module, buttons might have changed a bit, taking suggestions on how to best set them up!
- Fixed AdvanceMame gamepad auto-configuration, a new option to enable/disable this has been set in the Main Menu - EmuELEC Settings
- Removed steam controller support, I don't think anyone was using it and it was just eating resources, if many people ask for it I will enable it again.
- Added small youtube search engine (needs a keyboard) for now its included in the Setup menu script #14
- Mplayer: Added support for .twi and .ytb files, if you include a file with a twitch or youtube address it will be played by mplayer (need internet)
- OdroidGoAdvance: Use upstream PPSSPPSDL instead of PPSSPPSDL-GO, there might be gamepad issues (NOT PROPERLY TESTED YET!)
- Bumped many emulators to latest versions (NOT PROPERLY TESTED YET!)
- Small script cleanups and bug fixes.
WARNING: Force copy of es_systems.cfg, when changes are made upstream to es_systems.cfg the update does not copy the new file, this version fixes that.
This will REPLACE the es_systems.cfg file if you manually changed this file those changes will need to be redone, sorry can't seem to find a better way yet.
For older release information read CHANGELOG.md