[Blackwellcode]

Summary

VOD replay and live chat now show Twitch chat events almost 1:1: subs, resubs, gifted subs, community gifts, pay-forwards, raids, announcements (with colour), bits/cheers, highlighted messages, first messages, replies, power-ups and channel point rewards.

Rendered from chat_emotes.js + style.css with one case each: resub, mystery gift, subgift, raid, BLUE announcement, cheer + first message, reply, highlight, reward, timeout, plus a normal line for comparison.

Changes per file

File	Change
recorder/chat_events.py	irc_command(line) skips tags and prefix and returns the real command. parse_usernotice(tags, message) maps the msg-param-* tags into a {"type": "notice", "kind": ...} event (sub/resub, subgift/anonsubgift, submysterygift, giftpaidupgrade, pay-forward, raid, bitsbadgetier, announcement, viewermilestone, charitydonation, sharedchatnotice → source-msg-id, anon, system). sanitize_event validates notices with a strict allowlist: kind ^[a-z0-9_-]{1,40}$, plan/color from fixed sets, ints > 0 and capped, text fields whitespace-normalised and cut to 80 characters (system-msg 300), unknown fields dropped. parse_privmsg_meta / sanitize_meta handle bits, highlight, first, reply {user, msg ≤ 140} and power.
recorder/Streamrecorder.py	The IRC loop routes on irc_cmd == 'PING' / 'CLEARCHAT' / 'CLEARMSG' / 'USERNOTICE' / 'PRIVMSG'. A message text like CLEARCHAT #x is no longer misrouted. USERNOTICE is written through append_chat_log (live log + session log with rel), with emotes, badges and colour taken from process_twitch_message. PRIVMSG entries get an optional meta.
core/tts_bot.py	Second IRC reader: parse_privmsg now checks the command token instead of " PRIVMSG " in rest, so a USERNOTICE whose text contains "PRIVMSG" no longer triggers TTS.
WEBUI/webui.py	format_notice_text(event, user) builds Twitch-style headlines with Flask-Babel (gettext/ngettext) and falls back to event.system for unknown kinds. chat_item_from_row sets event.text, never sends system, and passes meta through. The duplicate token for notices includes kind and the notice text, so several gift subs from one gifter to different recipients stay separate. VOD chat chunks (?chunk=N) used to send the raw JSONL rows unfiltered. They now go through chat_item_from_row with the same duplicate check, served as private, max-age=600 with Vary: Cookie, Accept-Language because the text depends on the locale.
WEBUI/static/chat_emotes.js	renderNoticeHtml (header with an SVG icon per group sub/gift/raid/announcement/bits/other, then badges, name in the user's colour and the message with emotes). chatLineClassName adds `chat-line-notice[-
WEBUI/static/style.css	Notices: 4px #9147ff left border on a light purple background. Announcement border-image gradients: BLUE #00d6d6→#9146ff, GREEN #00db84→#57bee6, ORANGE #ffb31a→#e0e000, PURPLE/PRIMARY #9146ff→#ff75e6. Highlight #755ebc, first message, reply context, cheer tiers, gigantified/animated power-ups.
WEBUI/templates/vod.html, live.html, mobile_player.html, twitch_watch_chat.js.html, chat_obs.html	Call decorateLine after .chat-msg is filled and use chatEventKey in the duplicate keys. The VOD text filter also searches event.text, and notices stay visible under badge filters. chat_obs.html gets the notice classes and inline styles. It also fixes two bugs on lines this PR already touches: renderBadgesHtml got the array instead of the item, and userColor got the user name, so the overlay showed no badges and no name colours.
WEBUI/i18n.py, WEBUI/translations/*	New JS strings registered in JS_MESSAGES. 26 new msgids are translated in all 11 catalogs (pl with 3 plural forms; ja, ko, zh_Hans and tr with 1). .po and .mo are committed. Catalogs were updated with --no-wrap to match the existing unwrapped .po files; the .pot uses the standard extract.
tests/test_chat_events.py	28 new tests (see below).
docs/screenshots/chat_twitch_events.png	Screenshot above.

Limits

• Channel points rewards WITHOUT text input do not arrive over IRC. They would need EventSub channel.channel_points_custom_reward_redemption.add with broadcaster authorisation. This PR only documents that and does not implement it. Rewards with text input keep working as before (custom-reward-id on PRIVMSG).
• Existing VOD logs contain no USERNOTICE data. The new display only applies to recordings made after deploying the recorder change. Old logs render as before.
• Reply messages keep Twitch's leading @parent mention in the body. Removing it would shift the native emote offsets.
• Moderation lines (format_moderation_message) are still German strings from the recorder. That predates this PR and is unchanged here.

Test plan

• python -m unittest discover -s tests -p "test_*.py" → Ran 206 tests, OK (skipped=1), exit 0 (178 existing + 28 new)
• python -m compileall -q core recorder WEBUI bin run_transcribe.py tests → exit 0
• uvx ruff@0.17.3 check . → All checks passed!
• node --check WEBUI/static/chat_emotes.js → exit 0
• python -m py_compile on every changed .py file → exit 0
• python scripts/check_translations.py → 11 locales, 1109/1109 translated, 0 problems each
• Visual check: a temporary local page (deleted afterwards) loaded chat_emotes.js + style.css; screenshot above, no console errors

New tests cover: irc_command (USERNOTICE; PRIVMSG with "CLEARCHAT #x" in the text; PING), resub with message and streak, subgift with sender_count, anonymous submysterygift, raid (displayName/viewerCount), announcement colour, unknown kind → system-msg, invalid kind → None, sanitize_event dropping bad plan/color/negative numbers/foreign fields, parse_privmsg_meta (bits/first/highlight/reply; first-msg=0 → None), the TTS bot routing, process_twitch_message on USERNOTICE, and API tests where two gift subs from one gifter return 2 items with the recipients in event.text, no system, and meta passed through (range API and chunk API).

Design pass (commit 50f9ad4)

Checked in all five themes (vault, aurora, cyber, ember, ocean), the VOD/live grid at 360 px, mobile at 375 px and the OBS overlay.

• Twitch colours are now --sv-* tokens; text colours come from the theme (--tube-*).
• Contrast (WCAG AA): Twitch's bits tier colours failed as text on dark backgrounds (tier 100 2.58:1, 10000 3.20:1, 5000 4.22:1, 1 4.34:1). The text tints are the same hues lightened to at least 4.5:1. Measured in the browser on rendered colours, worst case over all themes: notice text 17.37, reply context 8.10, first-message label 7.19, bits 6.09, highlight text 12.96.
• The reply context uses --tube-text-2 instead of --tube-muted (3.78:1 in cyber).
• Notice headers align with the timestamp. The templates' empty badge and name slots added an empty line above the header.
• A notice without badges no longer renders an empty badge wrapper, which caused a stray indent.
• OBS overlay: same tokens, plus first message, power-ups and the points/timeout pills that rendered as plain text.

Merge with master (commit 8083a46)

• webui.py: keeps master's blueprint import, and chat_vod now registers on vod_bp with the sanitized chunk serving.
• de/messages.mo is rebuilt.
• The catalogs are re-synced. Two login messages that master changed had stale translations in 10 locales; they are now translated.
• After the merge: Ran 338 tests, OK (skipped=20), ruff and compileall exit 0, check_translations 0 problems.

🤖 Generated with Claude Code