cristiangc67/ruffle-r36s-darkos

This project adapts the Ruffle Flash player to run Adobe Flash games on the R36S, a handheld retro gaming device. Ruffle is an open source tool that plays old Flash content in modern browsers and on desktop systems. This repository packages a version of Ruffle built for ARM64 processors so it works on the R36S running either DarkOS or ArkOS. The project is unofficial and is not connected to the Ruffle, PortMaster, or DarkOS teams. The project offers two ways to launch Flash games. Option A is a graphical menu, built with a Python library called Pygame, that lists your games and lets you pick one with the controller. It also includes a built in keymap editor so you can assign buttons directly from the interface. Option B is simpler: you create a small shell script for each game, pointing it at the matching Flash file. No menu, no Pygame, no extra setup. Option B works well if you only have a few games, while Option A suits larger collections. Installing involves copying the repository files into a specific folder on the device, placing the compiled Ruffle binary where the scripts expect it, and then choosing one of the two launch methods. The README provides a cleanup guide so you can remove files you do not need once you pick an option. Flash game files themselves are not included. Controller configuration works on two levels. A base config helps the device recognize the gamepad cleanly. Then a per game keymap file maps each button to the keyboard key that a particular Flash game expects. The Menu Launcher can generate these files automatically, or you can create them by hand for the Template Launcher approach. The README notes that recent changes improved performance and fixed graphical glitches tied to mouse input, though some games may still show minor visual bugs. The full README is longer than what was shown.