Since Recalbox 10, you can run your own small scripts straight from the interface, without going through SSH: mounting a partition, a one-off system tweak, maintenance… up to you.
To trigger scripts automatically on interface events (startup, game launch…), see Scripts on frontend events.
Scripts go in /recalbox/share/userscripts/manual (directly in this folder — subfolders are not scanned).
They can be written in shell (.sh extension, run with sh, or .ash for busybox's ash shell) or in Python 3 (.py or .py3 extension). They run as root, with no arguments.
The filename drives the behavior in the interface:
(sync): the interface waits for the script to finish while showing a small animation, then displays its output in a result window (or its error and exit code on failure);(progress), on top of (sync): the script can drive the display while it runs, through its standard output —
% followed by a number from 0 to 100 (%25, %50…) updates a progress bar, which appears at the first percentage received;The tags are stripped from the name shown in the menu, and replaced with small icons indicating the execution mode.
START → ADVANCED SETTINGS → USER SCRIPTS: all your scripts are listed there, each with a RUN button. The menu entry is grayed out as long as the manual/ folder is empty.
📷 Screenshot to come:
user-scripts-menu.png(USER SCRIPTS menu with a few scripts)
File: MountBootAsRw.sh
mount -o remount,rw /boot
File: UpdateSamplerate(sync)(progress).sh
mount -o remount,rw /
echo 'default-sample-rate = 48000' >> /etc/pulse/daemon.conf
mount -o remount,ro /
Need help? Join the Recalbox Discord.