The Eazy Hax RetroPie Toolkit
I have spent an insane amount of time developing and maintaining this kit over the past two years for you guys and its been a blast! Due to changes that the team at RetroPie and Raspberry Pi have made to the OS the scripts require regular maintenance to function reliably….so update your scripts often or make sure you subscribe to my channel and enable notifications so you don’t miss out!
The Scripts and what they do….
- Add Video Splash Screens
- Disk Space
- Expand to External Drive Enable/Disable
- Factory Reset Controllers
- Flip Sega Genesis Megadrive and PCE TG16 graphics
- Install PowerButton
- No Audio Fix Scripts
- OverScan Enable/Disable
- XIN Mo 2 Player Enable
- N64 Tweaks Enable HD Graphics
Install Instructions
Install the toolkit to run through the RetroPie Menu on the pi itself
Enable SSH (Required for Windows or Mac users)
First your RetroPie must be connected to the internet through your home network so you can A. Connect to your Pi B. Download the toolkit and config file
Now on with enabling ssh…..
- Go to the RetroPie Menu and select Raspi-config
- Navigate to Interface Options
- Select SSH
- Select Yes
Install the Kit (Windows)
Download the Windows Kit HERE
- Extract the toolkit and put the “RetroPie Toolkit” directory where ever you like
- Launch the “Install Eazy Hax Toolit on the Pi.cmd”.
- If this is your first time launching one of the scripts in the toolkit then windows will give you a warning. (Dont worry…I wrote all these myself and they are harmless) Click “More Info”
- Next Click “Run anyway”
- A screen will pop up with text showing you the status of the install and informing you that your pi will be rebooted so the scripts show up.
Thats it! When your pi comes back online you should see a new menu item Eazy Hax Toolkit under the RetroPie Menu.
Install the Kit (Mac)
- Press Super (apple button) and spacebar to bring up spotlight. Type in “terminal”
- Highlight, copy and paste the below line into the terminal (Super + c to copy; Super + v to paste)
ssh retropie -l pi
Just type yes and hit enter if you get the dialog above. - Next put in the password
raspberrywhen prompted and hit enter
- To start the install highlight, copy and paste the below line into the terminal (Super + c to copy; Super + v to paste)
curl https://raw.githubusercontent.com/Shakz76/Eazy-Hax-RetroPie-Toolkit/master/cfg/Install%20Eazy%20Hax%20RetroPie%20Toolkit.sh | bash
- You will then see text showing you the status of the install and informing you that your pi will be rebooted so the scripts show up.
Thats it! When your pi comes back online you should see a new menu item Eazy Hax Toolkit under the RetroPie Menu.
The Scripts and what they do…
Add Video Sphlashscreens
A simple script to install a set of my favorite video splashscreens.
Disk Space
Simply tells you how much space you have available on your SD card and IF you have used my “Expand to External Drive” scripts…how much space is on your external drive as well.
Expand to External Hard Drive Enable/Disable
I tried to make this functionality as convenient for you as possible and this is probably the most complex script in my arsenal.
The Eazy Hax expand script IS NOT the same thing that RetroPie already does. The RetroPie scripts are well made as is everything RetroPie does. The built in RetroPie scripts simply copy your /home/pi/RetroPie directory to your external drive and create a link to it. You have to wait for the games to copy over (takes ages on USB 2.0) and if you disconnect your USB drive you loose all of your games. If you want to use the RetroPie method…please do so.
What The Eazy Hax Expand Script does:
- Copies everything you have on your sd card to a different directory on the SD card…not on the External drive.
- Mounts your external drive and make it mount permanently (even after reboots), and creates a roms directory on it that mimics what is on your sd card (just empty directories)
- Makes the pi think your sd card roms directory and anything you add to the external drive roms are one roms directory. This makes your Retropie read games from both your sd card and the exteral drive at the same time.
- Allows you to disconnect the external drive at any time and go mobile with the roms on your sd card….when you get back home…plug it up and you get the extended library on your External drive.
- Adds two separate samba (the way you connect to your Pi via Windows Explorer) directories one for the SD card and one for the External drive so you can add roms where you want them via the network.
- Because the Eazy Hax method does not actually copy anything…no need to wait for the roms to be copied to the external drive. The expansion is nearly instant…plus it does not waste that space.
- The final benifit to this method is you can disconnect your External drive at any time, and plug it into your PC to load a large amount of roms saving you a ton of time. As many of you already know it takes quite a bit of time to copy the bigger CD/DVD based games to your Pi via the network.
NOTE:If you for whatever reason have the exact same copy of a game on the SD card and the External drive it will read what is on the SD card and ignore what is on the External Drive.
The only rules are:
- The External drive must be formatted to NTFS
- Only one external drive at a time is supported. That said you can have 2 external drives…one with lets say your PS1 library and one with your Dreamcast library. You only need to run the Expand to External Drive Disable script, plug in your alternate drive, and run the expand script each time you switch drives. # The Scripts and what they do…. Add Video Splash Screens Disk Space Expand to External Drive Enable/Disable
Factory Reset Controllers
Just what it says….it resets your controller config for EmulationStation (Gui control…switching between systems) AND Retroarch (your controller mapping ingame). RetroPie has a similar script but they only wipe your EmulationStation configs and not your RetroArch mappings.
Flip Sega Genesis Megadrive and PCE TG16 graphics
You guessed it. Flips the graphics from Megadrive to Genesis and PC Engine to TurboGrafx-16. If you run it again it will reverse itself and set the graphics back to Megadrive and PC Engine.
Install PowerButton
I tried to come up with a easy way to setup a cheap “power off/shutdown” button for your RetroPie.
I walk through exactly how to install the button in the video below. The script simply installs the needed python scripts for you so you only need to install the button, and run the script.
No Audio Scripts
If you are not getting audio this is due to the type of TV you have. They are all a little different and these are setup to help fix it with the click of a button….the names are self-explanatory.
OverScan Enable/Disable
If your screen has a black border all the way around it run OverScan Disable to get rid of it.
If the words are running off of your screen and it seems some of the picture is cut off then run OverScan Enable.
Here is an example of needed to run OverScan Disable:
XIN Mo 2 Player Enable
The XIN Mo controller is an excellent, easy to setup and CHEAP alternative for folks building a bartop arcade or arcade joystick controller for their RetroPie http://amzn.to/2ovpqbV The only problem is the Pi registers the controller (one device) as only Player One…with no option to map the Player Two controls. After running my script the pi will then see 2 controllers represented and allow you to map them accordingly.
N64 Tweaks - Enable HD Graphics and Textures
This script makes tweaks to the N64 emulator on the RetroPie (duh)
It enables HD resolution and downloads the HD texture pack for Mario 64. You can download more texture packs and install them here on your retropie
/home/pi/.local/share/mupen64plus/hires_texture
I go through everything in detail on the video below. You MUST run an N64 game at least once and change the emulator to mupen64plus-rice. Please watch the vid for more details.
