From bda77189f73f3075ef038b89110221832b057a39 Mon Sep 17 00:00:00 2001
From: Michael Wagner <m.wagner@vemcon.de>
Date: Thu, 2 Feb 2023 20:09:44 +0100
Subject: [PATCH] Add udev rule for reading controller without root privileges

---
 70-ps5-controller.rules | 11 +++++++++++
 README.md               | 10 +++++++++-
 2 files changed, 20 insertions(+), 1 deletion(-)
 create mode 100644 70-ps5-controller.rules

diff --git a/70-ps5-controller.rules b/70-ps5-controller.rules
new file mode 100644
index 0000000..771fd4e
--- /dev/null
+++ b/70-ps5-controller.rules
@@ -0,0 +1,11 @@
+# ref.: https://boilingsteam.com/the-dualsense-is-making-even-more-sense/
+# copy this file to /etc/udev/rules.d
+# reload udev rules with:
+#   udevadm control --reload-rules
+#   udevadm trigger
+
+# PS5 DualSense controller over USB hidraw
+KERNEL=="hidraw*", ATTRS{idVendor}=="054c", ATTRS{idProduct}=="0ce6", MODE="0660", TAG+="uaccess"
+
+# PS5 DualSense controller over bluetooth hidraw
+KERNEL=="hidraw*", KERNELS=="*054C:0CE6*", MODE="0660", TAG+="uaccess"
diff --git a/README.md b/README.md
index 5b8f244..7d15618 100644
--- a/README.md
+++ b/README.md
@@ -17,7 +17,15 @@ pip install --upgrade pydualsense
 
 ## Linux
 
-On Linux based system you first need to install the hidapi through your package manager of your system.
+On Linux based system you first need to add a udev rule to let the user access the PS5 controller without requiring root privileges.
+
+```bash
+sudo cp 70-ps5-controller.rules /etc/udev/rules.d
+sudo udevadm control --reload-rules
+sudo udevadm trigger
+```
+
+Then install the hidapi through your package manager of your system.
 
 On an Ubuntu system the package ```libhidapi-dev``` is required.