diff --git a/README.md b/README.md
new file mode 100644
index 0000000..40aa02f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,7 @@
+# mpv-scripts
+
+Small collection of personal mpv Lua scripts. Drop any file from `scripts/` into your `~/.config/mpv/scripts/` to enable it.
+
+- `ac-power.lua` — polls Home Assistant for a power sensor and shows wattage in the OSD with debounce/backoff.
+- `kb-blackout.lua` — dims or turns off the keyboard backlight while mpv is playing, restores it on pause/idle/unfocus.
+- `touch-gestures.lua` — tablet-friendly vertical edge swipes: right edge changes system volume (PipeWire/Pulse), left edge changes screen brightness (brightnessctl), with OSD feedback and bottom exclusion to avoid the OSC.