diff --git a/README.md b/README.md
index 10499b7..e448614 100644
--- a/README.md
+++ b/README.md
@@ -1,25 +1,24 @@
-# Sublogue
+
-Sublogue is a lightweight tool for adding plot summaries and metadata to subtitle files.
+

-It takes an existing .srt, pulls data from OMDb, TMDb, and TVMaze, and inserts a short plot block at the start of the file — without altering any existing timings or dialogue.
+
Your subtitles deserve metadata. Sublogue adds it.
-If you’ve ever opened a movie or episode and thought “wait… what was this again?”, Sublogue quietly solves that.
+
-## Features
+Sublogue is a lightweight open-source tool for enriching SRT files. Pull metadata from OMDb, TMDB, or TVMaze and automatically append plot summaries, runtimes, directors, and cast details to the start or end of your subtitles.
-- Inserts a plot summary at the beginning of an existing `.srt`
-- Automatically fetches metadata (OMDb, TMDb, TVMaze fallback)
-- Never alters existing dialogue timing
-- Handles long plots without breaking readability
-- Clean web UI (Svelte + Vite)
-- Fast Python backend (Flask + aiohttp)
-- Docker image available through GHCR
+## Core Features
+- Insert plot summaries into existing `.srt` files without shifting timings
+- Fetch metadata from OMDb, TMDb, and TVMaze
+- Add runtime, director, cast, and ratings to subtitle headers
+- Preserve original dialogue and timing with safe insertion logic
+- Clean, fast web UI for scanning and batch processing
+- Docker-first deployment with persistent storage
-## Deployment
+## Getting started
-