Big changes

README.md

@@ -13,6 +13,9 @@ tracks during playback. The screensaver (Dream) code remains isolated from the c
 - **In-app playback** with Media3/ExoPlayer (movies play directly; a series plays its
   next-up / first episode).
 - **Favorites** managed through the Emby API and shown on the home screen.
+- A dedicated **For You** destination, shaped by Tracearr completion/device history,
+  Memby browsing signals and a viewer-selected 30/60/120-minute time window. Every pick
+  says why it was chosen and whether it has direct-play evidence on that television.
 
 ## Tech stack
 
@@ -93,6 +96,15 @@ new episodes), composes the home rows — including "Recommended from your watch
 history" — and has an admin page at `/admin/` for imports, an offline switch, and
 per-row engagement.
 
+For Tracearr-powered recommendations, create a read-only public API key in Tracearr and
+set `MEMBY_TRACEARR_URL` plus `MEMBY_TRACEARR_API_KEY` on the gateway (and optionally
+`MEMBY_TRACEARR_SERVER_ID` when Tracearr monitors several servers). Tracearr credentials
+remain server-side; the Android app only receives ranked Emby items and short reasons.
+The gateway imports compact session signals into Postgres every five minutes and prepares
+an over-provisioned per-user pool, so opening For You normally performs one indexed
+database read. The live on-demand path remains available for cold starts and failed
+rebuilds.
+
 ## Server address
 
 Memby is built for one Emby server, so the address is baked into the APK instead of being