Skip to content

Commit ef9d36c

Browse files
committed
Add udev rules and information on them to the README
Using udev rules is the preferred way of using the software.
1 parent 3a5a7c5 commit ef9d36c

File tree

2 files changed

+39
-1
lines changed

2 files changed

+39
-1
lines changed

90-ratctl.rules

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
# This is a udev rules file. To use it, copy it over to /etc/udev/rules.d/90-ratctl.rules
2+
# (this might change depending on your distribution).
3+
4+
# Saitek Devices
5+
6+
# Cyborg R.A.T.5
7+
SUBSYSTEM=="usb", ATTRS{idVendor}=="06a3", ATTRS{idProduct}=="0cc3", TAG+="uaccess"
8+
# old Cyborg R.A.T.7
9+
SUBSYSTEM=="usb", ATTRS{idVendor}=="06a3", ATTRS{idProduct}=="0ccb", TAG+="uaccess"
10+
# Cyborg R.A.T.3
11+
SUBSYSTEM=="usb", ATTRS{idVendor}=="06a3", ATTRS{idProduct}=="0ccc", TAG+="uaccess"
12+
# Cyborg R.A.T.9
13+
SUBSYSTEM=="usb", ATTRS{idVendor}=="06a3", ATTRS{idProduct}=="0cd7", TAG+="uaccess"
14+
# Cyborg R.A.T.9
15+
SUBSYSTEM=="usb", ATTRS{idVendor}=="06a3", ATTRS{idProduct}=="0cd9", TAG+="uaccess"
16+
# Cyborg R.A.T.9
17+
SUBSYSTEM=="usb", ATTRS{idVendor}=="06a3", ATTRS{idProduct}=="0cfa", TAG+="uaccess"
18+
19+
# Mad Catz Devices
20+
21+
# R.A.T 5
22+
SUBSYSTEM=="usb", ATTRS{idVendor}=="0738", ATTRS{idProduct}=="1705", TAG+="uaccess"
23+
# R.A.T 9
24+
SUBSYSTEM=="usb", ATTRS{idVendor}=="0738", ATTRS{idProduct}=="1709", TAG+="uaccess"
25+
# R.A.T PRO X
26+
SUBSYSTEM=="usb", ATTRS{idVendor}=="0738", ATTRS{idProduct}=="1718", TAG+="uaccess"

README.md

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,10 +27,22 @@ great too.
2727

2828
USAGE
2929
-----
30-
easiest way :
30+
The software needs access to your mouse to work properly. There are multiple
31+
ways to do this.
32+
33+
Easiest (**but insecure**) way :
3134
```Shell
3235
sudo ./ratctl.py
3336
```
37+
Running GUI applications as root is considered dangerous. Thus, the second
38+
method is preferred:
39+
copy the `90-ratctl.rules` over to your udev rules directory (usually
40+
`/etc/udev/rules.d/`, but it might change depending on your distribution).
41+
42+
This file contains rules to make the various R.A.T mice configurable by any
43+
physically logged-in user. A reboot might be required to apply the changes,
44+
but shouldn't be necessary. In most cases, `sudo udevadm control --reload`,
45+
`sudo udevadm trigger`, and replugging your mouse should be enough.
3446

3547
REQUIEREMENTS
3648
-------------

0 commit comments

Comments
 (0)