diff --git a/README.md b/README.md
new file mode 100644
index 0000000..19a4611
--- /dev/null
+++ b/README.md
@@ -0,0 +1,21 @@
+# ANTI-BS
+
+Simple YouTube member-video filter with a whitelist.
+
+## How it works
+
+- Member-only videos are detected and hidden by default.
+- A whitelist lets specific creators stay visible.
+- Add both the display name and the channel link/handle.
+- If you are on a whitelisted channel page (like `https://www.youtube.com/@DaveMani/videos`),
+  nothing is hidden there.
+
+## Whitelist input
+
+- Channel name: the visible name under the video (example: `Dave Mani`)
+- Channel link or @handle: `@DaveMani` or `https://www.youtube.com/@DaveMani/videos`
+
+## Contributing
+
+MRs are allowed but mostly rejected. If you want to propose a change, open an MR
+with a small, focused diff and explain the reason clearly.