EmulationStation Restart Rule

Agent sessions must never autonomously restart, reboot, or otherwise relaunch EmulationStation on the RG40XXV. Do not run batocera-es-swissknife --restart, kill ES processes, reboot the handheld, or trigger equivalent restart flows as part of deployment. These attempts fail in practice and can leave the frontend in a bad state.

After changing launcher or collection metadata, stop at verification and tell MjF to manually restart or refresh EmulationStation from the device UI.

Jellyfin Broker Runtime

The Pi4 user service runs the broker from /home/mehdifarah/riptide-src:

systemctl --user restart riptide-jellyfin-broker.service

Restarting that user service is allowed when broker code changes. It is not an EmulationStation restart and does not refresh the RG frontend. Keep the service runtime clone in sync with Forgejo main before restarting it.