How tonlongthuat/real-time-fall-detection works
Real-Time Fall Detection is a Flask-based monitoring app: users view a camera feed by registering an ESP32 IP address, or upload a video for processing and playback. Both paths display frames annotated by YOLO fall detection. The README also describes ESP32-CAM capture and multi-person monitoring. fall_detector.py contains a separate keypoint pose-and-duration detector, but the sampled runtime does not connect it to the Flask workflow. Relationships below follow sampled calls and README claims; no unsampled implementation links are inferred.
Main entry points: main.py Flask routes · video.py Live video streamer · esp32cam_streamer.py Camera frame capture · index.html Monitoring interface
Components 14
Web monitoring
- Flask routes
main.py - Monitoring interface
templates/index.html
Frame sources
- ESP32-CAM
esp32_stream.ino - Camera frame capture
esp32cam_streamer.py - Video upload
main.py - Uploaded video
uploads
Fall analysis
- YOLO frame processing
video.py - Keypoint fall detector
fall_detector.py - YOLO model
ok.pt
Video delivery
- Processed frame queue
main.py - Live video streamer
video.py - File video streamer
video.py - MJPEG camera feed
main.py
Other components
- Monitoring user
Connections 19
- Monitoring user → Monitoring interface: uses
README.md - Monitoring interface → Flask routes: submits requests
- Monitoring user → ESP32-CAM: configures
README.md - Flask routes → Video upload: routes uploads
main.py - Video upload → Uploaded video: saves video
main.py - Video upload → YOLO frame processing: starts processing
main.py - YOLO frame processing → YOLO model: loads model
video.py - YOLO frame processing → Processed frame queue: enqueues frames
video.py - Flask routes → Camera frame capture: creates capture
main.py - Flask routes → Live video streamer: creates streamer
main.py - Live video streamer → Camera frame capture: reads frames
video.py - Live video streamer → YOLO frame processing: processes frames
video.py - Flask routes → File video streamer: selects file stream
main.py - File video streamer → Processed frame queue: dequeues frames
video.py - Live video streamer → MJPEG camera feed: yields MJPEG
main.py - File video streamer → MJPEG camera feed: yields MJPEG
main.py - MJPEG camera feed → Monitoring user: streams video
main.py - ESP32-CAM → Camera frame capture: streams over Wi-Fi
README.md - Keypoint fall detector → Monitoring user: detects pose