Skip to content

Instantly share code, notes, and snippets.

@ammuench

ammuench/8BitDoUltimateWifi_Linux.MD

Last active April 18, 2025 12:51
Show Gist options
  • Save ammuench/0dcf14faf4e3b000020992612a2711e2 to your computer and use it in GitHub Desktop.
Save ammuench/0dcf14faf4e3b000020992612a2711e2 to your computer and use it in GitHub Desktop.
Download ZIP
8BitDo Ultimate 2.4GHz wifi working in linux
Raw
8BitDoUltimateWifi_Linux.MD

FROM https://www.reddit.com/r/Fedora/comments/zmvkdj/8bitdo_ultimate_bluetooth_controller_working_in/

I've bought this new controller from 8BitDo and wished to use on linux, to my sadness the controller didn't work out of the box, neither by cable, the 2.4G dongle or bluetooth.

So I've tried a number of solutions and this one from u/GodOfEmus over in the 8bitdo community was the one to work for me:

  1. Create a new file /etc/udev/rules.d/99-8bitdo-xinput.rules
  2. Paste this udev rule in there, then save and exit the file:
  ACTION=="add", ATTRS{idVendor}=="2dc8", ATTRS{idProduct}=="3106", RUN+="/sbin/modprobe xpad", RUN+="/bin/sh -c 'echo 2dc8 3106 > /sys/bus/usb/drivers/xpad/new_id'"
  1. Run the following command in a terminal: sudo udevadm control --reload
  2. Unplug and replug the controller if it was already plugged in, it might take a second if you have the bluetooth version

It will basically "cheat" the OS to see the controller as an generic xbox device, so sadly no bluetooth nor gyro control if you care about that, but the rumbling is working for me.

Link to the original post: https://www.reddit.com/r/8bitdo/comments/ykdsmv/ultimate_24_ghz_model_right_analog_not_working_in/

And link to the comment of u/GodOfEmus with the solution: https://www.reddit.com/r/8bitdo/comments/ykdsmv/comment/iv48s4k/?utm_source=share&utm_medium=web2x&context=3

Sharing this solution here to spread the word in our community

@YogSottot
Copy link

YogSottot commented Mar 13, 2025 •
edited
Loading

You can also try using this drivers instead of xpad
https://github.com/atar-axis/xpadneo or
https://github.com/medusalix/xone/

@Axlefublr
Copy link

@ammuench, thank you so much for making this guide! I just bought 8bitdo ultimate 2c, and was kinda hoping it'd just work out of the box, so I got scared when it didn't :c found this gist and got hope!... but it didn't work anyway... \ but that's where @gemantzu came in! I just blindly copy pasted the udev rule, but didn't think to check my model number! mine was 81HD (it's on the back of the controller). changed 3106 in both places in the udev rule to that, reloaded, and the controller worked!! :D thank you both!!

@asoltesz
Copy link

On OpenSUSE Tumbleweed, KDE Plasma, Wayland (2025-MAR-26 update level), the 8bitdo Ultimate (2.4 Ghz+BT) worked out of the box with the 2.4 Ghz USB dongle in Steam, no extra configuration was needed.

When switching the Controller to Bluetooth mode and paired, it is recognized as a keyboard and it doesn't work at all in Steam or elsewhere.

@barraIhsan
Copy link

Is there someone who use the new 8Bitdo Ultimate 2 Wireless? Does the rumble/vibration work on linux? What about the extra button?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment