Skip to content

Scripts to download & install camera-streamer for a Raspberry Pi Zero 2 with Camera Module v3 Wide. The primary use case is as a wireless HMC (Helmet Mounted Camera) for facial motion capture.

License

Brekel/raspi-facecam

Repository files navigation

raspi-facecam

Scripts to download & install camera-streamer and apply optimal settings for a Raspberry Pi Zero 2W with Camera Module v3 to live stream video data at the highest possible frame rate.

The primary use case is as a wireless HMC (Helmet Mounted Camera) for facial motion capture.
For example the Brekel Body v3 software can utilize this with it's face tracking functionality.

This is designed to be used with a 3D printed case that can be downloaded from the following page(s) (more info on bill of materials and assembly instructions there):
Printables
MakerWorld
exploded_case bill of materials

Installation

(you can find a more step-by step guide in the PDF from the documentation folder)

  • Use the Raspberry Pi Imager to install the 64-bit Lite version of Raspberry Pi OS
  • Make sure to configure your WiFi settings using the "Edit Settings" option and enable SSH
  • Once completed you can insert the SD-Card into the Pi through the side hole, you may need a small screw driver or tweezers to carefully slide it into place (this was deliberately designed so it takes some effort to remove)
  • SSH into your Pi

run the following commands to make sure git is available (only needed once on initial installation)

sudo apt install -y git

run the following commands to download & install the software (or if you want to update things in the future)

git clone https://github.com/Brekel/raspi-facecam.git
cd raspi-facecam
./install_camera-streamer.sh

Installation can take 5-10 minutes (depending on your SD-card and internet speed) When finished you can access the video stream over the listed http listed in the console.

Update

When you want to update to the latest version

  • SSH into your Pi
  • use the following command to remove the current files:
rm -rf raspi-facecam
  • clone the github repo again and run the installation script again (same as above for initial install)
git clone https://github.com/Brekel/raspi-facecam.git
cd raspi-facecam
./install_camera-streamer.sh

HMC (Helmet Mounted Camera) mounting solution

The 3D printed case can be attached to a helmet using standard GoPro mounting hardware like this: HMC GoPro

Another, more sophisticated option is to to attach it using some additional 3D prints and a carbon rod: HMC1 The advantage of this solution is that it’s fully adjustable, it can be adjusted by pivoting on two axis and the distance of the camera to the face can be adjusted as well.

3D printable files can be found here:
Printables
MakerWorld

About

Scripts to download & install camera-streamer for a Raspberry Pi Zero 2 with Camera Module v3 Wide. The primary use case is as a wireless HMC (Helmet Mounted Camera) for facial motion capture.

Topics

Resources

License

Stars

Watchers

Forks