A Flash Player emulator written in Rust

Go to file

David Wendt dd4462c104 Warn when attempting to attach a second continuation onto an existing stack frame, since we don't support that use case.		2019-11-20 14:30:31 -05:00
.circleci	ci: Fix incorrect job name	2019-11-19 10:33:18 -08:00
core	Warn when attempting to attach a second continuation onto an existing stack frame, since we don't support that use case.	2019-11-20 14:30:31 -05:00
desktop	build(deps): bump structopt from 0.2.18 to 0.3.4	2019-11-20 19:01:18 +00:00
scanner	build(deps): bump structopt from 0.2.18 to 0.3.4	2019-11-20 19:01:18 +00:00
swf	swf: Store register count from DefineFunction2	2019-10-15 17:09:14 -07:00
web	build(deps): bump svg from 0.5.12 to 0.6.0	2019-11-20 18:38:58 +00:00
.gitattributes	chore: Add gitattributes to normalize line endings	2019-10-11 16:53:36 -07:00
.gitignore	chore: Add Cargo.lock	2019-11-17 17:36:21 -05:00
CONTRIBUTING.md	chore: Renormalize line endings in misc files	2019-10-11 16:53:36 -07:00
Cargo.lock	build(deps): bump structopt from 0.2.18 to 0.3.4	2019-11-20 19:01:18 +00:00
Cargo.toml	Added a bulk swf scanning tool	2019-10-11 16:37:15 -07:00
LICENSE_APACHE	Initial commit	2019-04-25 10:52:22 -07:00
LICENSE_MIT	Initial commit	2019-04-25 10:52:22 -07:00
README.md	Added a bulk swf scanning tool	2019-10-11 16:37:15 -07:00
rustfmt.toml	chore: Add rustfmt.toml and rustfmt pass	2019-08-26 16:38:48 -07:00

README.md

website | demo | nightly builds | wiki

Ruffle

Ruffle is an Adobe Flash Player emulator written in the Rust programming language. Ruffle targets both the desktop and the web using WebAssembly.

Project status

Ruffle is in the proof-of-concept stage and can currently run early Flash animations. ActionScript support is still forthcoming; for more info, read the project roadmap.

Building from source

Follow the official guide to install Rust for your platform.

Desktop

cargo run --package=ruffle_desktop -- test.swf

Web

Install Node.js
Install wasm-pack

Running the web demo

cd web/demo
npm install
npm run serve
Load indicated page in browser (usually http://localhost:8080)

Building the NPM package

cd web
wasm-pack build

Scanner

If you have a collection of "real world" SWFs to test against, the scanner may be used to benchmark ruffle's parsing capabilities. Provided with a folder and an output filename, it will attempt to read all of the flash files and report on the success of such a task.

cargo run --package=ruffle_scanner -- folder/with/swfs/ results.csv

Structure

core contains the core emulator and common code
desktop contains the desktop client (uses glium)
web contains the web client (uses wasm-bindgen)
scanner contains a utility to bulk parse swf files

License

Licensed under either of

Apache License, Version 2.0 (LICENSE_APACHE or http://www.apache.org/licenses/LICENSE-2.0)
MIT license (LICENSE_MIT or http://opensource.org/licenses/MIT) at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you shall be dual licensed as above, without any additional terms or conditions.