Installing Dolphin: Difference between revisions

Added an Android section too while I was at it.
(→‎Windows and Mac: Added info about macOS Security Workaround)
(Added an Android section too while I was at it.)
 
(6 intermediate revisions by 2 users not shown)
Line 12: Line 12:
=== macOS Security Restrictions ===
=== macOS Security Restrictions ===
When downloading Dolphin for the first time, you may experience crashes or the Dolphin Updater will fail.
When downloading Dolphin for the first time, you may experience crashes or the Dolphin Updater will fail.
This may be caused by Gatekeeper, because it moved Dolphin to a "quarantined" location for security. See {{issue|12105}}.
This may be caused by Gatekeeper, because it moved Dolphin to a "quarantined" location for security. See {{issue|12105}}.  
While a fix is being made ({{Pull Request|8915}}), a temporary fix is to run two commands into Terminal:
This issue is fixed by {{Revision|5.0-14529}}.
 
Before this revision, a temporary fix is to run two commands into Terminal:


<pre>
<pre>
Line 44: Line 46:
</pre>
</pre>
   
   
=== Ubuntu ===
===Ubuntu===
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] needs to be enabled first).
As of 18.04LTS, possibly some time prior, Dolphin is available in Ubuntu's own package repository, so if Ubuntu's Universe repositories have been enabled first, users can run <code>sudo apt install dolphin-emu</code>.
 
This applies to '''all''' [https://distrowatch.com/search.php?basedon=Ubuntu Ubuntu-based distributions].
 
Install the '''stable version''':
 
<pre>sudo apt-add-repository ppa:dolphin-emu/ppa
sudo apt update
sudo apt install dolphin-emu</pre>


Or to install the '''development version''':
The Universe repositories provide versions of Dolphin for amd64 (a.k.a. x64 or 64-bit) and arm64 (a.k.a. ARMv8-A).


<pre>sudo apt-add-repository ppa:dolphin-emu/ppa
[https://launchpad.net/ubuntu/+source/dolphin-emu Ubuntu Launchpad] and [https://packages.ubuntu.com/search?keywords=dolphin-emu&searchon=names&suite=all&section=all Ubuntu's package search] as of 28 February 2024, lists Dolphin versions (though not necessarily recent Dolphin updates) for 14.04 LTS, 16.04 LTS, 18.04 LTS, and 20.04 LTS, but claims to only supports 23.04 and 23.10 among stable Ubuntu versions.
sudo apt update
sudo apt install dolphin-emu-master</pre>


'''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:
====Older Ubuntu versions====
 
At one point, Dolphin had its own Ubuntu PPA (which also applied to all Ubuntu-based distributions) that could be added to the ''apt'' fetch list with <code>sudo apt-add-repository ppa:dolphin-emu/ppa</code>, whose PPA also offered <code>sudo apt install dolphin-emu-master</code>.
<pre>
sudo apt-add-repository ppa:ubuntu-toolchain-r/test
sudo apt update
</pre>


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.
However, the PPA is no longer active as of 28 February 2024.


=== Fedora ===
=== Fedora ===
Line 76: Line 64:


Required dependencies will automatically be installed. See also the [https://admin.fedoraproject.org/pkgdb/package/rpms/dolphin-emu/ Fedora Package Database].
Required dependencies will automatically be installed. See also the [https://admin.fedoraproject.org/pkgdb/package/rpms/dolphin-emu/ Fedora Package Database].
=== Windows Subsystem for Linux 2 ===
The above guides for specific distros apply. However, WSL2 does not natively include a Linux desktop environment nor X11/Wayland as of 16 March 2024, and relies on spotty VNC implementations (whether built-in or third-party), so installing Dolphin in WSL2 requires advanced Linux expertise.


=== Other Distros ===
=== Other Distros ===
*[https://flathub.org/apps/org.DolphinEmu.dolphin-emu Dolphin on Flathub].
*[https://snapcraft.io/dolphin-emulator Dolphin on Snap Store] (amd64 only as of 28 February 2024).
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]].
==Android==
Provided as a standard installable APK, available from Dolphin's download pages, from [https://play.google.com/store/apps/details?id=org.dolphinemu.dolphinemu Google Play Store], and from [https://f-droid.org/packages/org.dolphinemu.dolphinemu/ F-Droid].
As of 16 March 2024, the APK natively supports both ARM64-v8A and amd64; older devices that depend on ARMv7 (ARM 32-bit) will not be able to run Dolphin.
Devices need to support OpenGL buffer storage to run Dolphin in a playable state. This excludes ''Windows Subsystem for Android'' as of 16 March 2024, among others.


== Post-Installation Quick Guide ==
== Post-Installation Quick Guide ==