Skip to content

Instantly share code, notes, and snippets.

@zerkz
Last active January 31, 2025 06:55
Show Gist options
  • Save zerkz/6987e322882851d47b89ecd84dbc5b0f to your computer and use it in GitHub Desktop.
Save zerkz/6987e322882851d47b89ecd84dbc5b0f to your computer and use it in GitHub Desktop.
[Linux] Simple Guide To Using a PS5 Controller with Chiaki

Overview

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.

If you're using a Steam Deck, check out the great chiaki4deck project instead.

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.

Guide

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:

res_chiaki_config.png

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

@oheyek
Copy link

oheyek commented Oct 17, 2024

how can i actually connect dualsense to chiaki without cable? i used to using remote play windows app and there was a trick with 2nd acc, in chiaki it doesnt work.

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