A Flash Player emulator written in Rust

Go to file

Nathan Adams 03713f32e9 Correct fla for object_prototypes		2019-11-27 20:46:09 +01:00
.circleci	ci: Tweak extension build script	2019-11-25 17:00:29 -08:00
core	Correct fla for object_prototypes	2019-11-27 20:46:09 +01:00
desktop	build(deps): bump structopt from 0.3.4 to 0.3.5	2019-11-25 10:53:04 +00:00
scanner	build(deps): bump structopt from 0.3.4 to 0.3.5	2019-11-25 10:53:04 +00:00
swf	build(deps): bump num-derive from 0.2.5 to 0.3.0	2019-11-22 17:13:32 +00:00
web	web: Default demo build to production mode	2019-11-25 17:00:29 -08: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 num-traits from 0.2.9 to 0.2.10	2019-11-25 11:13:02 +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.