diff --git a/README.md b/README.md
new file mode 100644
index 000000000000..64f14288f291
--- /dev/null
+++ b/README.md
@@ -0,0 +1,25 @@
+# mpv-modernx (AUR)
+
+This is the AUR package for [ModernX](https://github.com/zydezu/ModernX), a fork of mpv-osc-modern.
+
+## Installation
+
+You can install this package using an AUR helper:
+
+```bash
+paru -S mpv-modernx
+# or
+yay -S mpv-modernx
+```
+
+## Manual Installation
+
+```bash
+git clone https://aur.archlinux.org/mpv-modernx.git
+cd mpv-modernx
+makepkg -si
+```
+
+## Upstream Project
+
+- **GitHub**: [zydezu/ModernX](https://github.com/zydezu/ModernX)