diff --git a/xremap/README.md b/xremap/README.md
new file mode 100644
index 0000000..c46116b
--- /dev/null
+++ b/xremap/README.md
@@ -0,0 +1,16 @@
+Setup:
+
+1. install xremap
+2. run these commands:
+```sh
+echo 'KERNEL=="uinput", GROUP="input", TAG+="uaccess"' \
+    | sudo tee -a /etc/udev/rules.d/99-input.rules
+echo 'uinput' \
+    | sudo tee -a /etc/modules-load.d/uinput.conf
+sudo usermod -aG input <user>
+```
+3. reboot
+4. run xremap with:
+```sh
+xremap ~/repos/dotfiles/xremap/<config>.yml --device '<device_name>'
+```
diff --git a/xremap/osrs.yml b/xremap/osrs.yml
new file mode 100644
index 0000000..b8fe823
--- /dev/null
+++ b/xremap/osrs.yml
@@ -0,0 +1,12 @@
+modmap:
+  - name: OSRS Runelite
+    application:
+      only: net-runelite-client-RuneLite
+    remap:
+      BTN_RIGHT:
+        held: BTN_MIDDLE
+        alone: BTN_RIGHT
+        alone_timeout_millis: 100
+        exact_match: true
+    device:
+      only: 'Logitech USB Receiver'