{"id":14961247,"url":"https://github.com/brekel/raspi-facecam","last_synced_at":"2026-02-02T20:03:27.041Z","repository":{"id":227690390,"uuid":"772104129","full_name":"Brekel/raspi-facecam","owner":"Brekel","description":"Scripts to download \u0026 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.","archived":false,"fork":false,"pushed_at":"2024-03-29T12:35:30.000Z","size":10790,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-13T22:49:42.590Z","etag":null,"topics":["brekel","camera","capture","face","facial","helmet","hmc","mocap","motion","mounted","pi","raspberry","tracking","wifi","zero"],"latest_commit_sha":null,"homepage":"https://brekel.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Brekel.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-03-14T14:43:52.000Z","updated_at":"2024-04-03T22:08:28.000Z","dependencies_parsed_at":"2024-03-20T17:29:31.800Z","dependency_job_id":"484a8bc8-aa2e-4142-8d3b-9a1bbff27556","html_url":"https://github.com/Brekel/raspi-facecam","commit_stats":{"total_commits":15,"total_committers":2,"mean_commits":7.5,"dds":0.06666666666666665,"last_synced_commit":"4cb4170c0f448b235a2b0fe743e34595e28d0e87"},"previous_names":["brekel/raspi-facecam"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Brekel%2Fraspi-facecam","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Brekel%2Fraspi-facecam/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Brekel%2Fraspi-facecam/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Brekel%2Fraspi-facecam/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Brekel","download_url":"https://codeload.github.com/Brekel/raspi-facecam/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247730980,"owners_count":20986570,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["brekel","camera","capture","face","facial","helmet","hmc","mocap","motion","mounted","pi","raspberry","tracking","wifi","zero"],"created_at":"2024-09-24T13:24:16.532Z","updated_at":"2026-02-02T20:03:26.932Z","avatar_url":"https://github.com/Brekel.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# raspi-facecam\n\nScripts to download \u0026amp; install [camera-streamer](https://github.com/ayufan/camera-streamer) and apply optimal settings for a [Raspberry Pi Zero 2W](https://www.raspberrypi.com/products/raspberry-pi-zero-2-w) with [Camera Module v3](https://www.raspberrypi.com/products/camera-module-3) to live stream video data at the highest possible frame rate.\n\n\nThe primary use case is as a wireless HMC (Helmet Mounted Camera) for facial motion capture.  \nFor example the [Brekel Body v3 software](https://brekel.com/brekel-body-v3) can utilize this with it's face tracking functionality.\n\n\nThis 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):  \n[Printables](https://www.printables.com/model/805075-rasberry-pi-zero-face-camera)  \n[MakerWorld](https://makerworld.com/en/models/387990)  \n![exploded_case](images/exploded_case.png)\n![bill of materials](images/BOM.png)\n\n\n\n## Installation\n(you can find a more step-by step guide in the PDF from the documentation folder)\n\n* Use the Raspberry Pi Imager to install the 64-bit Lite version of Raspberry Pi OS\n* Make sure to configure your WiFi settings using the \"Edit Settings\" option and enable SSH\n* 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)\n* SSH into your Pi\n\n### run the following commands to make sure git is available (only needed once on initial installation)\n```bash\nsudo apt install -y git\n```\n\n### run the following commands to download \u0026amp; install the software (or if you want to update things in the future)\n```bash\ngit clone https://github.com/Brekel/raspi-facecam.git\ncd raspi-facecam\n./install_camera-streamer.sh\n```\n\nInstallation can take 5-10 minutes (depending on your SD-card and internet speed)\nWhen finished you can access the video stream over the listed http listed in the console.\n\n\n## Update\nWhen you want to update to the latest version\n* SSH into your Pi\n* use the following command to remove the current files:\n```bash\nrm -rf raspi-facecam\n```\n* clone the github repo again and run the installation script again (same as above for initial install)\n```bash\ngit clone https://github.com/Brekel/raspi-facecam.git\ncd raspi-facecam\n./install_camera-streamer.sh\n```\n\n## HMC (Helmet Mounted Camera) mounting solution\n\nThe 3D printed case can be attached to a helmet using standard GoPro mounting hardware like this:\n![HMC GoPro](images/HMC_GoPro.jpg)\n\nAnother, more sophisticated option is to to attach it using some additional 3D prints and a carbon rod:\n![HMC1](images/HMC.jpg)\nThe 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.\n\n3D printable files can be found here:  \n[Printables](https://www.printables.com/model/823454-hmc-helmet-mounted-camera-mounting-solution)  \n[MakerWorld](https://makerworld.com/en/models/400309)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrekel%2Fraspi-facecam","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbrekel%2Fraspi-facecam","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrekel%2Fraspi-facecam/lists"}