Ruffle - General Guide
An open source Flash Player emulator.
Note:
Ruffle is a W.I.P emulator that is under heavy development.
Some games might not work at all or control right.
Ruffle Links
| Resource | Link |
|---|---|
| Ruffle - Blog | Link |
| Ruffle - Compatibility List | Link |
| Ruffle - Webpage | Link |
⚠️ Bleeding-Edge Component ⚠️
Warning: This component is under rapid development and may be unstable.
- Performance may vary across hardware configurations.
- Some standard features available in other components may not yet be supported.
- Controllers or other input devices may require manual configuration.
- Compatibility may vary across the supported game library.
- Functionality, performance and compatibility may change as development progresses.
Where to put the games?
Flash games should be put under the retrodeck/roms/flash/ directory.
What file formats are supported?
| File Format | Description |
|---|---|
| .swf | Shockwave Flash file |
Does Ruffle require BIOS, Game Data or Firmware files?
No
Directory structure
| Type | Directory | Comment |
|---|---|---|
| Cache | ~/.var/app/net.retrodeck.retrodeck/cache/ruffle/ |
|
| Config | ~/.var/app/net.retrodeck.retrodeck/config/ruffle/ |
|
| Data | ~/.var/app/net.retrodeck.retrodeck/data/ruffle/ |
|
| ROMs | retrodeck/roms/flash/ |
|
| Saves | retrodeck/saves/flash/ |
Ruffle Controls
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:
- Keyboard: WASD, arrow keys, numpad or other.
- Mouse.
- A combination of mixed inputs.
Suggestions on how to control games:
- Use a real keyboard and mouse.
- Use RetroDECK's Steam Input Layouts to emulate mouse input on a controller using the right joystick.
- Use the built-in touchpads as a mouse on controllers or devices like the DualSense, DualShock 4, Steam Deck and Steam Controller 2015 / 2026.
- Use the built-in touchscreens as a mouse on devices like the Steam Deck.
- Summon built-in virtual keyboards in SteamOS or your Linux distribution with a button combo.
Can I use Ruffle to play Flash videos and not just games?
Yes, you can add Flash videos (.sfw files) to the retrodeck/roms/flash/ folder to play them.
You might want to organize videos and games into separate subfolders, but it's optional.
Example: