A Flash Player emulator written in Rust
Go to file
dependabot-preview[bot] ef428d95a7 build(deps): bump lyon from 0.17.3 to 0.17.4
Bumps [lyon](https://github.com/nical/lyon) from 0.17.3 to 0.17.4.
- [Release notes](https://github.com/nical/lyon/releases)
- [Changelog](https://github.com/nical/lyon/blob/master/CHANGELOG.md)
- [Commits](https://github.com/nical/lyon/commits)

Signed-off-by: dependabot-preview[bot] <support@dependabot.com>
2021-01-23 19:08:26 -08:00
.dependabot chore: Check all web deps with dependabot 2020-05-19 11:42:53 +02:00
.github/workflows web: Add stylelint 2021-01-22 09:12:48 -08:00
core build(deps): bump serde from 1.0.120 to 1.0.121 2021-01-23 14:12:08 -08:00
desktop build(deps): bump lyon from 0.17.3 to 0.17.4 2021-01-23 19:08:26 -08:00
exporter build(deps): bump path-slash from 0.1.3 to 0.1.4 2021-01-18 22:33:48 -08:00
render build(deps): bump lyon from 0.17.3 to 0.17.4 2021-01-23 19:08:26 -08:00
scanner swf: Rename and organize some util methods 2021-01-20 15:02:31 -08:00
swf swf: Convert ButtonActionCondition to bitflags 2021-01-23 11:59:24 -08:00
web build(deps): bump serde from 1.0.120 to 1.0.121 2021-01-23 14:12:08 -08:00
.gitattributes chore: Mark .as files as ActionScript on github 2020-06-26 11:43:28 -07:00
.gitignore chore: Remove Flash's recovery file and add it to .gitignore 2021-01-23 00:29:25 -08:00
CODE_OF_CONDUCT.md chore: Add CODE_OF_CONDUCT.md to satisfy GitHub's "you don't have a code of conduct" 2020-09-04 14:24:12 -07:00
CONTRIBUTING.md docs: Add `tests` to list of commit prefixes 2020-12-13 15:35:37 -08:00
Cargo.lock build(deps): bump lyon from 0.17.3 to 0.17.4 2021-01-23 19:08:26 -08:00
Cargo.toml exporter: Added exporter tool for capturing images of swfs (related to #523) 2020-05-11 01:09:07 -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 desktop: Build windows binaries with crt-static 2021-01-15 12:10:12 -08:00
rustfmt.toml chore: Add rustfmt.toml and rustfmt pass 2019-08-26 16:38:48 -07:00

README.md

Ruffle

Rust Build Status Web Build Status 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.

Desktop

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

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 --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 --package=exporter -- path/to/file.swf
  • cargo run --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

License

Licensed under either of

at your option.

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.