ruffle/web/packages/extension
dependabot[bot] 1fd6fdca60 build(deps-dev): bump @types/chrome from 0.0.166 to 0.0.174 in /web
Bumps [@types/chrome](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/HEAD/types/chrome) from 0.0.166 to 0.0.174.
- [Release notes](https://github.com/DefinitelyTyped/DefinitelyTyped/releases)
- [Commits](https://github.com/DefinitelyTyped/DefinitelyTyped/commits/HEAD/types/chrome)

---
updated-dependencies:
- dependency-name: "@types/chrome"
  dependency-type: direct:development
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
2022-01-01 22:52:56 +02:00
..
assets i18n: Add spanish tranlation for swf download option 2021-11-15 23:12:27 +02:00
src extension: Fix base for direct swf links 2021-12-15 14:00:02 -08:00
tools extension: Catch errors while signing the Firefox add-on 2021-04-16 12:31:14 -07:00
.gitignore web: Rename extension/build/ to extension/assets/ 2021-04-15 13:47:07 -07: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 docs: Update Firefox add-on instructions 2021-04-16 12:31:14 -07:00
manifest.json5 web/extension: Allow 'data:' URLs as image src - needed by the canvas backend 2021-12-12 20:43:21 +01:00
package.json build(deps-dev): bump @types/chrome from 0.0.166 to 0.0.174 in /web 2022-01-01 22:52:56 +02:00
tsconfig.json web: Indent using spaces in tsconfig.json 2021-09-15 00:42:17 +03:00
webpack.config.js web: Suppress Webpack's size limit for .wasm files 2021-12-10 22:50:45 +02: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 automatically replaces any Flash content on websites with the Ruffle player.

It automatically negotiates 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 works in Chrome, Firefox, and Safari 14+.

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

Chrome

These instructions also apply to Chromium-based browsers such as Edge, Opera and Brave.

  • Navigate to chrome://extensions/.
  • Turn on Developer mode in the top-right corner.
  • Drag and drop the *_extension.zip file into the page.

Alternatively, loading unpacked can save time during development:

  • Navigate to chrome://extensions/.
  • Turn on Developer mode in the top-right corner.
  • Click "Load unpacked".
  • Select the assets/ folder.
  • Each time after making changes, click the reload icon.

Firefox

  • Navigate to about:addons.
  • Click the gear and select "Install Add-on From File...".
  • Select the .xpi file.

Safari

  • Unzip the *_extension.zip file.
  • Run xcrun safari-web-extension-converter path/to/unzipped_folder/
  • Click "Run on Xcode".
  • Enable Safari > Preferences > Advanced > Show Develop menu in menu bar.
  • Enable Develop > Allow Unsigned Extensions.
  • Enable the extension by checking the box in Safari > Preferences > Extensions.

Building, testing or contributing

Please see the ruffle-web README.