How kittulsalpha-ctrl/media-health-checker works
This is a media-operations application for validating uploaded or watched video, producing review artifacts, and presenting results in a dashboard. The principal web workflow runs from upload through media inspection, validation, frame and proxy generation, report storage, and dashboard display. A separate filesystem-watcher workflow processes files placed in a watch folder. The excerpts show both workflows, but do not establish that they share a processing pipeline; the web processing excerpt also omits some implementation details.
Main entry points: watcher.py Media handler · app.py Flask application
Components 18
Web dashboard
- Flask application
backend/app.py - Media upload
backend/app.py - Dashboard view
backend/app.py
Watched media
- Watch folder
backend/watcher.py - Folder observer
backend/watcher.py - Media handler
backend/watcher.py
Media processing
- Metadata inspection
backend/watcher.py - Media validation
backend/watcher.py - Status classification
backend/watcher.py - Media sorting
backend/watcher.py - Frame extraction
backend/watcher.py - Proxy generation
backend/watcher.py - AI tags
backend/watcher.py
Reports and artifacts
- JSON reports
backend/watcher.py - Frame files
backend/watcher.py - Proxy files
backend/watcher.py
Other components
- Media operator
- FFmpeg tools
Connections 25
- Media operator → Media upload: submits media
backend/app.py - Media upload → Flask application: calls processing
backend/app.py - Flask application → Metadata inspection: probes media
backend/app.py - Flask application → Media validation: checks media
backend/app.py - Flask application → Frame extraction: extracts frame
backend/app.py - Flask application → Proxy generation: creates proxy
backend/app.py - Flask application → AI tags: generates tags
backend/app.py - Flask application → JSON reports: writes report
backend/app.py - Media operator → Dashboard view: views results
backend/app.py - Dashboard view → JSON reports: reads reports
backend/app.py - Watch folder → Folder observer: monitors folder
backend/watcher.py - Folder observer → Media handler: dispatches event
backend/watcher.py - Media handler → Metadata inspection: probes media
backend/watcher.py - Media handler → Media validation: checks media
backend/watcher.py - Media handler → Status classification: selects status
backend/watcher.py - Media handler → Media sorting: moves media
backend/watcher.py - Media handler → Frame extraction: extracts frame
backend/watcher.py - Media handler → Proxy generation: creates proxy
backend/watcher.py - Media handler → AI tags: generates tags
backend/watcher.py - Media handler → JSON reports: writes report
backend/watcher.py - Media handler → Frame files: writes frame
backend/watcher.py - Media handler → Proxy files: writes proxy
backend/watcher.py - Metadata inspection → FFmpeg tools: runs ffprobe
backend/watcher.py - Frame extraction → FFmpeg tools: runs ffmpeg
backend/watcher.py - Proxy generation → FFmpeg tools: runs ffmpeg
backend/watcher.py