893052c2a6
A load_error_swf function has been added to the Loader. It makes the MovieClip enter the error state in which some attributes have certain error values to signal that no valid file could be loaded. This happens if no file could be loaded or if the loaded content is no valid supported content. The function creates an error state movie stub using the new SwfMovie::error_movie function (which uses a new default_error_header function) and configures remaining variables with the movie_not_available method. One TODO in order for the error state to be completely implemented has been added. Since the error state of the MovieClip includes the final URL of the SWF file obtained after any redirects, the load_error_swf and movie_loader_error functions (now) take an swf_url attribute. To get this URL in case no file could be loaded, the NavigatorBackend::fetch method has been changed to return an ErrorResponse struct (including the url and the actual error) in the error case. The Response struct returned in the success case has been renamed to SuccessResponse. All fetch implementations have been adapted accordingly. Code has been adjusted to return the actual error where that's needed. Documentation has been added and improved. |
||
|---|---|---|
| .cargo | ||
| .github | ||
| core | ||
| desktop | ||
| exporter | ||
| flv | ||
| render | ||
| ruffle_gc_arena | ||
| scanner | ||
| swf | ||
| tests | ||
| video | ||
| web | ||
| wstr | ||
| .gitattributes | ||
| .gitignore | ||
| CODE_OF_CONDUCT.md | ||
| CONTRIBUTING.md | ||
| Cargo.lock | ||
| Cargo.toml | ||
| LICENSE.md | ||
| PKGBUILD | ||
| README.md | ||
| crowdin.yml | ||
| rustfmt.toml | ||
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.
Table of Contents
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.swfcargo run --release --package=exporter -- path/to/file.swf path/to/screenshots --frames 5
Structure
corecontains the core emulator and common codedesktopcontains the desktop client (useswgpu-rs)webcontains the web client and browser extension (useswasm-bindgen)scannercontains a utility to bulk parse swf filesexportercontains 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:
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 for full information.
Contributing
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.