diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1bda6b5
--- /dev/null
+++ b/README.md
@@ -0,0 +1,13 @@
+# Mado
+
+Web front end for [ani-cli](https://github.com/pystardust/ani-cli): search, pick a result,
+pick an episode, watch in the browser. Autoplays the next episode; each account keeps its
+own search history and last-watched episode (with resume position).
+
+## Run
+    pip install -r requirements.txt     # + ani-cli, curl, sed, grep, od, base64/openssl on PATH
+    python app.py                       # http://127.0.0.1:8000
+
+Env vars: `HOST`, `PORT`, `ANIWEB_DATA_DIR` (db + secret key), `ANI_CLI_BIN`, `ANIWEB_HTTPS=1`
+(secure cookies behind HTTPS). Accounts live in `data/mado.db` (SQLite).
+No mpv/fzf needed: the app stands in for them to read ani-cli's results and stream links.
\ No newline at end of file