← Commit history

Add 'How it decides what to show you' scoring section (freshness + novelty + jitter); note every billboard shows its wiki URL + freshness badge.

John Lauer ·a18da28fe5 ·4mo ago ·parent ada17da
1 file changed +16
README.md+16
@@ -44,6 +44,22 @@ After a few minutes the billboards stop (rotating ads make no sense once the scr  ![Adom Screensaver dim mode, the logo drifting on near-black](/blob/app/adom-screensaver/screenshots/dim.png) +Each billboard always shows its **wiki URL** (`wiki.adom.inc/owner/slug`) and a **freshness badge** ("New today", "Updated 3 days ago", and so on), so you instantly know whether you're looking at something new or something that's been around.++---++## How it decides what to show you++Old screensavers loop the same handful of images until you stop seeing them. This one **scores every Wiki drop** and leads with what's **new** and what you **haven't seen**, so the rotation stays interesting instead of replaying stale cards.++Each slide gets a score, and the highest scores play first:++- **Freshness** (from the page's last-updated date): updated in the last **week** = +100, last **month** = +60, last **90 days** = +35, last **year** = +15, older = +5.+- **Novelty** (how many times you've already seen it): never seen = +60, dropping by 20 per view, gone after about three views.+- **A little randomness** (+0 to +12) so the order isn't identical every run and nothing gets stuck at the top or bottom.++So a brand-new drop you've never seen floats to the very top (and wears a teal **"New today"** badge), while something old you've watched ten times sinks to the bottom. Freshness comes from a **lightweight** check of each page's last-updated timestamp, so new content surfaces within minutes, and unchanged heroes are served straight from the local cache without re-downloading.+ ---  ## The clever part: honest, hardware-aware power management