Skip to content

Instantly share code, notes, and snippets.

Last active January 14, 2023 21:21
What would you like to do?
[Linux] Simple Guide To Using a PS5 Controller with Chiaki


This guide is meant for those using Linux and wanting to use a PS5 Controller (Dualsense) with Chiaki to enable remote play for PS4/PS5.

Despite the PS5 Controller support added to the 5.12 kernel, I had issues getting it to be recognized by Chiaki.

I've only verified these steps on a PopOS 21.10 (Ubuntu derivative) system, running on 5.16 kernel.

If you have an alternate solution for Linux that worked for you, leave a comment to help others out!

What does this guide provide?

A reliable way of mapping your PS5 controller buttons to keyboard inputs, and then mapping those keyboard inputs to Chiaki.

This works when wired via USB-C, or wirelessly via bluetooth.

What doesn't work, and other oddities.

  • Haptic stuff does not seem to work.
  • Touchpad "button" seems to be recognized even though we can't explicitly map it using AntiMicroX.


Install dependencies

Both Chiaki and AntiMicroX have AppImage's available. AppImageLauncher handles easily integrating AppImages. Or you can run it manually

Map your PS5 Controller to Keyboard Inputs.

Run AntiMicroX (if you don't see it, it's likely running in your OS's "tray").

Your controller should be detected, and you should see inputs from it flashing as you pressed them on the controller.

Start mapping all buttons to keyboard inputs. I suggest avoiding dangerous keys like Delete, modifier keys like ctrl or alt, etc. Once finished, be sure to save them!

Here are mine for example:

res_mappings_1.png res_mappings_2.png

Configure Chiaki's mappings.

Run Chiaki, click the gear to open settings.

Click through each setting, hit the corresponding button on your controller, and it should be set to what you configured in AntiMicroX.

Here's my configuration for example:


That's it. Connect to your PS5 remotely and test it out!

Copy link

cjones26 commented Jan 8, 2023

@ayrton04 remember we also will need to install some dev packages (you may need other ones, as I already may have had some installed):

sudo apt install libxext-dev libsdl2-dev libavutil-dev libavcodec-dev libopus0 libogg0 libopus-dev libssl-dev qtbase5-dev qtchooser qt5-qmake qtbase5-dev-tools qtmultimedia5-dev libqt5svg5-dev

And also there are some third party Git submodules we need to init and update:

git submodule init
git submodule update

Thanks for the tip, though -- I was able to get my PS5 controller working!!

Copy link

zerkz commented Jan 9, 2023

SDL is definitely something I would suggest (and seems future proof). Recently Chiaki got some new updates that allow touchpad / sensor handling via SDL.

I've tried this out on my Steam Deck using Chiaki, and it was beautiful. The gyro sensors integrated great with games like God of War.

Copy link

danfulf commented Jan 14, 2023

Thank you very much all for the input here.

Between @cjones26 and @ayrton04 comments, I now have Chiaki built on Fedora 37 and DualSense is working. Runs so much better than the Windows Official client.

Much appreciated, thank you.

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