From 77e3b5175829f4467affd3a8925d2f317de4cf1d Mon Sep 17 00:00:00 2001
From: Adrian Baumgart <adrian@abmgrt.dev>
Date: Sat, 14 Oct 2023 21:37:12 +0200
Subject: [PATCH] added linux udev rules

---
 50-usbdmx.rules |  4 ++++
 README.md       | 27 +++++++++++++++++++++++++++
 2 files changed, 31 insertions(+)
 create mode 100644 50-usbdmx.rules

diff --git a/50-usbdmx.rules b/50-usbdmx.rules
new file mode 100644
index 0000000..4d037d5
--- /dev/null
+++ b/50-usbdmx.rules
@@ -0,0 +1,4 @@
+KERNEL=="hidraw*", SUBSYSTEM=="hidraw", ATTRS{idVendor}=="04b4", ATTRS{idProduct}=="0f1f", MODE="0666"
+KERNEL=="hidraw*", SUBSYSTEM=="hidraw", ATTRS{idVendor}=="16c0", ATTRS{idProduct}=="088b", MODE="0666"
+KERNEL=="hidraw*", SUBSYSTEM=="hidraw", ATTRS{idVendor}=="16d0", ATTRS{idProduct}=="0830", MODE="0666"
+KERNEL=="hidraw*", SUBSYSTEM=="hidraw", ATTRS{idVendor}=="16d0", ATTRS{idProduct}=="0833", MODE="0666"
diff --git a/README.md b/README.md
index f200bf6..1d04199 100644
--- a/README.md
+++ b/README.md
@@ -8,8 +8,35 @@ Send incoming ArtNet signals to the FX5 DMX interface (and other [compatible int
 This application opens an ArtNet receiver, to which various DMX control programs (e.g. ChamSys MagicQ) can send DMX signals to.
 It then forwards these signals to the FX5 USBDMX interface, and therefore opens it up to a variety of programs, not only the few that support it (QLC+, DMXControl).
 
+# Setup on Linux
+
+To use USBDMX-Interfaces on Linux without root privileges you need to add a udev rule:
+
+```bash
+$ sudo cp 50-usbdmx.rules /etc/udev/rules.d/
+# Unplug the interface, then run:
+$ sudo udevadm control --reload-rules
+```
+
+If you're using another interface other than the ones [listed below](#compatible-interfaces), you need to add them to the udev rule manually
+
+```bash
+# Get all usb devices and find your interface
+$ lsusb
+Bus 003 Device 021: ID 16c0:088b Van Ooijen Technische Informatica USB DMX
+[...]
+
+# First copy the existing udev rules-file like mentioned above, then edit:
+$ sudo nano /etc/udev/rules.d/50-usbdmx.rules
+
+# Duplicate the last line and change "idVendor" and "idProduct" to match the ID returned by lsusb
+# In this example:
+KERNEL=="hidraw*", SUBSYSTEM=="hidraw", ATTRS{idVendor}=="16c0", ATTRS{idProduct}=="088b", MODE="0666"
+```
+
 # Compatible interfaces
 
+- [Digital Enlightenment USB-DMX Interface](http://www.digital-enlightenment.de/usbdmx.htm)
 - FX5 DMX Interface (Frank Sievertsen)
 - [Nodle U1](https://www.dmxcontrol.de/interfaces/nodle-u1-interface.html) (DMXControl e.V.)
 - [Nodle R4S](https://www.dmxcontrol.de/interfaces/nodle-r4s-interface.html) (DMXControl e.V.)