ruffle README

The project's README from github.com/ruffle-rs/ruffle. As one markdown file: README.md.

Ruffle

Rust Build Status Web Build Status Ruffle Discord Ruffle translations
Firefox Extension Chrome Extension Ruffle Flathub Ruffle npm Ruffle AUR
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 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.

Using Ruffle

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

Nightly builds of Ruffle are available for desktop and web platforms.

For more detailed instructions, see our wiki page.

Building from source

Prerequisites

Linux prerequisites

The following are typical dependencies for Linux:

Desktop

Build

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.

Desktop has a few optional features which you can specify via --features, comma separated:

macOS

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.

This project is tested with BrowserStack.

Android

Follow the instructions in the ruffle-android project for building the Android application 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 -- scan folder/with/swfs/ results.csv

Exporter

If you have a SWF file 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).

Structure

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 Bubble Shooter Neopets

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.

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.

ruffle (ruffle-rs/ruffle)

Searching Database…

18.7K ·GitHub
Ruffle
这是什么？Ruffle 是一个用 Rust 编写的 Adobe Flash Player 模拟器。它让 Flash 内容在桌面和网页上重新焕发生机，浏览器端使用 WebAssembly 实现。
它是一个软件还是好几个——我实际能在哪里运行它？一个模拟器，带有多个前端：桌面客户端、用 wasm-bindgen 构建的网页客户端、浏览器扩展，还有安卓应用。底层共享同一个模拟器核心。
我手头有个 Flash 文件，怎么试玩它？访问网页演示页面，点击“选择文件”（Select File）加载任意 SWF 文件——这是最简单的方式。日常使用的话，桌面和网页平台都有 nightly 构建版本可供下载。
我以前那些 Flash 游戏和动画都能直接运行吗？还不全部都能。ActionScript 1、2 和 3 支持“相当不错”，但 README 明确说明模拟器仍未完成，并请用户在 Issue Tracker 中报告问题。
它是免费的吗？我能在自己的项目里用吗？它是免费开源的，采用 Apache 2.0 或 MIT 双许可证，你可以任选其一，第三方依赖也都使用兼容的许可证。开发经费通过 GitHub Sponsors 赞助。
SWF 文件到底是什么？SWF 是 Flash 内容所使用的文件格式——游戏、动画和应用都以它发布。Ruffle 的核心组件之一就是专门的 SWF 和 ActionScript 解析器。
它也能播放 Flash 视频（FLV）吗？可以——代码库中包含视频解码后端和一个专门的 Flash 视频（FLV）解码器，所以除了游戏和动画，视频内容也在支持范围内。
怎么运行原生桌面应用？用 cargo 构建并运行：cargo run --release --package=ruffledesktop，传入 SWF 文件路径即可直接打开。在 macOS 上也可以通过项目的 Homebrew tap 安装：brew install --HEAD ruffle-rs/ruffle/ruffle。
我能批量测试一整个 SWF 文件集或给它们截图吗？可以，有两个辅助工具能做这件事：scanner 工具解析文件夹中的大量真实 SWF 文件，并把解析结果写入 CSV；exporter 工具为 SWF 截取 PNG 截图（可用 --frames 5 截取多帧）。exporter 需要硬件加速，但可以无界面（headless）运行。
What are similar projects?effectcraft, ps2-web-recomp, wgpu, egui, video_vip, soundcraft, RetroArch, lightcraft
Which topics is it in?emulator, rendering, browser-extension, wasm, video, browser, hacktoberfest, desktop, rust, android, free, desktop-app
Creator
ruffle-rs
Size
178.4 MB
Stars
18.7K
Updated
CommitOct 17Releasev0.7.1Oct 07
Age
7y
Commits · 90 Days