[![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)

> [!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

***PSP is not yet supported***. Some of y'all may have seen that I pushed a "beta" ppsspp core, but this core is not ready for daily use. It still crashes randomly and any games that use 3d (so like, all of them) will just have a white screen (and might just crash). Do not open issues related to the "psp" core. [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]: docs/Systems/Nintendo%20Game%20Boy%20Advance.md [Nintendo Game Boy]: docs/Systems/Nintendo%20Game%20Boy.md [Nintendo 64]: docs/Systems/Nintendo%2064.md [Nintendo DS]: docs/Systems/Nintendo%20DS.md [Sega Master System]: docs/Systems/Sega%20Master%20System.md [Sega Mega Drive]: docs/Systems/Sega%20Mega%20Drive.md [Sega Game Gear]: docs/Systems/Sega%20Game%20Gear.md [Sega Saturn]: docs/Systems/Sega%20Saturn.md [Sega 32X]: docs/Systems/Sega%2032X.md [Sega CD]: docs/Systems/Sega%20CD.md [Atari Jaguar]: docs/Systems/Atari%20Jaguar.md [Atari Lynx]: docs/Systems/Atari%20Lynx.md [Atari 7800]: docs/Systems/Atari%207800.md [Atari 2600]: docs/Systems/Atari%202600.md [Atari 5200]: docs/Systems/Atari%205200.md [NES / Famicom]: docs/Systems/NES-Famicom.md [SNES]: docs/Systems/SNES.md [TurboGrafs-16 / PC Engine]: docs/Systems/TurboGrafs%2016-PC%20Engine.md [WanderSwan / Color]: docs/Systems/WanderSwan-Color.md [Neo Geo Poket]: docs/Systems/Neo%20Geo%20Poket.md [PlayStation]: docs/Systems/PlayStation.md [Virtual Boy]: docs/Systems/Virtual%20Boy.md [Arcade]: docs/Systems/Arcade.md [MSX]: docs/Systems/MSX.md [3DO]: docs/Systems/3DO.md [MAME 2003]: docs/Systems/MAME%202003.md [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