as discussed in other threads, I was thinking about taking the base OS image and add the standalone emulators so that newcomers can get most systems running with improved perfomance by just adding games (and the odd bios file).
This is purely aimed at people that just want to emulate games without tinkering with the system too much. It is still advised to get acquainted with the system itself if something goes wrong some time in the future.
I’ve tried to keep changes to the image file to a minimum, I only cleaned up the file structure a little and added the standalone emulators in a way that they are usable from the start (e.g. the correct path to the roms is already configured).
Included are: PocketSNES, fceux (NES), gPSP (GBA), ohboy (GB), PCSX (PSX) and PicoDrive (Mega Drive / Genesis).
Here’s the link to the image file: Download
To install the image, do the following (this is written for Windows users):
Download Win32DiskImager or another program that can write images to SD cards
Flash the image
Run the program, connect the SD card you want to install the image on (at least 8GB) and in Win32DiskImager choose the image file and the correct drive letter for the SD card and hit “Write”.
(Make extra sure this is the correct drive, as everything on it will get deleted to write the image on it!)
Boot the system up
After the process is finished, put the SD card into your GameShell and boot it. If everything worked out, you should see the normal launcher menu (with some fancy icons thanks to this thread)
(Optional) Expand the file system
Use PuTTY or a similar program to ssh into your GameShell and after logging in (username: cpi, password: cpi), type in the following: “bash <(curl -s https://raw.githubusercontent.com/hpcodecraft/gameshell-setup/master/run.sh)”
Let it do its thing until it asks if you want to expand the file system to match the size of your SD card. Type “Y” and hit enter and after that, all the space of your SD card should be available.
Access your GameShell
Use FileZilla or a similar program to ssh into your GameShell (for tutorials on how to do that, please search on the forums)
Put games on it
The only two things you have to do now are:
a) put games on the device: for that go to “home/cpi/games/” and in the respective folder (GB for Game Boy, GBA for Game Boy Advance, MD for Mega Drive / Genesis, NES for … NES, PSX for PlayStation and SNES for the Super NES) and just upload the roms to that folder
b) the GBA and PSX emulator need a bios file to run. For the GBA emulator, put the bios file named “gba_bios.bin” in “home/cpi/apps/emulators/GBA/”. For the PSX emulator, put the file named “scph1001.bin” in “home/cpi/apps/emulators/PSX/bios/”. Make sure the files are spelt exactly like that!
Voila, you should be able to play all your favorite retro games now!
If you find mistakes or have problems with the image, please let me know. I tested all the emulators, but cannot guarantee that they work flawlessly (I just installed them for you ).
If there’s enough interest for a v0.4 image with the same setup, let me know. I chose v0.3 mainly because that’s what I’m using and I heard that 0.4 introduced some new compatibility issues.
Now have fun with your GameShell!