Installing Dolphin: Difference between revisions
(Updated the Ubuntu install procedure.) |
(Ubuntu's repo maintenance is a bit odd.) |
||
Line 47: | Line 47: | ||
===Ubuntu=== | ===Ubuntu=== | ||
As of | 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>. | ||
The Universe repositories provide versions of Dolphin for amd64 (a.k.a. x64 or 64-bit) and arm64 (a.k.a. ARMv8-A). | The Universe repositories provide versions of Dolphin for amd64 (a.k.a. x64 or 64-bit) and arm64 (a.k.a. ARMv8-A). | ||
[https://launchpad.net/ubuntu/+source/dolphin-emu Ubuntu Launchpad] and [https://packages.ubuntu.com/search?keywords=dolphin-emu&searchon=names&suite=all§ion=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. | |||
====Older Ubuntu versions==== | ====Older Ubuntu versions==== | ||
Line 64: | Line 66: | ||
=== 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]]. | ||
Revision as of 06:33, 28 February 2024
This page explains how to install or upgrade Dolphin on computer running on different OS. Read the FAQ for more Dolphin information and requirements.
Profile-breaking Notices
Please check these before updating your Dolphin setup to avoid the Dolphin profile incompatibilities between versions, with the exception of performing the first time Dolphin setup.
- Older save states may not work between versions. Be sure to save your game progress the normal way in-game before updating.
- Since 3.5-2381, Dolphin for Windows now uses the Global User Directory.
- GameINI: Since 4.0-8581,
FrameLimit = 0x00000001
superseded byEmulationSpeed = 1.00000000
. View the all-new values at GameINI#Emulation Speed (formerly Framelimit)
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 Download page and extract it into a new folder (preferably named after the revision) or to replace an existing Dolphin setup.
macOS Security Restrictions
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 issue is fixed by 5.0-14529.
Before this revision, a temporary fix is to run two commands into Terminal:
sudo xattr -r -d com.apple.quarantine /path/to/Dolphin.app sudo xattr -r -d com.apple.quarantine /path/to/Dolphin\ Updater.app
Linux
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: # pacman -S dolphin-emu
See also the AUR and read more on the ArchWiki.
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: # sudo apt install dolphin-emu
See further package information on the Debian Package Info page.
openSUSE Linux
Install from the software page for dolphin-emu, or use the following code:
zypper ar http://download.opensuse.org/repositories/Emulators/openSUSE_Tumbleweed/Emulators.repo zypper ref zypper in dolphin-emu
Ubuntu
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 sudo apt install dolphin-emu
.
The Universe repositories provide versions of Dolphin for amd64 (a.k.a. x64 or 64-bit) and arm64 (a.k.a. ARMv8-A).
Ubuntu Launchpad and 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.
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 sudo apt-add-repository ppa:dolphin-emu/ppa
, whose PPA also offered sudo apt install dolphin-emu-master
.
However, the PPA is no longer active as of 28 February 2024.
Fedora
On Fedora 24 and later, run the following command:
# dnf install dolphin-emu
Required dependencies will automatically be installed. See also the Fedora Package Database.
Other Distros
- Dolphin on Flathub.
- Dolphin on Snap Store (amd64 only as of 28 February 2024).
Other GNU/Linux users have to build and install from source code.
Post-Installation Quick Guide
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.
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.
Browsing Files
You can simply launch a compatible file by hitting File > Open... then open a file. To add a game to the game list, select Files > Browse for ISOs... then select a folder to be added to the game list.
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
File extension | Platform | Notes |
---|---|---|
.ISO | GameCube and Wii | Generic file extension for disc image files. |
.GCM | GameCube | This file extension is interchangeable with .ISO. |
.GCZ | GameCube and Wii | Compressed GameCube/Wii disc image file. |
.WBFS | Wii | "Wii Backup File System", compressed Wii disc image file. |
.WIA | Wii | "Wii ISO Archive", compressed or uncompressed Wii disc image file. Available since 5.0-12188. |
.RVZ | Gamecube and Wii | Compressed GameCube/Wii disc image file. This specifically works in Dolphin. Available since 5.0-12188. |
.WAD | Virtual Console and WiiWare | |
.DOL, .ELF | Homebrew app |
Managing Game List
You can also batch add/remove titles in the game list by creating folders that group each titles by platform (this is to keep game directories well organized), then go to Options > Configure... > "Paths" tab > then hit Add... then enable Search SubFolders within the "Paths" config, then add these folders to the ISO Directories list.