From 4e90c445f7adbf0c258241757954d5549222c57a Mon Sep 17 00:00:00 2001
From: Giovanni Harting <539@idlegandalf.com>
Date: Fri, 5 Dec 2025 01:11:02 +0100
Subject: [PATCH] docs: add brief descriptions for scripts

---
 README.md | 7 +++++++
 1 file changed, 7 insertions(+)
 create mode 100644 README.md

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.