RetroRun is a libretro frontend specifically designed for Anbernic devices, including the RG351 M/P/V/MP, RG552, RG503, RG353M, and RG353V. It enhances your gaming experience with improved performance and simplified configuration.
This version of RetroRun differs significantly from retrorun-go2, as it encapsulates libgo2 and rg351p-js2box within itself. This eliminates the need for complex joypad configuration or compiling additional libraries. These libraries are not only integrated but also enhanced to provide the best possible experience.
RetroRun has been tested and supports the following cores:
- Dreamcast: Flycast, Flycast 2021
- Nintendo 64: ParaLLEl N64
- PlayStation: SwanStation, DuckStation, PCSX-ReARMed
- Game Boy Advance: mGBA, VBA-M
- Atari Jaguar: Virtual Jaguar
- DOS Emulation: DOSBox-pure, DOSBox-core
- Atari 2600: Stella, Stella 2014
- Sega Consoles: Genesis Plus GX, PicoDrive
- Super Nintendo: Snes9x, Snes9x 2002, Snes9x 2005 Plus, Snes9x 2010
- Sony PSP: PPSSPP
- Others: Beetle VB, Yaba Sanshiro
This project adds many improvements and new features to the retrorun-go2 project:
1. Integrated libgo2 library
2. Integrated rg351p-js2box library
3. Tate Mode Support (useful for Naomi and Atomiswave vertical games)
4. Right Analog Support for ParaLLEl N64, including C-buttons management
5. FPS Display Options:
• Log FPS using the -f flag
• Display FPS on-screen with SELECT + Y
6. Core Configuration via File
• Default: /storage/.config/distribution/configs/retrorun.cfg
• Customizable with the -c parameter
7. Aspect Ratio Management
8. Support for GPIO/USB Joypads
9. On-Screen Display (OSD) with explanatory images
10. Info Menu displaying device and game information
11. Working SaveState support for all cores, including Flycast2021 and Flycast
12. Rumble support for all cores and devices
13. Hotkeas for SaveState
14. Buttons re-mapping
13. Many additional enhancements
⸻
Clone the repository and compile RetroRun using:
git clone https://github.com/navy1978/retrorun
cd retrorun
make
strip retrorunTo launch a game using RetroRun, it is recommended to create a bash script (retrorun.sh) that accepts three parameters: core, rom, and platform (optional). Below is an example script:
#!/bin/bash
. /etc/profile
echo 'Starting RetroRun front-end...'
CORE="$1"
ROM="${2##*/}"
PLATFORM="$3" # Optional
FPS='-f' # Optional
GPIO_JOYPAD='-g' # Optional
./retrorun --triggers $FPS $GPIO_JOYPAD -s /storage/roms/"$3" -d /roms/bios "$1" "$2"
echo 'front-end ended!'
To run the script:
./retrorun.sh /path/to/core /path/to/game name_of_platform
The configuration file (retrorun.cfg) contains settings for different cores. Example:
# ---- RETRORUN INTERNAL SETTINGS ----
retrorun_screenshot_folder = /storage/roms/screenshots
# ---- FLYCAST ----
flycast_threaded_rendering = enabled
flycast_internal_resolution = 640x480
flycast_anisotropic_filtering = off
flycast_enable_dsp = disabled
flycast_synchronous_rendering = disabled
flycast_enable_rtt = disabled
flycast_enable_rttb = disabled
flycast_delay_frame_swapping = disabled
# Alpha sorting should be set to per strip
flycast_alpha_sorting = per-strip (fast, least accurate)
flycast_div_matching = auto
# Texupscale should be off
flycast_texupscale = off
# Vibration support should be on
flycast_enable_purupuru = enabled
flycast_auto_skip_frame = disabled
flycast_gdrom_fast_loading = enabled
flycast_volume_modifier_enable = disabled
flycast_framerate = fullspeed
flycast_anisotropic_filtering = disabled
# ---- FLYCAST2021 ----
flycast2021_threaded_rendering = enabled
flycast2021_internal_resolution = 640x480
flycast2021_anisotropic_filtering = off
flycast2021_enable_dsp = disabled
flycast2021_synchronous_rendering = disabled
flycast2021_enable_rtt = disabled
flycast2021_enable_rttb = disabled
flycast2021_delay_frame_swapping = disabled
# Alpha sorting should be set to per strip
flycast2021_alpha_sorting = per-strip (fast, least accurate)
flycast2021_div_matching = auto
# Texupscale should be off
flycast2021_texupscale = off
# Vibration support should be on
flycast2021_enable_purupuru = enabled
flycast2021_gdrom_fast_loading = enabled
flycast2021_volume_modifier_enable = disabled
flycast2021_framerate = fullspeed
flycast2021_anisotropic_filtering = disabled
# ---- PARALLEL N64 ----
parallel-n64-framerate = fullspeed
parallel-n64-filtering = nearest
parallel-n64-audio-buffer-size = 1024
parallel-n64-gfxplugin-accuracy = medium
parallel-n64-screensize = 640x480
parallel-n64-gfxplugin = rice
parallel-n64-pak1 = rumble
parallel-n64-pak2 = memory
parallel-n64-pak3 = none
parallel-n64-pak4 = none
# ---- JAGUAR ----
virtualjaguar_doom_res_hack = enabled
virtualjaguar_pal = disabled
virtualjaguar_usefastblitter = enabled
virtualjaguar_bios = enabled
# ---- PPSSPP ----
ppsspp_cpu_core = JIT
#ppsspp_detect_vsync_swap_interval = disabled
ppsspp_fast_memory = enabled
ppsspp_frameskip = 0
ppsspp_frameskiptype = Number of frames
ppsspp_ignore_bad_memory_access = enabled
ppsspp_internal_resolution = 480x272
ppsspp_rendering_mode=buffered
# ---- DUCKSTATION ----
duckstation_CPU.Overclock = 100
duckstation_Controller1.Type=AnalogController
# ---- SWANSTATION ----
swanstation_CPU_Overclock = 100
swanstation_GPU_Renderer = Software
(*) Pay attention to the parameter names, as they follow the naming convention of the core. For example, in some distributions, the Flycast core is named Reicast. In such cases, parameters should be prefixed accordingly—e.g., 'flycast_threaded_rendering' should be renamed to 'reicast_threaded_rendering'.
The configuration file (retrorun.cfg) can be put in the same folder of retrorun executable. By default the configuration file will be search in :
/storage/.config/distribution/configs/retrorun.cfg
Otherwise anohter path can be specified with the "-c" arg, like this:
retrorun -c /my-path/retrorun.cfg
These parameters can be set in the retrorun.cfg file:
General Settings
• retrorun_screenshot_folder = /storage/roms/screenshots (Default screenshot save folder)
• retrorun_screenshot_folder = /storage/roms/screenshots (Default screenshot save folder)
• retrorun_device_name = Specifies a custom name for the device (e.g., RG351P, RG552, etc.). Useful for customizing per-device behavior
• retrorun_log_level = INFO | DEBUG | WARNING | ERROR (Sets the log verbosity level. Default is INFO.)
• retrorun_enable_key_log = true | false (Enables logging of key/button presses. Useful for identifying input names. Default is false.)
Input Settings
• retrorun_force_left_analog_stick = true | false (Map left analog stick to D-pad, default: true)
• retrorun_swap_l1r1_with_l2r2 = true | false (Swap L1/L2 with R1/R2, default: false)
• retrorun_swap_sticks = true | false (Swap left and right analog sticks, default: false)
• retrorun_alternative_input_mode = true | false (Enable OSD toggle with SELECT+X instead of L3+R3, and some alternatives combination to show FPS, take ascreenshot and so on)
• retrorun_mouse_speed_factor = int (Defines mouse movement speed in emulators that support mouse input. Default is 5.)
Device Matching Overrides
These parameters allow you to dynamically extend the list of recognized joypad devices:
• retrorun_extra_retrogame_name = string (Adds a joypad name to the list of recognized Retrogame devices)
• retrorun_extra_osh_name = string (Adds a joypad name to the list of recognized OpenSimHardware devices)
• retrorun_extra_evdev_name = /dev/input/by-path/… (Specifies an alternative evdev file for Retrogame devices)
These values are optional: if not defined, they are ignored. They are useful for supporting custom devices or unofficial hardware revisions.
Save/Load Features
• retrorun_auto_save = true | false (Enable auto-save, default: false)
• retrorun_auto_load = true | false (Enable auto-load, default: same as auto-save)
Performance Settings
• retrorun_loop_60_fps = true | false (Restrict loop to 60 FPS, default: true)
• retrorun_audio_buffer = -1, 1, 256, 512, 1024, ... (Audio buffer size, default: -1)
• retrorun_force_video_multithread = true | false (Run video tasks in a separate thread, default: varies by device)
Video Settings
• retrorun_tate_mode = auto | enabled | disabled | reverted (Enable vertical display mode, default: disabled)
• retrorun_pixel_perfect = true | false (Enable pixel perfect display, default: disabled)
• retrorun_fps_counter = true | false (Display FPS counter, default: false)
• retrorun_aspect_ratio = 2:1 | 4:3 | 5:4 | 16:9 | 16:10 | 1:1 | 3:2 | auto (Aspect ratio, default: core-defined)
• retrorun_show_loading_screen = true| false (Show the Loadig screen during the game loading, default: true)
Rumble Settings
• retrorun_rumble_type = pwm | event (Rumble type, default varies by device)
• retrorun_rumble_event = /dev/input/eventX (Override default rumble event file)
• retrorun_rumble_pwm_file = /sys/class/pwm/pwmchip0/pwm0/duty_cycle (Override default PWM file)
• retrorun_disable_rumble = true | false (Disables rumble/vibration support. Default is false.)
To configure button mappings in retrorun.cfg, you can set one or more of the following parameters:
retrorun_mapping_button_up
retrorun_mapping_button_down
retrorun_mapping_button_left
retrorun_mapping_button_right
retrorun_mapping_button_a
retrorun_mapping_button_b
retrorun_mapping_button_x
retrorun_mapping_button_y
retrorun_mapping_button_select
retrorun_mapping_button_start
retrorun_mapping_button_l1
retrorun_mapping_button_r1
retrorun_mapping_button_l2
retrorun_mapping_button_r2
retrorun_mapping_button_l3
retrorun_mapping_button_r3
retrorun_mapping_button_f1
retrorun_mapping_button_f2
Each parameter should be assigned the corresponding button name you want to map. For example:
retrorun_mapping_button_x = SELECT
How to Find the Correct Button Name? To identify which button name to use, start retrorun with the following parameters enabled:
retrorun_enable_key_log = true
retrorun_log_level = DEBUG
This will enable logging of button presses. When you press a button, the logs will show output like:
Joypad button pressed: [BTN_TRIGGER_HAPPY2] - [F2]
In this case, the button name to use is the one shown inside the second set of square brackets, e.g.:
retrorun_mapping_button_l3 = F2
RetroRun delivers a streamlined and optimized gaming experience for Anbernic devices, offering enhanced performance, simplified configuration, and broad core compatibility.
RetroRun was initially developed by OtherCrashOverride until 2020. Since 2021, development has been continued and maintained by navy1978.
A heartfelt thanks to:
Cebion, Christian_Haitian, dhwz, madcat1990, pkegg and Szalik for their contributions and support.