Skip to content
<open-source>
Oeiuwq Faith Blog OpenSource Porfolio

EmulatorJS/EmulatorJS

A web-based frontend for RetroArch
Source code at GitHub https://emulatorjs.org
EmulatorJS/EmulatorJS.json
{
  "createdAt": "2021-04-05T19:53:25Z",
  "defaultBranch": "main",
  "description": "A web-based frontend for RetroArch",
  "fullName": "EmulatorJS/EmulatorJS",
  "homepage": "https://emulatorjs.org",
  "language": "JavaScript",
  "name": "EmulatorJS",
  "pushedAt": "2026-06-05T17:08:06Z",
  "stargazersCount": 3876,
  "topics": [
    "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"
  ],
  "updatedAt": "2026-06-05T18:39:00Z",
  "url": "https://github.com/EmulatorJS/EmulatorJS"
}
EmulatorJS Dark Mode Logo EmulatorJS Light Mode Logo

Self-hosted JavaScript emulation for various systems.

[![License: GPLv3][Badge License]][Link License] [![Website][Badge Website]][Link Website] [![Usage Docs][Badge Usage]][Link Usage] [![Configurator][Badge Configurator]][Link Configurator] [![Live Demo][Badge Demo]][Link Demo] [![Contributors][Badge Contributors]][Link Contributors]

Join our Discord server:

Discord Badge

Getting Started

Section titled “Getting Started”

Supported Systems

Section titled “Supported Systems”

EmulatorJS supports a wide variety of legacy consoles and arcade machines. For the complete list of supported cores, please visit our Cores Documentation.

Versioning Guide

Section titled “Versioning Guide”

We use a specific versioning system to help you choose the right build for your needs:

  1. Stable - The most current release. Both code and cores are tested before release. Updated when new versions are released on GitHub. This is the default version on the Demo.
  2. Latest - Contains the latest code but uses stable cores. Updated whenever the main branch is updated. This version will often be more broken than nightly
  3. Nightly - Contains the latest code and the latest cores. Cores are updated daily. This version is not recommended for production use as it is the main development branch.

CDN Integration

Section titled “CDN Integration”

EmulatorJS provides a public CDN at https://cdn.emulatorjs.org/. You can access any version by setting the data path and loader.js accordingly.

// Example Configuration
const EJS_pathToData = 'https://cdn.emulatorjs.org/<version>/data/';
// Replace <version> with: stable, latest, nightly, etc.

Development

Section titled “Development”

To run the project locally for development:

  1. Open a terminal in the root directory.
  2. Install dependencies:
    Terminal window
    npm i
  3. Start the server/minification:
    Terminal window
    npm run start
  4. Open http://localhost:8080/ to view the demo.

Note: Minify your script files before deploying to a production server to optimize load times and bandwidth. See [Minification Docs]!(minify/README.md).

Community & Support

Section titled “Community & Support”

3rd Party Integrations

Section titled “3rd Party Integrations”

EmulatorJS is built as a library/plugin, not a standalone website (therefore, no Docker container). For projects that utilize EmulatorJS, check out our 3rd Party Integration List.

Issues & Reporting

Section titled “Issues & Reporting”

If you encounter an issue, please open an Issue on GitHub. Include as many details as possible, including your browser console logs.

When reporting bugs, please specify the version you are using (Stable/Latest/Nightly).

Support the Project

Section titled “Support the Project”

This project is free and ad-free. The demo page may show occasional ads to help with hosting costs, but you can support development directly via [Patreon][Link Patreon].

Star History

Section titled “Star History”
Star History Chart

[Badge License] !: https://img.shields.io/badge/License-GPLv3-blue.svg?style=for-the-badge&logo=opensourceinitiative [Badge Website] !: https://img.shields.io/badge/Website-736e9b?style=for-the-badge [Badge Usage] !: https://img.shields.io/badge/Usage-2478b5?style=for-the-badge [Badge Configurator] !: https://img.shields.io/badge/Config-992cb3?style=for-the-badge [Badge Demo] !: https://img.shields.io/badge/Demo-528116?style=for-the-badge [Badge Contributors] !: https://img.shields.io/badge/Contributors-54b7dd?style=for-the-badge [Discord Badge] !: https://invidget.switchblade.xyz/6akryGkETU

[Link License] !: LICENSE [Link Website] !: https://emulatorjs.org/ [Link Usage] !: https://emulatorjs.org/docs/ [Link Configurator] !: https://emulatorjs.org/editor [Link Demo] !: https://demo.emulatorjs.org/ [Link Contributors] !: docs/contributors.md [Link Issue] !: https://github.com/emulatorjs/emulatorjs/issues [Link Patreon] !: https://patreon.com/EmulatorJS