How vash-codex/servo-facial-tracking works
This is a desktop webcam face-tracking application with an Arduino-driven servo. The user launches training or either tracking mode from the Tkinter control center; training captures face samples and builds an LBPH model, which the recognition tracker loads to follow the face and send servo angles. A separate basic mode tracks without recognition and provides animated eye styles and keyboard controls. The Arduino sketch is the hardware endpoint. The dataset is generated at runtime and is not present in the tree; firmware internals were not sampled.
Main entry points: face_tracker_gui.py Mode Dispatcher · face_tracker_lbph.py Recognition Tracker · train_lbph.py Face Capture · face.py Basic Tracker
Components 15
Control Center
- Tkinter GUI
face_tracker_gui.py - Mode Dispatcher
face_tracker_gui.py
Recognition Training
- Face Capture
custom face/train_lbph.py - Face Samples
- LBPH Trainer
custom face/train_lbph.py - LBPH Model
custom face
Tracking Modes
- LBPH Entry
custom face/face_tracker_lbph.py - Recognition Tracker
custom face/face_tracker_lbph.py - Basic Tracker
face.py - Basic Serial Control
face.py
Servo Hardware
- Serial Controller
custom face/face_tracker_lbph.py - Arduino Servo Firmware
facearduino/facearduino.ino
Other components
- Operator
- Webcam
- Servo
Connections 18
- Operator → Tkinter GUI: operates
README.md - Tkinter GUI → Mode Dispatcher: launches mode
face_tracker_gui.py - Mode Dispatcher → Face Capture: dispatches training
face_tracker_gui.py - Mode Dispatcher → LBPH Entry: dispatches LBPH
face_tracker_gui.py - Mode Dispatcher → Basic Tracker: dispatches basic
face_tracker_gui.py - Face Capture → Webcam: reads frames
custom face/train_lbph.py - Face Capture → Face Samples: writes samples
custom face/train_lbph.py - LBPH Trainer → Face Samples: loads samples
custom face/train_lbph.py - LBPH Trainer → LBPH Model: saves model
custom face/train_lbph.py - LBPH Entry → Recognition Tracker: runs tracker
custom face/face_tracker_lbph.py - Recognition Tracker → LBPH Model: loads model
custom face/face_tracker_lbph.py - Recognition Tracker → Webcam: reads frames
custom face/face_tracker_lbph.py - Recognition Tracker → Serial Controller: sends angles
custom face/face_tracker_lbph.py - Basic Tracker → Webcam: reads frames
face.py - Basic Tracker → Basic Serial Control: sends angles
face.py - Serial Controller → Arduino Servo Firmware: serial commands
README.md - Basic Serial Control → Arduino Servo Firmware: serial commands
README.md - Arduino Servo Firmware → Servo: drives
README.md