From 31f719e5a65472eb758bb81a28bfc82150383d25 Mon Sep 17 00:00:00 2001
From: weishaupt <1+weishaupt@noreply.localhost>
Date: Sun, 18 Oct 2026 21:07:30 +0000
Subject: [PATCH] Write README

---
 README.md | 18 +++++++++++++++++-
 1 file changed, 17 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 63070f2..0328871 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,19 @@
 # Narrator
 
-Free text-to-speech in one HTML page. Pick a voice, paste text or load a bloggin.space wiki article, save an mp3. Runs on this computer, no account.
\ No newline at end of file
+Free text-to-speech in one HTML page. Pick a voice, paste in any text (or load a bloggin.space wiki article by name), and save it as an mp3.
+
+Everything runs on your own computer in the browser using the Kokoro voice model. No account, no sign-up, no limits.
+
+## How to use
+
+1. Download Narrator.html and open it in Brave, Chrome or Edge.
+2. The first time, it downloads the voice model (a one-time wait). After that it loads fast.
+3. Pick one of the 28 English voices. Each one has a short description, and you can play a sample.
+4. Paste your text, or type a wiki article name and click Load.
+5. Click Make MP3 and save it.
+
+There is also a "Save subtitles (for Reel)" button that makes a subtitle file timed to the audio, for use with Reel.
+
+## Files
+
+- Narrator.html: the whole app, one file.