README.md
February 26, 2025 · View on GitHub
Immersive Web Emulator 2.0
The Immersive Web Emulator (IWE) is a browser extension that injects a WebXR runtime into web pages, enabling full WebXR emulation on desktop, Chromium-based browsers.
Powered by the Immersive Web Emulation Runtime, IWE offers a comprehensive WebXR runtime that polyfills or overrides existing WebXR APIs. It includes the Synthetic Environment Module (@iwer/sem) for mixed reality emulation capabilities and the DevUI (@iwer/devui) for an intuitive developer interface overlay.

Supported Features
IWE supports most mainstream WebXR features and APIs, offering compatibility on par with the WebXR support in the Meta Quest Browser.
Installation
This extension is built on the WebExtensions API and implements Manifest V3. It is compatible with Chrome, Microsoft Edge, and other browsers supporting the API. You can install the Immersive Web Emulator from the following browser extension stores:
Manual Installation
For other Chromium-based browsers, you can manually install the extension by following these steps:
- Download the latest release here, unpack it, and note the unpacked directory.
- Open the Extensions page in your browser, typically found in the browser menu, or navigate to
chrome://extensionsin the URL bar if using a Chromium-based browser. - Enable Developer mode on the Extensions page.
- Click on the Load unpacked button and select the unpacked directory from step 1.
Note: The process may vary for different browsers.
Non-Chromium Browsers
At this time, IWE is not supported on non-Chromium-based browsers. However, you can integrate IWER directly into your app by following this guide to achieve the same experience on any modern browser of your choosing.
Alternatively, use one of the frameworks with IWER already built-in:
License
IWER is licensed under the MIT License. For more details, see the LICENSE file in this repository.
Contributing
Your contributions are welcome! Please feel free to submit issues and pull requests. Before contributing, make sure to review our Contributing Guidelines and Code of Conduct.