Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/EmulatorJS/EmulatorJS

A web-based frontend for RetroArch
https://github.com/EmulatorJS/EmulatorJS

atari-lynx atari2600 atari7800 ds emulation emulator emulatorjs gameboy n64 nes nintendo nintendo-game-boy playstation retroarch retroarch-wasm sega-cd sega-mega-drive sega-saturn snes virtualboy

Last synced: about 1 month ago
JSON representation

A web-based frontend for RetroArch

Awesome Lists containing this project

README 

        







 

 








[![Badge License]][License]

    

    

Self-hosted **Javascript** emulation for various system.







[![Button Website]][Website] 

[![Button Usage]][Usage]


[![Button Configurator]][Configurator]


[![Button Demo]][Demo] 

[![Button Legacy]][Legacy]

    

[![Button Contributors]][Contributors]   

 

Join our Discord server:



[![Join our Discord server!](https://invidget.switchblade.xyz/6akryGkETU)](https://discord.gg/6akryGkETU)



Or the Matrix server (#emulatorjs:matrix.emulatorjs.org):



Chat on Matrix










> [!NOTE]  

> **As of EmulatorJS version 4.0, this project is no longer a reverse-engineered version of the emulatorjs.com project. It is now a complete re-write.**



> [!WARNING]  

> As of version 4.0.9 cores and minified files are no longer included in the repository. You will need to get them separately. You can get the from [releases](https://github.com/EmulatorJS/EmulatorJS/releases) or the * new CDN (see [this](#CDN) for more info). There is also a new version system that we will be using. (read [here](#Versioning) for more info).

>

> The history of the project has been rewritten and force pushed. You will likely need to redo any active commits you have. Sorry for the inconvenience.



> [!TIP]

> Cloning the repository is no longer recommended for production use. You should use [releases](https://github.com/EmulatorJS/EmulatorJS/releases) or the [CDN](https://cdn.emulatorjs.org/) instead.







### Ads



*This project has no ads.* 


*Although, the demo page currently has an ad to help fund this project.* 


*Ads on the demo page may come and go depending on how many people are* 


*funding this project.* 



*You can help fund this project on* ***[patreon]***







### Issues



*If something doesn't work, please consider opening an* ***[Issue]*** 


*with as many details as possible, as well as the console log.*







### Versioning

There are 3 different version name that you need to be aware of:

1. **stable** - This will be the most stable version of the emulator both code and cores will be tested before release. It will be updated every time a new version is released on GitHub. This is the default version on the Demo.

2. **latest** - This will contain the latest code but use the stable cores. This will be updated every time the *main* branch is updated.

3. **nightly** - This will contain the latest code and the latest cores. The cores will be updated every day, so this is consiterd alpha.



### CDN

There is a new CDN that you can use to get any version of the emulator. The cdn is `https://cdn.emulatorjs.org/`. You can use this to get the stable, latest, nightly and any other main version by setting your `EJS_pathtodata` to `https://cdn.emulatorjs.org//data/`.



### Extensions



 **[GameLibrary]**



   *A library overview for your **ROM** folder.*







### Development:



*Run a local server with:* 

```

npm i

npm start

```







**>> When reporting bugs, please specify that you are using the old version**













Supported Systems










### Nintendo



**[Game Boy Advance][Nintendo Game Boy Advance]**   | 

**[Famicom / NES][NES / Famicom]**   | 

**[Virtual Boy][Virtual Boy]**

    

**[Game Boy][Nintendo Game Boy]**   | 

**[SNES]**   | 

**[DS][Nintendo DS]**   | 

**[64][Nintendo 64]**










### Sega



**[Master System][Sega Master System]**   | 

**[Mega Drive][Sega Mega Drive]**   | 

**[Game Gear][Sega Game Gear]**

    

**[Saturn][Sega Saturn]**   | 

**[32X][Sega 32X]**   | 

**[CD][Sega CD]**

    








### Atari



**[2600][Atari 2600]**   | 

**[5200][Atari 5200]**   | 

**[7800][Atari 7800]**   | 

**[Lynx][Atari Lynx]**   | 

**[Jaguar][Atari Jaguar]**










### Other

    

**[PlayStation]**   | 

**[Arcade]**   | 

**[3DO]**   | 

**[MAME 2003]**

    








[License]: LICENSE

[Issue]: https://github.com/ethanaobrien/emulatorjs/issues

[patreon]: https://patreon.com/EmulatorJS



[GameLibrary]: https://github.com/Ramaerel/emulatorjs-GameLibrary



[Configurator]: https://emulatorjs.org/editor.html

[Contributors]: docs/Contributors.md

[Website]: https://emulatorjs.org/

[Legacy]: https://coldcast.org/games/1/Super-Mario-Bros

[Usage]: https://emulatorjs.org/docs/

[Demo]: https://demo.emulatorjs.org/



[Nintendo Game Boy Advance]: https://emulatorjs.org/systems/Nintendo%20Game%20Boy%20Advance

[Nintendo Game Boy]: https://emulatorjs.org/systems/Nintendo%20Game%20Boy

[Nintendo 64]: https://emulatorjs.org/systems/Nintendo%2064

[Nintendo DS]: https://emulatorjs.org/systems/Nintendo%20DS



[Sega Master System]: https://emulatorjs.org/systems/Sega%20Master%20System

[Sega Mega Drive]: https://emulatorjs.org/systems/Sega%20Mega%20Drive

[Sega Game Gear]: https://emulatorjs.org/systems/Sega%20Game%20Gear

[Sega Saturn]: https://emulatorjs.org/systems/Sega%20Saturn

[Sega 32X]: https://emulatorjs.org/systems/Sega%2032X

[Sega CD]: https://emulatorjs.org/systems/Sega%20CD



[Atari Jaguar]: https://emulatorjs.org/systems/Atari%20Jaguar

[Atari Lynx]: https://emulatorjs.org/systems/Atari%20Lynx

[Atari 7800]: https://emulatorjs.org/systems/Atari%207800

[Atari 2600]: https://emulatorjs.org/systems/Atari%202600

[Atari 5200]: https://emulatorjs.org/systems/Atari%205200



[NES / Famicom]: https://emulatorjs.org/systems/NES-Famicom

[SNES]: https://emulatorjs.org/systems/SNES



[TurboGrafs-16 / PC Engine]: https://emulatorjs.org/systems/TurboGrafx-16

[WanderSwan / Color]: https://emulatorjs.org/systems/WonderSwan

[Neo Geo Poket]: https://emulatorjs.org/systems/Neo%20Geo%20Pocket

[PlayStation]: https://emulatorjs.org/systems/PlayStation

[Virtual Boy]: https://emulatorjs.org/systems/Virtual%20Boy

[Arcade]: https://emulatorjs.org/systems/Arcade

[MSX]: https://emulatorjs.org/systems/MSX

[3DO]: https://emulatorjs.org/systems/3DO

[MAME 2003]: https://emulatorjs.org/systems/MAME%202003



[Badge License]: https://img.shields.io/badge/License-GPLv3-blue.svg?style=for-the-badge



[Button Configurator]: https://img.shields.io/badge/Configurator-992cb3?style=for-the-badge

[Button Contributors]: https://img.shields.io/badge/Contributors-54b7dd?style=for-the-badge

[Button Website]: https://img.shields.io/badge/Website-736e9b?style=for-the-badge

[Button Legacy]: https://img.shields.io/badge/Legacy-ab910b?style=for-the-badge

[Button Usage]: https://img.shields.io/badge/Usage-2478b5?style=for-the-badge

[Button Demo]: https://img.shields.io/badge/Demo-528116?style=for-the-badge

[Button Beta]: https://img.shields.io/badge/Beta-bb044f?style=for-the-badge