Wiki/wiki-rtd/docs/wiki_emulator_guides/ruffle/ruffle-guide.md

# Ruffle - General Guide

<img src="../../../wiki_images/logos/ruffle-logo.svg" width="150">

An open source Flash Player emulator.

**Note:** 

Ruffle is very much a W.I.P emulator that is under heavy development. 

Some games might not control right or work at all.

---

### Ruffle Links:


[Ruffle Webpage](https://ruffle.rs/)

[Ruffle Blog](https://ruffle.rs/blog)

[Ruffle Compatibility list](https://ruffle.rs/compatibility)


---

## Where to put the games?

Flash games should be put under the `retrodeck/roms/flash/` directory.

## What file formats are supported?

`.swf`

## Does Ruffle require BIOS or Firmware?

No

## Folder structure

| Type    | Folder                 |          Comment     | 
|  :---:  | :---:                  |             :---:     |
| ROMs Folder |`retrodeck/roms/flash/` |                               | 
| Saves Folder |`retrodeck/saves/flash/` |                               | 
| Data Folder |`~/.var/app/net.retrodeck.retrodeck/data/ruffle/`         |   |

## Controls in Games

Most flash games were designed for mouse and/or keyboard controls, with each game having its own unique setup. 

There's no one-size-fits-all solution for game inputs. 

Some games might use the keyboard (WASD, arrow keys, numpad), the mouse, or a combination of these.

Suggestions on how to control games:

- Use a real keyboard and mouse.
- Use RetroDECK's Steam Input Layouts to emulate mouse input using a joystick.
- Use the built-in touchpads on controllers or devices like the DualSense, DualShock 4, Steam Deck and Steam Controller.
- Use the built-in touchscreens on devices like the Steam Deck.
- Summon built-in virtual keyboards in SteamOS or your Linux distribution with a button combo.