ruffle/web/packages/extension
Mike Welsh c2b768c453 web: Fallback to instantiate with improper MIME type
Use --target web in wasm-bindgen and file-loader for WASM files,
allowing wasm-bindgen's built-in fallback from
WebAssembly.instantiateStreaming to instantiate.

file-loader spits out the WASM file directly in the output folder,
and imports will resolve to the URL, so that we can load the file
directly, avoiding webpack's built-in wasm loaders.

This allows Ruffle to function on web servers even if they serve
WASM files with the incorrect MIME type, fixing one of our biggest
support requests (#400, #1458). There is some performance impact
on loading with the fallback, but this is preferable to not
working at all.
2021-01-16 15:30:11 -08:00
..
build web: Rename `settings.htm` to `settings.html` 2021-01-04 12:23:25 -08:00
js web: Rename `settings.htm` to `settings.html` 2021-01-04 12:23:25 -08:00
tools Move firefox-specific setting to build_firefox.js 2020-07-29 17:06:51 -07:00
.eslintrc.json web: Run eslint 2020-12-17 12:48:32 -08:00
LICENSE_APACHE chore: Copy LICENSE* to relevant places where package managers complain if they don't exist, and make sure they're included in distributions 2020-05-27 00:11:02 -07:00
LICENSE_MIT chore: Copy LICENSE* to relevant places where package managers complain if they don't exist, and make sure they're included in distributions 2020-05-27 00:11:02 -07:00
README.md web: Build firefox extension and sign it when possible 2020-05-28 09:20:10 -07:00
manifest.json web: Rename `settings.htm` to `settings.html` 2021-01-04 12:23:25 -08:00
package.json web: Fallback to instantiate with improper MIME type 2021-01-16 15:30:11 -08:00
webpack.config.js web: Fallback to instantiate with improper MIME type 2021-01-16 15:30:11 -08:00

README.md

ruffle-extension

ruffle-extension is all of the power of Ruffle, in your browser.

Without needing websites to do anything, the browser extension will automatically replace any Flash content on websites with the Ruffle player.

The extension will automatically negotiate with websites that do have Ruffle installed, to ensure that there is no conflict between the versions. Newer version of ruffle, either from the website or extension, will always take precedence and disable the other.

Using ruffle-extension

The browser extension is built to work in both Chrome and Firefox.

We do not yet have a signed release of the extension, so you must load it as a temporary extension.

Before you can install the extension, you must either download the latest build or build it yourself.

Chrome

  • Unpack dist/ruffle_extension.zip somewhere
  • Navigate to chrome://extensions/
  • Turn on Developer mode in the top right corner.
  • Click Load unpacked.
  • Select the folder you unpacked the extension to.

Firefox

  • Navigate to about:debugging.
  • Click on This Firefox.
  • Click Load Temporary Add-on...
  • Select the .xpi from the dist folder.

Building, testing or contributing

Please see the ruffle-web README.