Skip to content

Latest commit

 

History

History
36 lines (29 loc) · 3.09 KB

README.md

File metadata and controls

36 lines (29 loc) · 3.09 KB
Raw

sshflash

Software to flash (custom) leapfrog device firmware over SSH.

Note: This fork combines both the sshflash program and images for the custom Linux distro that includes a couple of emulators and a Retroarch installation. Additionally, I've simplified the instructions for anyone who might want to try this project. These instructions only work for Linux (Debian/Ubuntu based distros). Credits go to the creator: mac2612.

LeapSonic

Installation

  • Make sure your Leapfrog is connected to your computer via cable and is in recovery mode (Script will let you know how to enter recovery mode). Usually to enter recovery mode you should turn off the Leapfrog, then hold the Shoulder Buttons (L + R) and the Hint Button (?), then press the ON Button. You should be greeted by a green screen with a picture of a Leapfrog connected to a computer. This key combination could vary with each model, so refer to the script.
  • Install required dependencies: sudo apt install sg3-utils python3 git (If you get any Python errors, try installing python2 instead).
  • Clone this repository: git clone https://github.com/Spyder-0/sshflash-leapfrog.git.
  • Change directory to the cloned repo: cd sshflash-leapfrog.
  • Run the script: ./remote_flash.sh. If you get any access errors, run chmod +x remote_flash.sh.
  • Follow the instructions provided by the script and make sure to select the correct Leapfrog device.
  • After the firmware is flashed, your Leapfrog should automatically reboot.

Organising ROMs

  • Make sure your Leapfrog is still connected to your PC via cable. It should be detected as a wired internet connection adapter.
  • Use this command to make a new directory for the console you want to organise ROMs for: ssh -i ~/sshflash-leapfrog/keys/id_rsa [email protected] 'mkdir /roms/<PLATFORM>'.
  • For example, if I want to make a folder for Sega Genesis ROMs, I would use the command: ssh -i ~/sshflash-leapfrog/keys/id_rsa [email protected] 'mkdir /roms/Genesis'.
  • Additionally, you can just SSH into the Leapfrog filesystem and modify it as you like: ssh -i ~/sshflash-leapfrog/keys/id_rsa [email protected].

Adding ROMs

  • Make sure your Leapfrog is still connected to your PC via cable. It should be detected as a wired internet connection adapter.
  • To transfer ROMs to the Leapfrog, use the command: scp -i ~/sshflash/keys/id_rsa '<ROM_LOCATION>' [email protected]:/roms/PLATFORM.
  • For example: scp -i ~/sshflash/keys/id_rsa '~/ROMs/Genesis/Sonic The Hedgehog 2 (World) (Rev A).md' [email protected]:/roms/Genesis.

Credits

Huge thanks to mac2612 for making this project in the first place.

Additional Help/Recources