Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/ruffle-rs/ruffle

A Flash Player emulator written in Rust
https://github.com/ruffle-rs/ruffle

emulator flash hacktoberfest reimplementation rust swf

Last synced: about 1 month ago
JSON representation

A Flash Player emulator written in Rust

Lists

README 

        


  Ruffle





  Rust Build Status

  Web Build Status

  Ruffle npm

  Ruffle AUR

  Ruffle Discord

  Ruffle translations

  


  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.



## Table of Contents

* [Project Status](#project-status)

* [Using Ruffle](#using-ruffle)

* [Building from source](#building-from-source)

  * [Desktop](#desktop)

  * [Ubuntu](#ubuntu)

* [Homebrew](#homebrew)

  * [Web or Extension](#web-or-extension)

  * [Scanner](#scanner)

  * [Exporter](#exporter)

* [Structure](#structure)

* [Sponsors](#sponsors)

* [License](#license)

* [Contributing](#contributing)



## Project status



Ruffle supports ActionScript 1, 2 and 3 pretty well, but it's still not finished by any means. Please report any issues in the [Issue Tracker](https://github.com/ruffle-rs/ruffle/issues).



## Using Ruffle



The easiest way to try out Ruffle is to visit the [web demo page](https://ruffle.rs/demo/), then click the "Browse..." button to load an SWF file of your choice.



[Nightly builds](https://ruffle.rs/#releases) of Ruffle are available for desktop and web platforms including the browser extension.



For more detailed instructions, see our [wiki page](https://github.com/ruffle-rs/ruffle/wiki/Using-Ruffle).



## Building from source



[Follow the official guide](https://www.rust-lang.org/tools/install) 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](https://github.com/ruffle-rs/homebrew-ruffle/):



`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](web/README.md#building-from-source) for building

either the web or browser extension version of Ruffle.



This project is tested with BrowserStack.



### 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`](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](https://github.com/sponsors/ruffle-rs). 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

  

  

    Bubble Shooter

  

  

    Neopets

  




## License



Ruffle is licensed under either of



- Apache License, Version 2.0 (http://www.apache.org/licenses/LICENSE-2.0)

- MIT License (http://opensource.org/licenses/MIT)



at your option.



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



### Contributing



Ruffle welcomes contribution from everyone. See [CONTRIBUTING.md](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](https://www.rust-lang.org/policies/code-of-conduct) that the Rust project itself follows.