A Flash Player emulator written in Rust https://ruffle.rs
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
Go to file
David Wendt cfa259fe57
chore: Reproducible archive should include the whole project, not just the web subdir
19 hours ago
.cargo chore: Add a note to cargo config about RUSTFLAGS in the web build 9 months ago
.github chore: Reproducible archive should include the whole project, not just the web subdir 19 hours ago
core core: Display class name in ErrorObject debug impl 4 days ago
desktop fix(deps): update rust crate webbrowser to 0.8.6 2 days ago
exporter fix(deps): update rust dependencies 4 days ago
render tests: Move tests away from giant macro to individual test.toml files that describe the test 1 day ago
scanner fix(deps): update rust dependencies 4 days ago
swf swf: Accept Scaleform GFx header signatures 2 weeks ago
tests tests: Move tests away from giant macro to individual test.toml files that describe the test 1 day ago
video video: Remove unnecessary clone of `frame.rgba` 2 weeks ago
web web: Add key code for NumpadEnter 4 days ago
wstr chore: Inherit cargo metadata from workspace 1 month ago
.gitattributes chore: Cleanup .gitattributes 2 years ago
.gitignore chore: Cleanup .gitignore 2 years ago
CODE_OF_CONDUCT.md chore: Update CODE_OF_CONDUCT.md 2 years ago
CONTRIBUTING.md docs: Minor updates (#7264) 7 months ago
Cargo.lock tests: Move tests away from giant macro to individual test.toml files that describe the test 1 day ago
Cargo.toml Update wgpu 5 days ago
LICENSE.md chore: Add symphonia attribution in LICENSE.md 1 month ago
PKGBUILD ci: Update PKGBUILD for AUR package 2 years ago
README.md docs: Update badge URLs in README 1 month ago
renovate.json deps: Ignore tracing-tracy for now, it needs to match whatever wgpu uses 3 weeks ago
rustfmt.toml chore: Add rustfmt.toml and rustfmt pass 3 years ago

README.md

Ruffle

Rust Build Status Web Build Status Ruffle npm Ruffle AUR Ruffle Discord
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 and games. Basic ActionScript 1.0/2.0 support is in place and improving; ActionScript 3.0 support is forthcoming. For more info, read the project roadmap.

Using Ruffle

The easiest way to try out Ruffle is to visit the web demo page, then click the "Browse..." button to load an SWF file of your choice.

Nightly builds of Ruffle are available for desktop and web platforms including the browser extension.

For more detailed instructions, see our wiki page.

Building from source

Follow the official guide to install Rust for your platform.

You must also have Java installed, and available on your PATH as java.

Desktop

If you are building for a Linux platform, the following are typical dependencies:

Ubuntu

  • libasound2-dev
  • libxcb-shape0-dev
  • libxcb-xfixes0-dev
  • libgtk-3-dev
  • libssl-dev
  • libxcb-xinput-dev
  • libxcb-xkb-dev
  • libxcb-cursor-dev
  • default-jre-headless
  • cmake
  • g++

Use the following command to build and run the desktop app:

cargo run --release --package=ruffle_desktop

To run a specific SWF file, pass the SWF path as an argument:

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

To build in debug mode, simply omit --release from the command.

Homebrew

Ruffle Desktop can be built from our Homebrew Tap:

brew install --HEAD ruffle-rs/ruffle/ruffle

Note: because it is HEAD-only, you'll need to run brew upgrade --fetch-HEAD ruffle each time you want to update.

Web or Extension

Follow the instructions in the web directory for building either the web or browser extension version of Ruffle.

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 --release --package=ruffle_scanner -- folder/with/swfs/ results.csv

Exporter

If you have a swf and would like to capture an image of it, you may use the exporter tool. This currently requires hardware acceleration, but can be run headless (with no window).

  • cargo run --release --package=exporter -- path/to/file.swf
  • cargo run --release --package=exporter -- path/to/file.swf path/to/screenshots --frames 5

Structure

  • core contains the core emulator and common code
  • desktop contains the desktop client (uses wgpu-rs)
  • web contains the web client and browser extension (uses wasm-bindgen)
  • scanner contains a utility to bulk parse swf files
  • exporter contains a utility to generate PNG screenshots of a swf file

Sponsors

You can support the development of Ruffle via GitHub Sponsors. Your sponsorship will help to ensure the accessibility of Flash content for the future. Thank you!

Sincere thanks to the diamond level sponsors of Ruffle:

Newgrounds.com CPMStar Sébastien Bénard Crazy Games Cool Math Games The New York Times Armor Games Onda Educa TwoPlayerGames.org wowgame.jp Matt Roszak Doll Divine Movavi Kongregate

License

Ruffle is licensed under either of

at your option.

Ruffle depends on third-party libraries under compatible licenses. See LICENSE.md for full information.

Contribution

Ruffle welcomes contribution from everyone. See CONTRIBUTING.md for help getting started.

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.

The entire Ruffle community, including the chat room and GitHub project, is expected to abide by the Code of Conduct that the Rust project itself follows.