79,225
edits
(Some phrasing changes in the non-technical portions.) |
(Adjust phrasing using "you") |
||
Line 1: | Line 1: | ||
Despite not being listed on the main site, Dolphin is readily available for Linux | Despite not being listed on the main site, Dolphin is readily available for Linux, but it must be compiled oneself. Dolphin is fully compatible with both 32 and 64 bit Linux distributions. Here's how to do it, using the cmake build system. | ||
(This howto is based upon the outdated build instruction from the [http://code.google.com/p/dolphin-emu/wiki/Linux_Build project wiki page]) | (This howto is based upon the outdated build instruction from the [http://code.google.com/p/dolphin-emu/wiki/Linux_Build project wiki page]) | ||
Line 13: | Line 13: | ||
'''Other Linux version?'''<br/> | '''Other Linux version?'''<br/> | ||
If | If running a distribution without aptitude, see the build dependencies in addendum A for a list of packages needed to install. | ||
== Step 2 - Get the Dolphin Repository == | == Step 2 - Get the Dolphin Repository == | ||
Install git if | Install git if it's not already.<br/> | ||
<code>sudo apt-get install git</code> | <code>sudo apt-get install git</code> | ||
Line 25: | Line 25: | ||
<code>cd dolphin-emu</code> | <code>cd dolphin-emu</code> | ||
Later, | Later, to update the local copy run following command and proceed with the following steps.<br/> | ||
<code>git pull origin</code> | <code>git pull origin</code> | ||
Line 35: | Line 35: | ||
<code>cmake ..</code> | <code>cmake ..</code> | ||
Change the install prefix by adding "-D CMAKE_INSTALL_PREFIX=/new/path". Note that this path does not need to be absolute. cmake will complete it to its absolute equivalent. The default prefix is "/usr". This means that the executable will be installed as "/usr/bin/dolphin-emu", the plugins will be installed into "/usr/lib/dolphin-emu", and the shared data files will be installed into "/usr/share/dolphin-emu".<br/> | |||
<br/> | <br/> | ||
From here build and install in the standard make way.<br/> | From here build and install in the standard make way.<br/> | ||
<code>make</code><br> | <code>make</code><br/> | ||
<code>sudo make install</code> | <code>sudo make install</code> | ||
Note that | Note that superuser privileges are needed for the last command.<br/> | ||
<br/> | <br/> | ||
To have the "local" build setup from the deprecated scons build configure the build with the following command.<br/> | |||
<code>cmake -Dbindir=../Binary/Linux -Ddatadir=../Binary/Linux ..</code> | <code>cmake -Dbindir=../Binary/Linux -Ddatadir=../Binary/Linux ..</code> | ||
== Step 4 - Run Dolphin! == | == Step 4 - Run Dolphin! == | ||
Run dolphin from anywhere by typing:<br/> | |||
<code>dolphin-emu</code> | <code>dolphin-emu</code> | ||
If | If the prefix changed and $prefix/bin is not in the path, then precede this with the path to the executable. | ||
== FAQ == | == FAQ == | ||
'''Where can I get help?'''<br> | '''Where can I get help?'''<br/> | ||
Go to the [http://forums.dolphin-emulator.com/ forums]. Lots of Dolphin users use Linux, and they are very experienced with this process. | Go to the [http://forums.dolphin-emulator.com/ forums]. Lots of Dolphin users use Linux, and they are very experienced with this process. | ||
<br> | <br/> | ||
'''My build failed, but I did nothing wrong!''' <br> | '''My build failed, but I did nothing wrong!'''<br/> | ||
Most of the time, any problems in the build process are user error. It's understandable, it is a complicated process and can be quite daunting for a first timer. But sometimes | Most of the time, any problems in the build process are due to user error. It's understandable, it is a complicated process and can be quite daunting for a first timer. But sometimes even with everything right, triple checked, and it's still not working. It's rare, but sometimes a build will just be bugged. But many of Dolphin devs are Linux users, so just wait a day or so, and it will be sorted out. | ||