How advaetuc/vertebrate works
Vertebrate is a local PySide6 webcam application that detects and confirms falls from pose geometry, then presents live status and manages alarms, history, location, and optional Discord alerts. The main workflow runs from app.py through MainWindow to a camera worker; the worker performs CPU pose inference and per-person tracking, then signals annotated frames and alert state back to the GUI. The README documents the broader UI and integrations. Some UI wiring is visible only in partial MainWindow excerpts, so edges that depend on unsampled details are omitted.
Main entry points: mainwindow.py Main window · camerathread.py Camera worker · falllog.py Fall event log · app.py Application entry
Components 19
Application
- Application entry
app.py - Shared runtime helpers
app_modules/common.py
Fall monitoring
- Camera worker
app_modules/camerathread.py - Pose inference
app_modules/camerathread.py - Person tracking
app_modules/tracking.py
Live interface
- Main window
app_modules/mainwindow.py - Video view
app_modules/videoview.py - Evidence meter
app_modules/evidencemeter.py - Status tiles
app_modules/stattile.py - Logo mark
app_modules/logomark.py
Alerts and history
- Fall event log
app_modules/falllog.py - Per-device CSV
app_modules/falllog.py - Fall log dialog
app_modules/falllogdialog.py - Local alarm
app_modules/alarmsound.py - Discord alerts
app_modules/caregivers.py
Location context
- Location feed
app_modules/locationfeed.py
Other components
- Operator
- Discord channel
- Webcam
Connections 23
- Operator → Application entry: launches
README.md - Application entry → Main window: creates
app.py - Application entry → Shared runtime helpers: applies theme
app.py - Operator → Main window: controls
README.md - Main window → Camera worker: starts worker
app_modules/mainwindow.py - Main window → Camera worker: receives signals
app_modules/mainwindow.py - Camera worker → Webcam: reads frames
README.md - Camera worker → Pose inference: runs inference
app_modules/camerathread.py - Camera worker → Person tracking: updates tracks
app_modules/camerathread.py - Camera worker → Main window: emits frame state
app_modules/camerathread.py - Main window → Video view: updates view
README.md - Main window → Evidence meter: shows evidence
README.md - Main window → Status tiles: shows status
README.md - Main window → Logo mark: uses widget
app_modules/mainwindow.py - Main window → Location feed: starts feed
app_modules/mainwindow.py - Main window → Fall event log: updates events
README.md - Fall event log → Per-device CSV: writes CSV
app_modules/falllog.py - Main window → Fall log dialog: opens history
app_modules/mainwindow.py - Fall log dialog → Fall event log: reads history
app_modules/falllogdialog.py - Main window → Local alarm: controls siren
app_modules/mainwindow.py - Main window → Discord alerts: sends event alerts
app_modules/mainwindow.py - Discord alerts → Discord channel: posts messages
app_modules/caregivers.py - Fall event log → Location feed: stores event location