https://github.com/igorlira/dirplayer-rs
A web-compatible Shockwave Player emulator written in Rust
https://github.com/igorlira/dirplayer-rs
Last synced: 5 months ago
JSON representation
A web-compatible Shockwave Player emulator written in Rust
- Host: GitHub
- URL: https://github.com/igorlira/dirplayer-rs
- Owner: igorlira
- License: gpl-3.0
- Created: 2024-04-19T01:14:19.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-10-30T16:01:05.000Z (8 months ago)
- Last Synced: 2025-10-31T08:48:40.763Z (8 months ago)
- Language: Rust
- Homepage:
- Size: 1.7 MB
- Stars: 79
- Watchers: 8
- Forks: 10
- Open Issues: 17
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- fucking-awesome-rust - DirPlayer - A web-compatible Shockwave Player emulator written in Rust (Applications / Emulators)
- awesome-rust - DirPlayer - A web-compatible Shockwave Player emulator written in Rust (Applications / Emulators)
- awesome-rust-with-stars - DirPlayer - compatible Shockwave Player emulator written in Rust | 2026-01-27 | (Applications / Emulators)
README
# DirPlayer
DirPlayer is a Shockwave Player emulator written in Rust that aims to make playing old browser games possible on modern browsers.
## Demo
Check out a live demo of this project at http://dirplayer-rs.s3-website-us-west-2.amazonaws.com/
## Chrome Extension
Download the Chrome Extension at https://chromewebstore.google.com/detail/dirplayer-shockwave-emula/gpgalkgegfekkmaknocegonkakahkhbc
The extension implements a polyfill that replaces all `` elements that point to a Shockwave file in websites you visit.
## Standalone App
Alongside the emulator, DirPlayer comes with a standalone application that provides a complete debugging toolset for Lingo scripts and Shockwave files.
Pre-built binaries can be found at https://github.com/igorlira/dirplayer-rs/releases
## Polyfill
DirPlayer can be embedded directly into any webpage as a standalone JavaScript polyfill. The polyfill is a single self-contained JS file that includes the WASM VM and all required assets.
### Usage
Automatic initialization:
```html
```
Manual initialization:
```html
DirPlayer.init();
```
The polyfill automatically detects and replaces `` and `` elements that reference Shockwave `.dcr` files.
## Requirements
- NodeJS
- [(LTS or newer)](https://nodejs.org/)
- RustLang
- [(1.70.0 or newer)](https://www.rust-lang.org/)
- wasm-pack
- https://github.com/rustwasm/wasm-pack/releases
## Building
> [!NOTE]
> Before we can start, we need to load the missing modules for NodeJS with the `npm install` command.
### 🪟 Windows
Windows users can use our scripts which are located in the [`scripts`](https://github.com/igorlira/dirplayer-rs/tree/main/scripts) folder and end with `.bat`.
- Build Rust VM with [`scripts/build-vm.bat`](https://github.com/igorlira/dirplayer-rs/blob/main/scripts/build-vm.bat)
- Build extension with [`scripts/build-extension.bat`](https://github.com/igorlira/dirplayer-rs/blob/main/scripts/build-extension.bat)
- [Further information can be found here](https://github.com/igorlira/dirplayer-rs?tab=readme-ov-file#building-extension)
- Run locally with [`scripts/run.bat`](https://github.com/igorlira/dirplayer-rs/blob/main/scripts/run.bat)
### 🐧 Other platforms
#### Building Rust VM
```bash
npm run build-vm
```
#### Building extension
```bash
npm run build-extension
```
Make sure to build the VM first. The bundled extension will be located in `./dist-extension`.
You can install the local build by going to `chrome://extensions`, enabling Developer Mode, then clicking the `Load unpacked` button.
Note that the extension is currently only available on Chrome.
#### Building standalone app
Make sure to build the VM before building the standalone app. The build will be located in `./dist`.
```bash
npm run electron-pack
```
#### Building polyfill
As above, ensure the VM is built before running this. The output will be a single file located at `./dist-polyfill/dirplayer-polyfill.js`.
```bash
npm run build-polyfill
```
#### Running locally
```bash
npm run start
```
#### Running standalone app locally
```bash
npm run electron-dev
```
## Join our Discord!
If you have any questions or you're interested in being part of the discussions of this project, please join our Discord!
https://discord.gg/8yKDk9nJH2
## Acknowledgements
This project would have not been possible without the extensive work of the Shockwave reverse engineering community.
A lot of code has been reproduced from the following projects:
https://github.com/Earthquake-Project/Format-Documentation/
https://github.com/Brian151/OpenShockwave/
https://gist.github.com/MrBrax/1f3ae06c9320863f1d7b79b988c03e60
https://www.scummvm.org/
https://github.com/csnover/earthquake-rust/
https://github.com/ProjectorRays/ProjectorRays