How do I find what I want without reading this entire guide?
- Windows: control+f
- Mac: command+f
- Android: Open the menu on the upper right. It looks like a colon with three dots. Select "find in page"
- iOS: http://ipod.about.com/od/phonefeatures/ ... n-Page.htm
The beginning here will be focused on basics. If you know how to use the CLI/Terminal and putty you will be bored. I am writing this because of the recent onslaught of redundant questions regarding emulation. It is in some peoples nature not to search for help so I don't expect this to help everyone but if it helps a couple I will be happy. I am writing this assuming the user has imaged their SD card with RetroPie 2.3 (the most recent at this time) because I feel this is the most painless way of getting going. I would like to point out that if you are afraid of the CLI (command line interface), Terminal, or SSH you should turn back now as there is no 100% graphical way to make a R Pi emulation box at this moment. I am writing this from the perspective of a Windows user because I feel that anyone that uses Linux as their DD (daily driver) will have no issues setting up RetroPie.
The Raspbian Command Line Interface (CLI)
So with all this talk of the terminal and CLI lets begin. You will need to remember some commands to use the CLI. Here are some good ones to start with:
- ls -a
- df -h
- | less
- find / -name "insert words here"
- (some more I don't remember)
Here is a brief description of what each of these do. "ls -a" lists all files in a directory including hidden files (which there are some important ones for configuring ES (EmulationStation). "sudo" makes the command you enter run as if you were the super-user. An example would be "sudo nano config.txt" as you will pretty much need write privileges whenever you run nano, or "sudo su" will make you super-user for all commands but this is dangerous so it should be avoided until you know what you are doing. "nano" is a easy text editor and there are many alternatives but nano works fine. "df-h" will show you disk usage in a human readable format. "cd" changes directories, "cd /." will bring you to the root directory fast. "man" gives you the manual for a command for instance... "man nano", "man less". "less" is used for when text spills over the terminal's buffer, if you hit "ls -a" in a big full directory it may go way off the screen a good way to fix that is "ls -a | less" after that you will only get a screens worth at a time. Use the space bar to scroll down one line at a time or page down to scroll a whole page at a time with less. The "|" is called the pipe and on a US keyboard it is the symbol on the button over the \. "rpi-update" updates the firmware and kernel to the newest version. "raspi-config" will open a script to setup various options, I will cover this in more detail later. "sudo ./retropie_setup.sh" will run the RetroPie setup script, this will require more coverage later.
How do I use the CLI?
There are many ways but I will cover three here. First is exiting EmulationStation which will bring you to a screen like this.
Take note of the IP address it will come in useful.
Next is going into xserver and starting a terminal session, and the window opened will look similar to above.
Finally, is my preferred method and that is SSH. On windows I like Putty, Android JuicySSH, and iOS there are none I like but some like mobile admin work.
After downloading Putty (google search Putty SSH) and extracting it you will get a warning go ahead and run it there is nothing wrong with putty.
Find the IP address of your Raspberry Pi on your local network.
You will need to know the local IP Address of your R Pi to connect to it via Putty. That is why I noted it above with the local method of connection because it is the easiest way to get that address. But there are other ways, but Windows networking just isn't that robust so it won't be as easy as with Linux.
First method of finding your R Pi's address if you can't walk over and exit ES is ARP. Go to your search function within the OS (not your web browser) and type cmd. It should auto launch the command line. Put in "arp -a" and you will get an address of all the devices on your local network plus a couple domain name servers. You can take this list with putty and try each one in order until you find the pi.
Next, is the method I use regularly when I need to find a Device. Log into your router and look for it. Most routers have a function somewhere to list the DHCP table. This isn't a tutorial on how to use your router, but for most the default username is admin and the pw is password.
In my case my main wireless is a Cisco/Linksys 4200. Feel free to make fun of my device list once this thread is unlocked.