WildDragonLLC/teamsiso
1
0
Fork 0
Code Issues 1 Pull requests Projects Releases 1 Packages Wiki Activity Actions
teamsiso/CHANGELOG.md
Zac Gaetano 3f71a4f29a
Some checks failed
CI / build-and-test (push) Failing after 27s
Details
docs: CHANGELOG + _NEXT.md reflect today's 'I only see TeamsISO' batch
2026-05-10 20:48:58 -04:00

16 KiB
Raw Blame History

Changelog

All notable changes to TeamsISO are documented here. The format follows Keep a Changelog and this project adheres to Semantic Versioning.

Unreleased

Added — May 2026 feature batch

Engine

  • NDI Groups: discovery + sender support so Teams' raw broadcasts can be pinned to a private "teamsiso-input" group while TeamsISO's own normalized outputs broadcast on Public.
  • One-click "Apply transcoder topology" writes ndi-config.v1.json so all Teams broadcasts go to the private group and TeamsISO re-emits on Public.
  • RawBgraRecorderSink per-output recorder: IRecorderSink interface + raw BGRA stream + manifest.json + convert.cmd script for FFmpeg conversion to H.264 MKV.
  • Recording markers: IRecorderSink.AddMarker(label) fan-out via IIsoController.AddRecordingMarker. Markers land in manifest.json under markers[] for post-production chaptering.
  • Preview thumbnails: IsoPipeline.LatestProcessedFrame published via Volatile.Read so the UI can render 160×90 BGRA thumbnails in the participants DataGrid at 1Hz.
  • Idempotent ParticipantTracker.HandleAdded: re-emitting Added for an already-live source refreshes LastSeen instead of duplicating the row. Fixes the "click Refresh and rows ghost-duplicate" bug introduced by the Refresh-Discovery affordance.
  • IIsoController.RefreshDiscovery() rebuilds the NDI finder on the next poll tick — useful right after applying a new transcoder topology.
  • IIsoController.AddRecordingMarker(label) fan-out to every active recorder.
  • IIsoController.SetRecording(enabled, dir) global recording toggle; per-participant override via EnableIsoAsync(...recordOverride...).

Host (WPF)

  • Active Speaker as a synthetic routable participant with deterministic v5 GUID derived from auto-mix:<machine>.
  • Auto-disable on departure: when a participant's NDI source disappears, optionally tear down their pipeline.
  • Operator presets: chromeless Presets… dialog with Save / Apply / Delete / Duplicate / Export / Import. Persisted at %LOCALAPPDATA%\TeamsISO\presets.json. Bundle format teamsiso-presets-bundle/v1 for migration between machines.
  • Auto-apply last preset on launch (configurable, off by default).
  • --apply-preset NAME CLI flag for desktop-shortcut workflows.
  • PresetApplier — single source of truth for "apply preset to live participants" used by the dialog, REST surface, and auto-apply path.
  • Live preview thumbnails per participant (160×90 BGRA WriteableBitmap).
  • Right-click context menu on participant rows: Toggle ISO, Record-this- participant, Copy NDI source name.
  • Live filter input (substring match on display name).
  • "Enable all online" + "Stop all ISOs" + "Refresh" header actions.
  • Per-participant recording opt-out checkbox (Rec column).
  • Custom NDI output name template with {name}/{guid}/{machine}/ {timestamp} tokens.
  • Phase E.1 — Launcher: rail "Launch / Stop Teams" toggle.
  • Phase E.2 — Window orchestration: hide / show Teams windows from the rail.
  • Phase E.3 — In-call controls (UIA): Mute, Camera, Share, Leave, Raise hand, plus PostMessage shortcut forwarding fallback. Candidate names localized for English / German / Spanish / French / Portuguese / Japanese.
  • Crash diagnostics: AppDomain + Dispatcher + TaskScheduler unhandled exception handlers wired to Serilog.Critical + user-facing dialog.
  • First-launch onboarding dialog with 5-step setup checklist.
  • About dialog gained "Show welcome", "Check for updates", "Export diagnostics" buttons.
  • Diagnostic bundle export: zips logs + config + presets + version metadata into ~/Downloads/teamsiso-diagnostics-<ts>.zip for bug reports.
  • Update check: manual via About + auto-on-launch banner (throttled to 24h, opt-out via flag file at %LOCALAPPDATA%\TeamsISO\no-update-check.flag).
  • Disk space watcher auto-disables recording at <1GB free.
  • Settings panel refactored into OUTPUT / NETWORK / DISPLAY tabs.
  • Reset-to-defaults button in OUTPUT tab.
  • Enriched footer: REC badge, control-surface badge, session timer (HH:MM:SS since first ISO went live), dynamic status text ("3/5 ISOs live · 2 recording").
  • Window-scoped keyboard shortcuts: F1 (help), Ctrl+M (marker), Ctrl+Shift+S (stop all), Ctrl+R (refresh discovery).
  • F1 help / cheat-sheet dialog.
  • UIPreferences static persists HideLocalSelf, AutoDisableOnDeparture, ParticipantSort (JoinOrder / Alphabetical / OnlineFirst) across launches to %LOCALAPPDATA%\TeamsISO\ui-prefs.json.
  • Pop-out per-participant preview window (right-click → Open preview…) refreshes at ~20Hz and is multi-monitor friendly.
  • Configurable participant sort order via the DISPLAY tab dropdown.
  • Stop-All confirms before tearing down running pipelines (catches mid-show misclicks).
  • About dialog gained "Logs / Recordings / Notes" folder shortcut buttons.
  • NotesWindow inline viewer for today's show-notes file with 2s polling.
  • Duplicate-preset action in the Presets dialog with smart (copy N) name suggestions.
  • --apply-preset NAME command-line flag for desktop-shortcut workflows.
  • New TeamsISO.App.Tests net8.0-windows test project. Initial coverage: OperatorPresetStoreTests (round-trip, name collisions, schema, bundle import/export, garbage-file resilience), OutputNameTemplateTests (token expansion + sanitization), OscMessageTests (wire-format parsing of int/float/string/T/F type tags). Backed by an InternalsVisibleTo grant
    • a test-only OperatorPresetStore.PathOverride hook.
  • IsoHealthStats.PeakAudioLevel field + DataGrid VU-bar UI scaffolding. Engine still emits 0.0 (audio capture is a focused follow-up); the bar's decay logic is in place so it animates as soon as engine-side audio parsing lands.
  • MediaFoundationRecorderSink scaffold under #if MF_AVAILABLE for inline H.264 encoding via Vortice.MediaFoundation. ~10× smaller files than the raw BGRA recorder. Activation steps documented at docs/REAL-TIME-RECORDING.md.
  • System-tray icon + minimize-to-tray toggle. Adds <UseWindowsForms>true</UseWindowsForms> for NotifyIcon; the TrayIconHost lives on App (process lifetime, not main-window lifetime). Right-click menu has Show / Stop all ISOs / Exit.
  • Built-in NDI test pattern: TeamsISO.Console --test-pattern broadcasts a synthetic 1280×720 30fps source named TEAMSISO_TEST showing SMPTE color bars + a moving sweep band. Verifies NDI runtime, sender configuration, and downstream discovery without needing Teams running. Backed by TestPatternGenerator in the engine + 4 unit tests covering buffer size, alpha, color distinctness, and sweep animation.
  • Always-toast on participant disconnect, regardless of AutoDisableOnDeparture setting. Distinguishes "ISO torn down" (auto-disable on) from "ISO still running on slate" (auto-disable off) so operators don't miss a silent drop mid-show.
  • Restart this ISO right-click action — disable + brief delay + re-enable for one participant only. Useful when a single feed flakes without affecting other ISOs.
  • Roll recording action: rolls every active recording into a new chunk (disable + re-enable each pipeline; recorder finalizes its manifest.json and starts a fresh subdirectory). Surfaced via MainViewModel.RollRecordingCommand, REST POST /recording/roll, and OSC /teamsiso/recording/roll. Useful for chaptering between show segments.
  • Engine audio peak metering — IsoHealthStats.PeakAudioLevel now reports real values (was always 0.0). New INdiInterop.CaptureAudioPeak method polls audio frames; production NdiInteropPInvoke parses NDIlib_audio_frame_v3_t and computes max-absolute peak across all channels. NdiReceiver runs a sibling audio capture loop on the same lifetime so the existing video path is unaffected. UI VU bars in the participants DataGrid now animate against real source audio. Failures in the audio loop are caught + logged but never re-thrown — a misbehaving audio path must never tear down the live video pipeline. 14 new unit tests in AudioPeakComputerTests covering FLTP / FLT / PCM s16 across edge cases (clipping, short.MinValue overflow, defensive totalSamples-vs-buffer mismatch handling).

LAN-reachable control surface

  • ControlSurfaceServer.Start(port, bindToLan) and OscBridge.Start(port, bindToLan) switch between 127.0.0.1 and all-interfaces (http://+:port/, IPAddress.Any) based on the new ControlSurfaceLanReachable UI preference. Settings VM persists the toggle, restarts both surfaces on flip, and surfaces a ControlSurfaceUrl (computed from the host's first physical-NIC routable IPv4 — Tailscale / VPN / APIPA addresses are skipped) plus a Copy button. Use case: headless host PC running Teams + TeamsISO; thin client on the same LAN drives /ui or hits the REST endpoints. Closed-network deployment, no auth — documented as a trusted-LAN-only mode in docs/CONTROL-SURFACE.md. First-time use requires a one-shot netsh http add urlacl url=http://+:9755/ user=Everyone (so the listener can bind without admin); the diagnostic warning fires the exact command string in the log if the bind fails.

"I only see TeamsISO" — Phase E.1+E.2 quality-of-life

For operators who want to launch TeamsISO and never look at the Teams UI:

  • Launch Microsoft Teams on TeamsISO startup preference (DISPLAY tab). Auto-fires Teams in the background each time TeamsISO starts; the Teams window appears briefly during boot then can be hidden automatically.
  • Auto-hide Teams windows when launched preference (DISPLAY tab). TeamsLauncher.AutoHideAfterLaunchAsync polls for 15s after launch hiding splash, main window, and follow-up panels as they materialize. Works on top of the existing eye-toggle for manual restore.
  • Quick-join Teams meeting from URL — small input + Join button in the IN-CALL bar. Paste a https://teams.microsoft.com/l/meetup-join/... or msteams:/l/meetup-join/... link, click Join, Teams launches into the meeting in one shot. Eliminates the open-Teams → Calendar → find → click Join dance. Pairs with auto-hide so the operator goes straight from "I have a meeting link" to "I'm in the meeting, driving routing".
  • Teams meeting state pill in the IN-CALL bar — shows IN CALL · <meeting title> / READY / empty. UIA-driven probe of Teams' Leave button at 1Hz; the meeting title comes from Teams' window title with the brand suffix stripped. So an operator with auto-hide on knows whether they're in a meeting AND which one without restoring the Teams window. 10 new unit tests on MainViewModel.ExtractMeetingTitle.
  • Rail Launch Teams click semantics — was ambushing operators with a "Close all Teams windows now?" dialog whenever Teams was running (e.g. when hidden via the eye-toggle). Now click = launch / surface / restore; right-click = stop. TeamsLauncher.TryLaunch now collects per-attempt errors (no more silent fall-through) and adds the AppX-activation fallback for hosts where the ms-teams: URI handler is misconfigured.

UI polish — visible affordances on the dark canvas

  • Hover state on every themed button (Ghost / Caption / RailIcon / IsoToggle) was barely distinguishable from the resting state. Bumped Wd.SurfaceHover
    • Wd.SurfaceActive colours for sufficient contrast, added dedicated Wd.Button.HoverBg / Wd.Button.PressBg brushes with a slight chroma tint, and added cyan accent borders so mouse-hover and tab-focus give an unmistakable affordance regardless of which surface the button sits on. IsoToggle keeps its status-coded background (LIVE cyan / ERROR coral / NO SIGNAL amber) on hover; the affordance is a 2px cyan border pop.
  • IsKeyboardFocused triggers added on every themed button so tab-cycling through the UI gives visual feedback (was nothing — FocusVisualStyle was x:Null with no replacement).
  • ScrollBar restyled: slim transparent track + tinted thumb (Edge / VS Code pattern) in place of the chunky Win9x default with line-up / line-down arrow buttons. Track-clicks above/below the thumb still page-scroll.
  • ToolTip restyled: SurfaceElevated card with rounded 6px corner + 320px text wrap, replacing the cream Win98 popup. Affects every tooltip across MainWindow.
  • ContextMenu / MenuItem restyled: dark card with rounded corners + cyan- tinted hover. Affects the right-click menu on participant rows (Toggle ISO / Restart this ISO / Open preview / Record / Copy NDI source name).
  • CheckBox content no longer clips at the 380px settings panel: template's StackPanel replaced with a Grid (Auto + *) and a TextWrapping=Wrap resource injected into the ContentPresenter so long labels flow onto multiple lines.
  • Manual X dismiss on toast notifications for live-show situations where the operator wants to clear visual clutter without waiting 3s.
  • Footer's control-surface badge surfaces the full LAN URL (not just port) when LAN-reachable mode is on, so a thin client can be configured by reading the URL straight off the host's footer.

Control surface

  • REST API on 127.0.0.1:9755 with endpoints for participant ISO toggle (by Id or display name), preset apply, refresh discovery, stop-all, recording on/off, marker drop, notes, and Teams in-call commands. Documented at docs/CONTROL-SURFACE.md.
  • WebSocket /ws pushes live participant state at 4Hz with snapshot diffing.
  • OSC bridge on UDP 127.0.0.1:9000 mirrors the REST vocabulary (/teamsiso/iso "Jane" 1, /teamsiso/preset "...", etc.).
  • Embedded HTML control panel at GET /ui — phone-friendly remote with live state and one-click action buttons.
  • Show notes service: POST /notes and /teamsiso/notes "..." append timestamped lines to %LOCALAPPDATA%\TeamsISO\Notes\<YYYY-MM-DD>.md.

CI / Release

  • Forgejo CI is green; tag-push release workflow builds + tests + publishes
    • builds MSI on a Windows runner and attaches it to the auto-created release via the REST API.
  • Optional MSI + exe code-signing wired into release.yml — gated on SIGN_CERT_PFX_BASE64 + SIGN_CERT_PASSWORD Forgejo Secrets.

Fixed

  • .slnf path-separator mismatch (forward slashes for cross-platform).
  • NDI native DLL resolution via NativeLibrary resolver.
  • ExpectedRuntimeVersionPrefix updated to NDI 6 banner format.
  • NdiSourceParser accepts current Teams desktop's MS Teams - <name> brand format.
  • ActiveSpeaker source removal no longer poisons the rename-window heuristic for a Participant joining the same machine within the window.
  • IsoPipeline.State access synchronized via Volatile.Read/Write.
  • REST handlers now correctly marshal ObservableCollection reads + writes through the UI dispatcher.
  • WebSocket upgrade no longer falls into res.Close() finally block (was killing freshly-upgraded connections).
  • ParticipantViewModel.UpdateThumbnail defends against malformed frames (width*height*4 > Pixels.Length).
  • HasThumbnail correctly fires PropertyChanged when Thumbnail transitions from null.
  • WinForms / WPF Application and MessageBox namespace collision (introduced when <UseWindowsForms>true</UseWindowsForms> was added for the system tray) resolved via project-wide GlobalUsings.cs.
  • GetLanIPv4() now skips Tailscale / VPN tunnel adapters and APIPA (169.254.x) so the displayed control-surface URL points at the routable LAN IP (verified on a host with both Ethernet 10.x and a Tailscale 169.254 link-local — picker now correctly returns the Ethernet address).