Common questions and answers

What devices does EmuELEC run on?

A: Read Supported Devices

So how do I install it?

A: Read the small guide here

How to use roms on an external usb device?

A: Here!

What are the supported emulators/platforms?

A: Here! but please do respect the rompath name or your roms will not show up.

Why doesn't game X work?

A: There may be several reasons.

The most likely one is missing or incorrect BIOS files. When trying to start a game, EmuELEC will show you what BIOS files are MISSING or UNTESTED (a version that isn't known to work correctly). This information is also available in the Menu under Games Settings and then Missing BIOS. For legal reasons, we cannot ship these files with EmuELEC and you will have to provide them yourself.

If you do not have any warning about MISSING or UNTESTED files when starting the game, something else may be going on. Most of the time, there will be logs available. Go to Scripts / Setup and choose 08 - send logs. This will upload the logs and give you an URL that you can post on Discord. Without logs, we often won't be able to help.

How to change resolution, I get black screen or my TV is not working with your image?

A: You can easily change the resolution from the EmuELEC menu in Emulationstation if you at least can see something.

But if you don't (for example, you don't have a screen supporting 1080p), you will have to do the following:

• First, make sure the filesystem correctly resized. If you don't know, just reflash the OS onto the SD card and leave it running for about 30 minutes, it should have finished by then even on the slowest of SD cards.
• Then, turn the device off and connect the SD card to your computer.
• On the SD in the root of the EmuELEC partition edit the file named config.ini and set hdmimode. For example: hdmimode=720p60hz. Make sure to remove the # at the start of the line.
• In the storage partition, go to .config/emuelec/configs and open emuelec.conf. In here, set ee_videomode to the same value. For example: ee_videomode=720p60hz.

Another option is:
On the SD in the root of the EmuELEC partition create a file named EE_VIDEO_MODE (no extension) and inside of it you can add your resolution, example for a CRT TV: 576cvbs or 480cvbs, but usually its 1080p60hz, save the file and reboot your system, it should boot on the specified parameters.

How to Scrape Roms

A: Answer is here!

How to Add Local Videos And Images to the roms?

A: Images and video snaps should be located at rom system folder, same name as rom file and "-image" for images, "-video" for videos, so lets take snes as example.

For image we are going to create a folder inside the rom path called images(/storage/roms/snes/images) and we insert files there, so it should be "super mario-image.jpg".

For videos we create (/storage/roms/snes/videos) and add super mario-video.mp4. Easy isnt it?

Dont forget to enable local art from the Ui Settings and restart the emuelec after so it will load it.

How to play OpenBOR?

A: Answer is here!

Bluetooth ?

A: Answer is here!

I have a PS3 Gamepad and it does not work, how can I make it work?

A: Read this small guide on using PS3 gamepads on EmuELEC

I have followed the ROMS on USB media instructions, but my games still don't show up, how come?

A: Some SD cards are really fast to boot and the system does not have enough time to mount the external drive, just restart emulationstation from the quit menu and if you have the correct paths the roms should now appear.

How to play background music?

A: Background music: .mp3 or .ogg files should go into /storage/roms/BGM after than enable the "Frontend Music" on the sound settings in the main menu.

What is the SSH Password?

A: SSH user is root and the SSH password is emuelec. You can also use software like Winscp to send ROMS to your device.

PPSSPP standalone does not have any sound!

A: Go into the PPSSPP menu and in the audio section disable Switch on new audio device

My TV is always on HDR mode, how can I turn this off?

A: If your TV has no way to turn off HDR in its settings try this:

edit the file /storage/.config/autostart.sh (or ConfigFiles/autostart.sh if using samba/network shares) and add this on line 10

echo 0 > /sys/module/am_vecm/parameters/hdr_mode
echo 1 > /sys/module/am_vecm/parameters/sdr_mode

reboot and HDR should be disabled, if it still doesn't work try changing 0,1 or 2 until you find the combination that works for your TV.

What version works with my OGA clone (RK2020, RGB10, RG351P, ZPG Pro, etc)?

As mentioned here. We do not offer any kind of support for these devices. EmuELEC has nothing to do with any of them, given that they intentionally break open source licenses and copyright laws, there is no official image for those devices and there will not be one in the future, you need to ask the manufacturer for support.