Stats notes

ACR

Variables: artist, title, ISRC, score, offset. Identify cuts 12s clips from SoundCloud / hearthis we already host. File Scan POSTs the YouTube URL; ACR downloads the set. Same fields either path. We do not request AI-detection hours.

Invoice Identify → Audio & Video Recognition — Valid Requests — ACRCloud Music — 3rd Party ID Integration

Invoice File Scan → File Scanning — Valid Requests — ACRCloud Music — 3rd Party ID Integration

File Scanning for AI Detection — Valid Hours is leftover container default, not a catalog ask.

Same YouTube URL is not re-POSTed (container reuse). Same offset is not re-Identified (grey acr-miss park). The same release in two sets is two requests — different performances.

The catalog ledger starts with the first enrich after v0.2.264. Divide the ACR dollar line by request / submit totals for a unit rate. Older invoice months are not reconstructable from last-run snapshots. GitHub-hosted Actions bot-wall YouTube — File Scan is the CI path.

Clocks

Clocks come from official YT/SC/hearthis text and ACR fingerprints. 1001 is a community overlay only. No playback has no button — wait for an official full-set upload.

Queues

• Automatic — jobs drain
• Operator — you link or paste
• Automatic + operator — jobs first, leftovers on you

Automated IDs: Catalog enrich Identify + File Scan write artist, title, ISRC, score, and offset. Catalog LLM research writes handles, event socials, home city, track IDs, and cue clocks — each job names its variables and parks partial / empty results so the same row is not retraced. Handle research skips DJs and venues that already have a first-party page to parse. Cue extras stay off unless you set LLM_CUE_EXTRAS. Cue parser apply and track-id fill-null also run on enrich. Each Catalog LLM research run dispatches Pages so this card and the DJ complete list match that run. Last LLM research counts one request per DJ or event sent, then exclusive hit / partial / miss — the same slices as Last enrich. Field fill is a footnote.

Manual IDs: Capture 1001, Suggest ID on a set page, wire official playbacks, and entity-complete pins.

Paid runs

/stats is a static export — it cannot start a run. Open a workflow, then Run workflow.

• Catalog deep refresh drains Automatic queues (handles, artwork, official www, venue thumbs).
• Catalog enrich runs ACR Identify + File Scan on a standing budget.
• Catalog LLM research runs handle / event / quality research on a standing budget, then refreshes /stats (Last LLM card + DJ complete).

Every paid run prints what it researches and a cost estimate before it sends anything. LLM: ≈ $0.77–$2.29 · ~51 calls · Gemini Flash + Search · handles, events, quality (cap 24).