How to use the Official GameCube Controller Adapter for Wii U in Dolphin: Difference between revisions

← Older edit

How to use the Official GameCube Controller Adapter for Wii U in Dolphin (view source)

Revision as of 23:39, 18 December 2023

409 bytes added , 18 December 2023

m

highlight the important bit

Flacs

2,231

edits

@@ Line 2: / Line 2: @@
 As of {{revision|4.0-4599}}, Dolphin has built in support for Nintendo's GameCube controller adapters for the Wii U and Switch, the only official USB GameCube adapters available. With Dolphin's implementation, the GameCube controller is auto-configured and calibrated, with full rumble support. Wireless controllers and bongos are supported.
-In addition to the official adapters, third-party adapters that are compatible with the Wii U are also supported. Such third-party adapters generally have a switch for choosing between PC mode and Wii U mode. If your adapter has a switch, you have to set it to Wii U mode before following these instructions. Official Nintendo adapters don't have a switch.
+In addition to the official adapters, third-party adapters that are compatible with the Wii U are also supported. Such third-party adapters generally have a switch for choosing between PC mode and Wii U mode. If your adapter has a switch, you have to set it to '''Wii U mode''' before following these instructions. Official Nintendo adapters don't have a switch.
 = Installation =
@@ Line 8: / Line 8: @@
 Linux support does not require any special drivers, as long as Dolphin was built with libusb support. However, a udev rule must be created to allow access to the device.
-Inside of the location '''/etc/udev/rules.d/''' (or '''/lib/udev/rules.d/''' if making a package), paste the following into the '''51-gcadapter.rules''' file and save it (if the file does not already exist, then create a new empty file with that file name):
+With root privileges, navigate to the location '''/etc/udev/rules.d/''' (or '''/lib/udev/rules.d/''' if making a package) and locate the file '''51-gcadapter.rules''' (if the file does not already exist, then create a new empty file with that file name). Open that file and paste the following into it:
 <code>SUBSYSTEM=="usb", ENV{DEVTYPE}=="usb_device", ATTRS{idVendor}=="057e", ATTRS{idProduct}=="0337", MODE="0666"</code>
-Either restart your PC or reload udev rules with the following terminal command:
+Save and overwrite the existing file, then either restart your PC or reload udev rules with the following terminal command:
 <code>sudo udevadm control --reload-rules</code>
-If you did not restart your PC, then also re-insert the adapter.
+If you did not restart your PC, then also re-insert the adapter. Dolphin should now detect it in the controller settings (refer to [[#Dolphin Setup]] below).
+When using the flatpak version of Dolphin, some Linux distributions will additionally require you to specify access to all devices. This can be done with the <code>--device=all</code> command argument, e.g.:
+<code>/usr/bin/flatpak run --device=all --command=/app/bin/dolphin-emu-wrapper org.DolphinEmu.dolphin-emu</code>.
-Dolphin should now detect it in the controller settings (refer to [[#Dolphin Setup]] below).
+For an alternative GUI-based method, you can install and run [https://flathub.org/apps/com.github.tchx84.Flatseal Flatseal] and then enable "All devices (e.g. webcam)" specifically for Dolphin.
-Flatpak user will have to allow Dolphin access to the adapter with <code>--device=all</code>. <code>/usr/bin/flatpak run --device=all --command=/app/bin/dolphin-emu-wrapper org.DolphinEmu.dolphin-emu</code>
 If you want to change the rule, links for instructions are available on the [https://github.com/libusb/libusb/wiki/FAQ#Can_I_run_libusb_applications_on_Linux_without_root_privilege libusb FAQ].