How eyalshub/live-video-quality-monitor works
Live Video Quality Monitor captures webcam frames and analyzes them entirely in the browser, producing per-second quality metrics, a Good/Poor verdict, live insights and a 30-second view. The monitor batches numeric samples to a FastAPI service, which validates and re-checks verdicts before storing sessions in Postgres; the History screen retrieves stored sessions for replay. Video stays in the browser. The README documents the end-to-end flow; source-index references establish several internal module links, but unsampled UI and service details limit finer call attribution.
Main entry points: monitor.ts Session monitor · App.tsx App and routing · sessions.py Session lifecycle · frameLoop.ts Frame loop
Components 27
Browser capture
- Camera access
frontend/src/capture/camera.ts - Frame loop
frontend/src/capture/frameLoop.ts - Face detection
frontend/src/capture/faceDetector.ts - Frame analysis
frontend/src/capture/frameAnalyzer.ts
Metrics and session
- Frame metrics
frontend/src/metrics/frame.ts - Face filter
frontend/src/metrics/faceFilter.ts - Quality verdict
frontend/src/metrics/verdict.ts - Extra insights
frontend/src/metrics/insights.ts - Sample aggregation
frontend/src/session/aggregator.ts - Insight aggregation
frontend/src/session/insightAggregator.ts - Session monitor
frontend/src/session/monitor.ts - Sample outbox
frontend/src/session/outbox.ts
Frontend experience
- App and routing
frontend/src/ui/App.tsx - Live monitor UI
frontend/src/ui/LiveMonitor.tsx - History UI
frontend/src/ui/History.tsx - API client
frontend/src/api/client.ts
API and domain
- Session endpoints
backend/app/api/sessions.py - API schemas
backend/app/schemas/sessions.py - Session lifecycle
backend/app/services/sessions.py - Verdict re-check
backend/app/services/verdict.py - Health endpoint
backend/app/api/health.py - API application
backend/app/main.py
Persistence
- Session and samples
backend/app/db/models.py - Database session
backend/app/db/session.py - Postgres
Other components
- User
- Webcam
Connections 37
- User → App and routing: uses
frontend/src/ui/App.tsx - Webcam → Camera access: provides video
README.md - Camera access → Frame loop: supplies frames
README.md - Frame loop → Frame analysis: analyzes frames
README.md - Frame loop → Face detection: detects faces
frontend/src/session/monitor.ts - Frame analysis → Frame metrics: uses
frontend/src/capture/frameAnalyzer.ts - Face detection → Face filter: filters candidates
frontend/src/capture/faceDetector.ts - Face detection → Extra insights: measures framing
frontend/src/capture/faceDetector.ts - Session monitor → Camera access: opens camera
frontend/src/session/monitor.ts - Session monitor → Frame loop: runs capture
frontend/src/session/monitor.ts - Session monitor → Frame analysis: uses
frontend/src/session/monitor.ts - Session monitor → Face detection: uses
frontend/src/session/monitor.ts - Session monitor → Quality verdict: judges samples
frontend/src/session/monitor.ts - Sample aggregation → Frame metrics: aggregates
frontend/src/session/aggregator.ts - Sample aggregation → Quality verdict: assigns verdict
frontend/src/session/aggregator.ts - Insight aggregation → Frame metrics: aggregates
frontend/src/session/insightAggregator.ts - Insight aggregation → Extra insights: computes insights
frontend/src/session/insightAggregator.ts - Session monitor → Sample aggregation: collects samples
frontend/src/session/monitor.ts - Session monitor → Insight aggregation: collects insights
frontend/src/session/monitor.ts - Session monitor → Sample outbox: queues samples
frontend/src/session/monitor.ts - App and routing → Live monitor UI: routes to
frontend/src/ui/App.tsx - App and routing → History UI: routes to
frontend/src/ui/App.tsx - App and routing → Health endpoint: shows status
frontend/src/ui/App.tsx - Live monitor UI → Session monitor: displays monitoring
- Sample outbox → API client: sends batches
frontend/src/session/monitor.ts - API client → Session endpoints: calls session API
README.md - History UI → API client: loads sessions
- API application → Session endpoints: registers routes
backend/app/main.py - API application → Health endpoint: registers routes
backend/app/main.py - Session endpoints → API schemas: validates payloads
backend/app/api/sessions.py - Session endpoints → Session lifecycle: delegates lifecycle
backend/app/api/sessions.py - Session lifecycle → Verdict re-check: re-checks verdict
backend/app/services/sessions.py - Session lifecycle → Session and samples: reads and writes
backend/app/services/sessions.py - Session lifecycle → API schemas: uses data models
backend/app/services/sessions.py - API application → Database session: creates database session
backend/app/main.py - Health endpoint → Database session: checks database
backend/app/api/health.py - Database session → Postgres: connects
README.md