Installation & Use

INSTALLATION AND FIRST RUN

Download the latest primeStationOne image archive (and any other modules / tools you are interested in) from the following MEGA (mega.co.nz) share: http://goo.gl/RPKAr1

If you have managed to obtain one of these releases, extract the .7z archive so you have the .img file.
Here are the commands to write the image file on Mac and Linux with a progress bar as well. The v1.0000 beta release archive is used for this example, adjust accordingly if you have a different version. You will need a minimum of a 8GB SD card to begin using the PrimeStation One. Once (and if) you've transferred the root filesystem to USB, you can manually prepare a tiny SD card (any size above 50 MB will work) to act as a boot drive for the USB PrimeStation and free up your 8GB SD card for other uses.
NOTE: Upon the first boot of your Primestation One (starting with v1.00beta4ish), your SD card's filesystem will be auto-expanded to fill your SD card for maximum justice.

Install on Mac:

UPDATE: You can totally use ApplePi Baker @ http://www.tweaking4all.com/hardware/raspberry-pi/macosx-apple-pi-baker/ to write the Primestation image to your SD card directly from the .7z file! Uber convenience, you guys!
..If ApplePi Baker is not your cup of tea, here's how to CLI that noise: (brew install pv if you don't have pv. If you don't have Homebrew, go to http://brew.sh/ and follow the instructions) Replace the device /dev/disk2 with your SD card designation (disk1, disk2, disk3...), and of course the image filename with the appropriate one (ending in RPi1.imgRPi2.img, orRPi3.img).
        pv --size 7888437760 primeStationOne7.9gSdV1.0000betaBasedOnRetroPie3.0.0beta2RPi2.img | sudo dd bs=2m of=/dev/disk2
...or, I suppose you COULD do it without pv and just watch a blank cursor and guess how fast it is transferring and how far along it is and how much longer it will be, by typing:
        sudo dd bs=2m if=primeStationOne7.9gSdV1.0000betaBasedOnRetroPie3.0.0beta2RPi2.img of=/dev/disk2

Install on Linux: (sudo apt-get install pv if you don't have pv) Replace the device /dev/sdb with your SD card designation (sda, sdb, sdc...).

        pv --size 7888437760 primeStationOne7.9gSdV1.0000betaBasedOnRetroPie3.0.0beta2RPi2.img | sudo dd bs=2M of=/dev/sdb
...or, I suppose you COULD do it without pv and just watch a blank cursor and guess how fast it is transferring and how far along it is and how much longer it will be, by typing:
        sudo dd bs=2M if=primeStationOne7.9gSdV1.0000betaBasedOnRetroPie3.0.0beta2RPi2.img of=/dev/sdb

Install on Windows: Follow this instruction.

Netplay for RetroArch / LibRetroCore-enabled emulators

As of v0.976, a handy netplay configuration / enable / disable script is provided on the EmulationStation settings page! Or, you can type netplayConfigForRetroArchLibretrocoreEmulators.sh to launch from the terminal.
From here, you can enable / disable and configure netplay functionality on libretrocore enabled emulators, a list of which is located in the repository here: !ListOfNetplayEmus

Cloud Save Game and Save State Backup

As of v0.9999, the Primestation One has the capability to link to a Mega.co.nz cloud drive for save state and save game backup / restore purposes. Never lose your precious saves again!
In the EmulationStation Settings page (the start-up page), scroll down to the cloudBackup folder and look inside for the (hopefully self-explanatory) scripts you will need:
mega_cloud_login.sh
mega_cloud_clear_login.sh
mega_cloud_backup_all_savestates_and_srams.sh
mega_cloud_restore_all_savestates_and_srams.sh

Playing Mario Paint on SNES with the Mouse

...can be achieved, but only on a Pi2 or Pi3 as it requires the *Super Nintendo - SNES9xNextPi2 emulator (4th Super Nintendo emulator listed when pressing right to browse from the starting point).
Since V0.9999, the Snes Mouse has it's own emulation entry just for Mario Paint, to avoid having to do any of the below! There is a new rom folder ~/RetroPie/roms/snesmouse to place your Mario Paint and any other SNES Mouse roms in. (Must put a ROM in the snesmouse folder before this new entry will show up in Emulationstation)
  1. Navigate to this SNES emulator, find your Mario Paint ROM, and launch it.
  2. Bring up the RetroArch menu (On PS3 controller: hold SELECT and press L1, on keyboard should just be F1)
  3. Press the CIRCLE button on the PS3 controller to continue
  4. Navigate to Settings and press CIRCLE to continue
  5. Navigate to Input Settings - Joypad Mapping and press CIRCLE to continue
  6. Navigate to User 1 Device Type and press right to change SNES Joypad to SNES Mouse.
  7. Exit the RetroArch menu (On PS3 controller: hold SELECT and press L1, on keyboard should just be F1)
  8. You should now have SNES Mouse control over Mario Paint!! You are welcome. --Prime
NETPLAY -- IMPORTANT!:
When launching an emulator capable of NETPLAY, you must hit the x key pretty much immediately after emulationstation's interface dissappears; there is a brief prompt asking you to press this key for options. You need to go to this menu and choose the Launch with netplay support (or hotkey z) then ENTER to actually launch the emulator with your netplay settings enabled.
If you start in Host mode, your emulator will appear to freeze during startup until a Client connects.
Start your host first, then start the client(s). You can watch them connect and the screens sync up. Awesome!!
There is also a button combination mapped on the controller to allow you to swap netplayers, though this is experimental. Look for it on the splashscreen / quick reference screen (also above) and try it out!