Installing Dolphin: Difference between revisions

Jump to navigation Jump to search
no edit summary
No edit summary
No edit summary
(28 intermediate revisions by 15 users not shown)
Line 1: Line 1:
This page explains how to install or upgrade Dolphin on computer running on different OS. Read the [https://dolphin-emu.org/docs/faq/ FAQ] for more Dolphin information and requirements.
== Windows and Mac ==
== Windows and Mac ==
Installing or upgrading process for Dolphin on Windows PC or Mac is pretty simple. Download the latest revision or version from the [https://dolphin-emu.org/download/ Download] page and extract it into a new folder (preferably named after the revision) or to replace an existing Dolphin setup, and you're good.
Installing or upgrading process for Dolphin on Windows PC or Mac is pretty simple. Download the latest revision or version from the [https://dolphin-emu.org/download/ Download] page and extract it into a new folder (preferably named after the revision) or to replace an existing Dolphin setup, and you're good.
Line 4: Line 6:
*The older save states may not work between versions.
*The older save states may not work between versions.


If you're running Dolphin for the first time, it will create new user folder: <var>%userprofile%\Documents\Dolphin Emulator\</var>.
== Linux ==
*If you want to use old GameCube Memory Card files, place them under <var>\GC\</var>.
 
*Wii NAND dumps should be placed under <var>\Wii\</var>. This is optional. You may want to check how to dump your own NAND backup here: [[NAND Usage Guide]].
Ready to use packages for a range of Linux distributions are available from Open Build Service: https://software.opensuse.org/package/dolphin-emu
 
=== Arch Linux ===
Install: <code># pacman -S dolphin-emu</code>
 
See also the [https://aur.archlinux.org/packages/?O=0&K=dolphin-emu AUR] and read more on the [https://wiki.archlinux.org/index.php/Dolphin_emulator ArchWiki].


'''Problems?''' try the [http://dolphin-emu.org/docs/faq/ FAQ] before asking questions in the forums.
=== Debian ===
Dolphin is available in the repositories of the "testing" and "sid" branches of Debian, for AMD64 and ARM64 platforms.
'''NOTICE''': Users of Jessie or any earlier versions MUST build from source as per the instructions linked below in "Other Distros"!
 
Install: <code># apt install dolphin-emu</code>
 
See further package information on the [https://packages.debian.org/search?suite=all&section=all&arch=any&searchon=names&keywords=dolphin-emu Debian Package Info page].


== Linux ==
=== Ubuntu ===
=== Ubuntu ===
Ubuntu 15.04 "Vivid" users can just download and install a Debian binary (.deb) from the [https://dolphin-emu.org/download/ download site]. The PPA below has packages to 15.04 too.
Ubuntu users can add a '''PPA''' by executing the following commands to receive updates for Dolphin ([https://askubuntu.com/questions/148638/how-do-i-enable-the-universe-repository '''Universe''' repository] is needed to be enabled first).


Users of other versions must add a '''PPA''' by executing the following commands to receive updates for Dolphin ([http://askubuntu.com/questions/148638/how-do-i-enable-the-universe-repository '''Universe''' repository] is needed to be enabled first).
This applies to '''all''' [https://distrowatch.com/search.php?basedon=Ubuntu Ubuntu-based distributions].


This applies to '''all''' [http://distrowatch.com/search.php?basedon=Ubuntu Ubuntu-based distributions].
Install the '''stable version''':


Install the stable version:
<pre>sudo apt-add-repository ppa:dolphin-emu/ppa
sudo apt update
sudo apt install dolphin-emu</pre>


<pre>sudo add-apt-repository ppa:dolphin-emu/ppa
Or to install the '''development version''':
sudo apt-get update
sudo apt-get install dolphin-emu-master</pre>


Or to install development versions:
<pre>sudo apt-add-repository ppa:dolphin-emu/ppa
sudo apt update
sudo apt install dolphin-emu-master</pre>


<pre>sudo add-apt-repository ppa:dolphin-emu/ppa
'''NOTICE''': '''14.04 LTS''' users will need an updated '''libstdc++6''' (>=4.9) to run dolphin-emu or dolphin-emu-master, so install [https://launchpad.net/~ubuntu-toolchain-r/+archive/ubuntu/test this PPA] first:
sudo apt-get update
sudo apt-get install dolphin-emu</pre>
 
'''NOTICE''': '''12.04''' and '''14.04''' users will need an updated '''libstdc++6''' (>=4.9) to run dolphin-emu or dolphin-emu-master, so install [https://launchpad.net/~dolphin-emu/+archive/ubuntu/gcc-for-dolphin this PPA] first:


<pre>
<pre>
sudo add-apt-repository ppa:dolphin-emu/gcc-for-dolphin
sudo apt-add-repository ppa:ubuntu-toolchain-r/test
sudo apt-get update
sudo apt update
</pre>
</pre>


This PPA uses the same packages of [https://launchpad.net/~ubuntu-toolchain-r/+archive/ubuntu/test Ubuntu Toolchains PPA], so you can install that instead. You don't need to update all GCC packages, just upgrade libstdc++6, gcc-4.9-base and eventual dependencies in Synaptic, and disable the PPA.
You don't need to update all GCC packages, just upgrade libstdc++6, gcc-4.9-base and eventual dependencies in Synaptic, and disable the PPA.


=== Arch Linux ===
=== Fedora ===
Install: <code># pacman -S dolphin-emu</code>
On Fedora 24 and later, run the following command:
 
<code># dnf install dolphin-emu</code>


See also the [https://aur.archlinux.org/packages/?O=0&K=dolphin-emu AUR] and read more on the [https://wiki.archlinux.org/index.php/Dolphin_emulator ArchWiki].
Required dependencies will automatically be installed. See also the [https://admin.fedoraproject.org/pkgdb/package/rpms/dolphin-emu/ Fedora Package Database].


=== Other Distros ===
=== Other Distros ===
Other GNU/Linux users have to [[Building Dolphin on Linux|build and install from source code]].
Other GNU/Linux users have to [[Building Dolphin on Linux|build and install from source code]].


== Post-Installation Tips ==
== Post-Installation Quick Guide ==
In most cases, the default settings works fine, but you will likely need to [[Configuring Controllers|configure controllers]]. If you want to tweak emulation performance and/or quality setting, the [[Performance Guide]] can help you.
In most cases, the default settings works fine, but [[Configuring Controllers]] is the first part that comes into mind that is more than likely needed to be configured.
 
If you would like to learn how to rip games and saves to your new Dolphin set up, see [[Ripping Games]]. For Wii NAND dump, see [[NAND Usage Guide]]. The homebrew apps are freely available over the internet and can be added to the game list at any time.
 
=== Customizing User Interface ===
Go to Options > Configure... > "Interface" tab to customize UI the way you want for your Dolphin set up. Items shown can be toggled on/off on the "View" menu.
 
==== Custom Dolphin Themes ====
[https://forums.dolphin-emu.org/Thread-custom-dolphin-themes Custom Dolphin Themes forum thread]


Import custom themes to:
See [[Ripping Games]] to learn how to rip games and saves to your new Dolphin set up. For complete Wii NAND dump to use on Dolphin, see [[NAND Usage Guide]]. The homebrew apps are freely available over the internet and can be added to the game list at any time.
*'''Linux''': <var>./.dolphin-emu/Themes/</var>
*'''OS X''': <var>~/Library/Application\ Support/Dolphin/Themes/</var>
*'''Windows''': <var>%userprofile%\Documents\Dolphin Emulator\Themes\</var>


=== Browsing Files ===
=== Browsing Files ===
Line 68: Line 69:
Banners for Wii games will not load at first. Making a save file for that game fixes it. This is a limitation with the format of Wii games rather than a bug.
Banners for Wii games will not load at first. Making a save file for that game fixes it. This is a limitation with the format of Wii games rather than a bug.


==== Compatible files by file extension ====
==== Compatible Files by File Extension ====
{| class="wikitable"
{| class="wikitable"
|-
|-
Anonymous user

Navigation menu