Instructions

 

 

Below are the instructions for installing, configuring, and using TriPi. Read them carefully.

 

Install fresh image to MicroSD card


  • Insert your MicroSD card into a computer with a card reader. A Windows computer will be fine. (YOU WILL NEED A 4GB MICROSD CARD OR LARGER)

  • Format it with a program like SDFormatter.

  • Burn your downloaded TriPi image to your MicroSD card with a program like Win32DiskImager.

  • Put your MicroSD card into your Raspberry Pi 2 model B, and turn it on. Emulationstation will start up following the TriPi splashscreen.

  • Go ahead and plug in a keyboard for this part.

  • On first boot, Emulationstation will prompt you to bind your controller to the keybinds it shows you. Go ahead and do that. Then, bring up the menu with the "start" button, and select the "configure input" menu.

  • This time, press and hold a button on your keyboard so you can configure it. Assign and take note of the configuration you set up, as you may need it if you choose to modify the controller keybinds within retroarch.

  • Retroarch will already have some preset keybinds for the WIRED Xbox360 controller, thanks to the modified retroarch.cfg file included in TriPi. However, they are based off of my wacky configuration, so you MAY want to change them if you prefer a different setup.
    UPDATE 11/09/2015: I have just posted a hotfix to enable wireless controller support in-game for retroarch-based emulators. Run the TriPi updater, and after the reboot, an option in the "Ports" menu will be there to run the hotfix.

    NOTE: ONLY GAMES/EMULATORS USING THE RETROARCH BACKEND ARE PRESET. IF YOU WISH TO RUN NON-RETROARCH PORTS, YOU WILL NEED TO MANUALLY CONFIGURE KEYBINDS AND MAYBE EVEN THE XBOXDRV ARGUMENTS FOR EMULATIONSTATION IN ORDER FOR IT TO WORK. I have not really wanted to use any of the emulators that don't use Retroarch, with the exception of Mupen64plus, so I don't have keybinds to give out.

  • If you decide you want to change them, you might want to have a keyboard handy, as changing of keybinds take effect immediately, and it may leave your controller unable to make selections until you are finished.




Using/Naviagating TriPi


  • As you can see, there are a few pre-installed games, and under the "Ports" menu is an option to launch Kodi. You can go ahead and launch it if you want in order to set it up how you like it, though there are no special instructions I need to provide you. It just works.

  • You will probably want to copy any ROMs you have into the ROM directory so ES can use them. The preferred method is to copy over a samba share, which I have already set up for you. Though you can also use the built-in 'copy from usb stick' method. Refer to the RetroPie/Emulationstation documentaion for any further instructions or details.

  • In order to return to Emulationstation from Kodi, use the QUIT (NOT SHUTDOWN/REBOOT) option within the Kodi GUI. It will take a few seconds to reset the controller's xboxdrv configuration for use with Emulationstation, and then return to Emulationstation. Again-- no further action is needed by you in order for this to work. It's automagical.

  • While in the Kodi environment, use the D-pad to navigate, LT and RT to adjust volume, A button to make a selection, and B button to go back.

  • Although the reboot/shutdown commands within Kodi do not work (issue with Kodi, not much I can do about that), the reboot/shutdown commands in Emulationstation DO work. Beyond that, your reboot options for any emergencies like environment crashes or system hangs are: SSH, Pulling the plug (not recommended), or a physical reset switch-- if you installed one to your Pi (best option).

  • The login credentials for SSH and Samba are pi/raspberry.

  • If you want terminal access, You can plug in a keyboard, quit Emulationstation, and press a button on the keyboard before ES re-launches. Or you can just SSH in.

    You can relaunch Emulationstation from the command terminal by typing

    emulationstation

    and pressing enter.


Built-In Updater


Updating with this method does not wipe your settings unless specified in the update notes, and will not be the equivalent of flashing a new image causing you to start from scratch.

These updates will not update the core Raspbian Wheezy, Emulationstation, or Kodi environments. If their devs release MAJOR version updates (like the upcoming Kodi 16) and they are tested compatible with TriPi, I will make a major release announcement accompanied by a NEW IMAGE download which will also include all finalized modifications to the TriPi code.

I may decide to bundle environment updates into the TriPi-Updater in the future, but for now while this project is gaining traction, I am going to leave the updater to just handling direct TriPi-related updates/fixes.

AS OF WRITING THIS, RASPBIAN JESSIE IS NOT SUPPORTED-- AND PROBABLY WON'T BE FOR A VERY LONG TIME, IF AT ALL.