1<!DOCTYPE html> 2<html lang="en"> 3 <head> 4 <meta charset="utf-8"> 5 <meta http-equiv="X-UA-Compatible" content="IE=edge"> 6 <meta name="viewport" content="width=device-width, initial-scale=1"> 7 <meta name="description" content="a graphical emulator front-end"> 8 <meta name="author" content="Alec Lofquist"> 9 <link rel="shortcut icon" href="favicon.ico"> 10 11 <title>EmulationStation</title> 12 13 <!-- Bootstrap core CSS --> 14 <link href="css/bootstrap.min.css" rel="stylesheet"> 15 <!-- Google Fonts --> 16 <link href='http://fonts.googleapis.com/css?family=Open+Sans:300,400,600,700' rel='stylesheet' type='text/css'> 17 <!-- Custom styles for this template --> 18 <link href="css/es.css" rel="stylesheet"> 19 <link href="css/help.css" rel="stylesheet"> 20 </head> 21<!-- NAVBAR 22================================================== --> 23 <body> 24 <div class="navbar-wrapper"> 25 <div class="navbar navbar-inverse navbar-fixed-top" role="navigation"> 26 <div class="container"> 27 <div class="navbar-header"> 28 <a class="navbar-brand" href="./index.html">EmulationStation</a> 29 <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse"> 30 <span class="icon-bar"></span> 31 <span class="icon-bar"></span> 32 <span class="icon-bar"></span> 33 </button> 34 </div> 35 <div id="top-nav-div" class="navbar-collapse collapse"> 36 <ul class="nav navbar-nav"> 37 <li><a href="./index.html#home">Home</a></li> 38 <li><a href="./index.html#features">Features</a></li> 39 <li><a href="./index.html#download">Download</a></li> 40 <li><a href="./index.html#feedback">Feedback</a></li> 41 </ul> 42 <ul class="nav navbar-nav navbar-right"> 43 <li><a href="./releases.html">Releases</a></li> 44 <li><a href="./gettingstarted.html">Getting Started</a></li> 45 <li class="active"><a href="./faq.html">FAQ</a></li> 46 <li><a href="./news/index.php">News</a></li> 47 </ul> 48 </div> 49 </div> 50 </div> 51 </div> 52 53 <br/><br/><br/><br/> 54 <div class="container"> 55 <h1>Frequently Asked Questions</h1> 56<h3>Project Questions</h3> 57<p class="question">Q. There are a million emulator front-ends out there. Why should I use yours?</p> 58<p>A. EmulationStation targets computers connected to a television (like HTPCs, media boxes, and the Raspberry Pi), is cross-platform, and completely open source. </p> 59<p>HyperSpin has an amazing community that has created an insane amount of game-specific themes (!), but is Windows only and closed-source.</p> 60<p>OpenEmu is fantastic for desktop use, but not well-suited to TV use and is Mac only.</p> 61<p>XBMC does a hell of a lot more than EmulationStation, is better supported, and more extensible, but the emulator support is not quite "official" yet (regarding the RetroPlayer branch). That said, if you are already using XBMC, I would be hard-pressed to convince you to switch - the program is fantastic.</p> 62<hr> 63<p class="question">Q. How big is the team?</p> 64<p>A. Literally two guys and whoever contributes on GitHub.</p> 65<p><a href="http://aloshi.com">Alec Lofquist</a> is me, the guy who does all of the programming for EmulationStation, writes the website, writes the content for the website (like this FAQ), and does most of the English community interaction. I also contribute to RetroPie from time to time.</p> 66<p><a href="http://blog.nilsbyte.de">Nils Bonenberger</a> is the other guy, who does the UI design, makes any internal art assets that are needed, the logo, the current set of default themes, and German community interaction.</p> 67<p>We do this project entirely in our spare time, so please forgive us if updates are infrequent and there are bugs.</p> 68<hr> 69<p class="question">Q. Can I use EmulationStation as a front-end in [project]?</p> 70<p>A. Yes! Please do! ES is by no means RetroPie-only.</p><br/> 71<h3>Technical Questions</h3> 72<p class="question">Q. EmulationStation works even though there'
72s no <code>~/.emulationstation/es_systems.cfg</code> file! What's up with that?</p> 73<p>A. There is probably a pre-configured <code>es_systems.cfg</code> file in <code>/etc/emulationstation/es_systems.cfg</code> (Linux only). See README.md for more detailed documentation.</p> 74<hr> 75<p class="question">Q. EmulationStation has themes even though the <code>~/.emulationstation/themes</code> directory is empty! Black magic!</p> 76<p>A. There is probably a pre-installed set of themes in <code>/etc/emulationstation/themes</code> (Linux only). See README.md for more detailed documentation.</p> 77<hr> 78<p class="question">Q. EmulationStation just crashed! Fix it!</p> 79<p>A. Post an issue on the <a href="https://github.com/Aloshi/EmulationStation/issues?state=open">GitHub issues page</a>. Check to make sure you are not opening a duplicate issue! Remember to check "Closed" issues too!</p> 80<hr> 81<p class="question">Q. My keyboard doesn't work at all on the Raspberry Pi.</p> 82<p>A. You probably forgot to install <code>libudev-dev</code> before you compiled SDL2.</p> 83<hr> 84<p class="question">Q. Some systems have a white background that shouldn't.</p> 85<p>A. You probably ran out of VRAM on the Raspberry Pi. A good rule of thumb for how much memory you should allocate to the GPU on a 1080p setup using the default themes is <code>8mb + 25mb + 10mb * [NUMBER_OF_SYSTEMS_WITH_GAMES]</code> (framebuffer + fonts + high quality system art). 256mb should be fine for casual setups.</p> 86<hr> 87<p class="question">Q. Can I make a portable installation of EmulationStation on Windows so I can get up to mischief at my local high school?</p> 88<p>A. Yes! Download the ZIP archive from the download page and extract it to your portable drive. You can use the provided "run_portable.bat" file to launch EmulationStation with the "home folder" environment variable set to that folder. Put your <code>es_systems.cfg</code> and themes inside a <code>.emulationstation</code> folder. You may have to learn some environment variables to get your paths and launch commands right (hints: using <code>~\roms\...</code> as the start of a path is the same as <code>%HOMEPATH%\roms\...</code>, you can use <code>%HOMEPATH%\emulators\...</code> in a launch command). If the computers are really old, you may have to install the Microsoft Visual C++ 2013 Redistributable to get ES to start.</p> 89<hr> 90<p class="question">Q. I want to launch certain games with certain emulators, but keep them all in one system. HOW DO?</p> 91<p>A. ES doesn't provide a silver bullet for this, but you can solve the problem through with a clever shell script. Here's an example that might help (set your launch command to <code>/path/to/gamelaunch.sh %ROM%</code>):</p> 92<pre><code class="lang-bash">#!/bin/bash 93 94# usage: 95# gamelaunch.sh path/to/rom.sfc 96 97# arguments: 98# $1 - the path to the rom 99 100 101# how to launch if the game isn't using one of the "custom" emulators 102defaultemulaunch="retroarch --lib pocketsnes.so \"$1\"" 103 104# a list of games for the first emulator + the launch command 105# warning: these are case sensitive and should include the extension; 106# they must match the command "basename [path/to/file.whatever]" exactly 107emu1names=(\ 108 "Super Mario World.sfc"\ 109 "The Legend of Zelda - A Link to the Past.sfc"\ 110 "EarthBound.sfc") 111 112emu1launch="snes9x \"$1\"" 113 114 115# what we're searching for 116# basename strips leading directories off of the filename 117gamename=`basename "$1"` 118 119for index in ${!emu1names[*]} 120do 121 game=${emu1names[index]} 122 if [ "$game" == "$gamename" ]; then 123 # found it, launch the emulator and quit 124 exit `$emu1launch` 125 fi 126done 127 128# it wasn't in the list, launch the default emulator, something like: 129exit `$defaultemulaunch`</code></pre> 130<hr> 131<p class="question">Q. The scraper doesn't find my game, even though the game is named right and everything!</p> 132<p>A. The databases we scrape from are not guaranteed to be complete, and sometimes their search functions don't work quite right.</p> 133<hr> 134<p class="question">Q. The scraper found the wrong game(s), even though it's named right and everything!</p> 135<p>A. The search function for TheGamesDB.net is a little broken. For example, searching for "Super Mario World" returns "Super Mario World + Super Mario All-Stars" first, instead of "Super Mario World". I don'
135t know why that is. Take it up with them.</p> 136<hr> 137<p class="question">Q. The archive.vg scraper doesn't work! Like, at all!</p> 138<p>A. At one point, it did. Then they restructed a bunch of stuff and things broke. Let me know when the site is stable again and I'll fix it.</p><br/> 139 </div> 140 141 142 <!-- Bootstrap core JavaScript 143 ================================================== --> 144 <!-- Placed at the end of the document so the pages load faster --> 145
145<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.0/jquery.min.js"></script>
145 146
146<script src="https://google-code-prettify.googlecode.com/svn/loader/run_prettify.js?autoload=true"></script>
146 147
147<script src="js/bootstrap.min.js"></script>
147 148
148<script src="js/analytics.js"></script>
148 149
149<script> 150 $(document).ready(function () { 151 // update right navbar immediately on click 152 $('ul.nav > li').click(function (e) { 153 $('ul.nav > li').removeClass('active'); 154 $(this).addClass('active'); 155 }); 156 }); 157 </script>
157 158</body>
Line numbers count LF bytes from the start of the resource, as the search results do. Vendor segments are library code the classifier recognised; they are stored but not indexed. Bytes are shown as Latin1 characters, one per byte.