{"id":14483490,"url":"https://github.com/geraldoramos/pigeon","last_synced_at":"2026-03-08T12:37:14.604Z","repository":{"id":82034807,"uuid":"87251179","full_name":"geraldoramos/pigeon","owner":"geraldoramos","description":"Pigeon is a simple 3D printed cloud home surveillance camera project that uses the new Raspberry Pi Zero W","archived":false,"fork":false,"pushed_at":"2017-09-11T03:09:24.000Z","size":442,"stargazers_count":298,"open_issues_count":9,"forks_count":23,"subscribers_count":30,"default_branch":"master","last_synced_at":"2025-03-26T23:05:32.756Z","etag":null,"topics":["3d-printing","camera","motion-detection","raspberry-pi","raspberrypi","shell-script","surveillance"],"latest_commit_sha":null,"homepage":"https://www.instructables.com/id/Pigeon-a-3D-Printed-Cloud-Home-Surveillance-Camera/","language":"Shell","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/geraldoramos.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2017-04-05T01:16:11.000Z","updated_at":"2025-03-15T08:52:17.000Z","dependencies_parsed_at":null,"dependency_job_id":"6e988d9b-b7d1-4d15-97d5-d2029d529ace","html_url":"https://github.com/geraldoramos/pigeon","commit_stats":{"total_commits":113,"total_committers":3,"mean_commits":"37.666666666666664","dds":"0.17699115044247793","last_synced_commit":"60ed4e2d86f0b871a77c1a6a4cadeb4a80e063b7"},"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geraldoramos%2Fpigeon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geraldoramos%2Fpigeon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geraldoramos%2Fpigeon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geraldoramos%2Fpigeon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/geraldoramos","download_url":"https://codeload.github.com/geraldoramos/pigeon/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248675302,"owners_count":21143763,"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":["3d-printing","camera","motion-detection","raspberry-pi","raspberrypi","shell-script","surveillance"],"created_at":"2024-09-03T00:01:48.490Z","updated_at":"2026-03-08T12:37:14.577Z","avatar_url":"https://github.com/geraldoramos.png","language":"Shell","funding_links":["https://www.paypal.me/GeraldoRamos"],"categories":["Shell"],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\u003cimg src=\"https://s3-us-west-1.amazonaws.com/allge.us/logo_pigeon.svg\" width=\"400\"/\u003e\u003c/p\u003e\n\n# Pigeon\n[![License: GPL v3](https://img.shields.io/badge/License-GPL%20v3-blue.svg)](https://github.com/geraldoramos/pigeon/blob/master/LICENSE)\n[![PayPal](https://www.paypalobjects.com/en_US/i/btn/btn_donate_SM.gif)](https://www.paypal.me/GeraldoRamos)\n[![Twitter](https://img.shields.io/twitter/url/https/twitter.com/fold_left.svg?style=social\u0026label=Follow%20%40geraldoramos)](https://twitter.com/geraldoramos)\n\nPigeon is a simple cloud home surveillance camera project that uses the new Raspberry Pi Zero W single board computer ($10). It uses a custom designed 3D printed enclosure that fits the board and the camera. A wall mount is also included. The software should work with any Raspberry PI version, but the 3D design is made specifically for the PI Zero W platform.\n\nThe goal of this project is to provide an easy way to setup a basic (yet functional) hackable cloud camera at the lowest possible cost.\n\n##\n\u003cp align=\"center\"\u003e\u003cimg src=\"https://s3-us-west-1.amazonaws.com/allge.us/pigif.gif\" width=\"600\"/\u003e\u003c/p\u003e\n\n\n**Features**\n\n* Motion detection\n* Integrated with Dropbox for motion detected clips storage (MP4 format)\n* Simple step-by-step installation wizard\n* Live streaming in the desktop/mobile browser with remote access capabilities\n* Authentication for live stream visualization\n* 3D printed enclosure\n* Ability to create several integrations using IFTTT (ex: If Pigeon's dropbox folder changes, send an e-mail, SMS, or slack message including the clip file link).\n* Automatically deletes locally recorded clips after uploading to Dropbox\n* Self-contained modular system for easily creating new modules\n\n**Requirements**\n* (optional) 3D Printed enclosure. STL files and instructions available on [ThingiVerse](http://www.thingiverse.com/thing:2230707).\n* A Rasberry Pi Zero W running Raspbian and connected to the internet. The regular (no-wifi) Raspberry PI Zero also works, but will require a usb wifi doongle that will stay out of the designed enclosure: [Buy a Raspberry PI Zero W][829f44e8]\n* A Raspberry Pi camera with cable: [Buy it][09e7e3d1]\n* (optional) A long micro-usb power cable: [Buy it](https://www.aliexpress.com/item/1-2-3-5m-10ft-90-degree-Angle-Long-Micro-USB-Cable-20cm-Sync-data-Charging/32794612542.html?spm=2114.01010208.3.12.Xj3wx5\u0026ws_ab_test=searchweb0_0,searchweb201602_4_10065_10130_10068_10136_10137_10138_10060_10062_10141_10056_10055_10054_10059_10099_129_10103_10102_10096_10148_10052_10053_10050_10107_10142_10051_10143_10084_10083_10119_10080_10082_10081_10110_10111_10112_10113_10114_10037_10032_10078_10079_10077_10073_10070_10123_10120_10124-10120,searchweb201603_6,afswitch_1_afChannel,ppcSwitch_7,single_sort_0_default\u0026btsid=fc05fbd8-0d8a-47c8-b643-02df18983f6f\u0026algo_expid=bb5c67b9-9680-48f5-8c33-d24c88072ce4-1\u0026algo_pvid=bb5c67b9-9680-48f5-8c33-d24c88072ce4)\n\n  [09e7e3d1]: https://www.aliexpress.com/item/New-Arrival-Raspberry-Pi-Zero-Camera-5MP-RPI-Zero-Camera-Module-Webcam-for-Raspberry-Pi-Zero/32785811007.html?spm=2114.01010208.3.12.clLgGm\u0026ws_ab_test=searchweb0_0,searchweb201602_4_10065_10130_10068_10136_10137_10138_10060_10062_10141_10056_10055_10054_10059_10099_129_10103_10102_10096_10148_10147_10052_10053_10050_10107_10142_10051_10143_10084_10083_10119_10080_10082_10081_10110_10111_10112_10113_10114_10037_10032_10078_10079_10077_10073_10070_10123_10120_10124-10120,searchweb201603_6,afswitch_1_afChannel,ppcSwitch_7,single_sort_0_default\u0026btsid=71405a16-56ea-4466-a92f-cae0d046ea2e\u0026algo_expid=6607631f-0fea-4dff-8fec-95a907b45e65-1\u0026algo_pvid=6607631f-0fea-4dff-8fec-95a907b45e65\n  [2c44525c]: https://www.raspberrypi.org/blog/raspberry-pi-zero-w-joins-family/ \"Info\"\n  [829f44e8]: https://www.raspberrypi.org/blog/raspberry-pi-zero-w-joins-family/ \"Info\"\n\n\n## Getting started\n\nConnect to your Raspberry PI using SSH or using a monitor. Make sure you have the Raspberry PI camera already working, You can test using the following command:\n\n```bash\nraspistill -o cam.jpg\n```\n\nIf camera is not working, make sure it's activated in the setup (option 5):\n```bash\nsudo raspi-config\n```\n\nIf you have problems, check: https://www.raspberrypi.org/documentation/configuration/camera.md\n\nNow, clone this repository using git (recommended) in the root of your Raspberry PI home directory:\n\n```bash\ncd /home/pi\ngit clone https://github.com/geraldoramos/pigeon.git\ncd pigeon\n```\n\nWhen ready, give execution permission to the setup script and run it:\n\n```bash\n chmod +x pigeon_install.sh\n ./pigeon_install.sh\n```\n\nThe installation should take about 10-15 minutes and inputs from you will be necessary towards the process (ex: Dropbox configuration)\n\n## After Installation\n\nAfter the installation is completed, you will be able to watch the camera live feed by accessing:\n\n```\nhttp://[PI-ADDRESS]:[8099]\n```\n\nIf you want to setup remote access, make sure to setup port forwarding in your modem admin panel (port 8099 to your Raspberry IP.)\n\nIf everything went fine, you will start seeing MP4 clips being saved on your Dropbox folder when motion events are triggered.\n\nIf you want to start at boot, edit the rc.local file as following:\n```Bash\nsudo nano /etc/rc.local\n```\nAdd the following command below the comment, but leave the line exit 0 at the end, then save the file and exit\n\n```\nmotion -c /home/pi/pigeon/pigeon.conf\n```\n\nTo finalize, make sure you are using the right timezone, so the camera clips date will make sense to you.\n\n```\nsudo raspi-config\nSelect: Internationalisation Options\n\n```\n\n## Issues\n\nIf you are getting the \"Unable to open video device\" grey screen, you can try:\n\nRun the command: `sudo modprobe bcm2835-v4l2 ` [More info](https://raspberrypi.stackexchange.com/questions/27737/unable-to-open-video-device-and-grey-screen)\n\n**OR**\n\nInstall Motion again directly from the repository:\n\n```wget https://github.com/Motion-Project/motion/releases/download/release-4.0.1/pi_jessie_motion_4.0.1-1_armhf.deb dpkg -i pi_jessie_motion_4.0.1-1_armhf.deb```\n\n\n\n## Current stage\n\nThis project is early stage and I'm looking for contributors. You can edit the ```pigeon.conf``` file to change default configurations and make it more suitable for your needs.\n\n\n## Movement detected by the first assembled Pigeon (a squirrel)\n![Squirrer](https://s3-us-west-1.amazonaws.com/allge.us/squirrel.jpg)\n\n\n## This project uses code from the following repositories:\n* [Motion-Project](https://github.com/Motion-Project/motion)\n* [Dropbox-Uploader](https://github.com/andreafabrizi/Dropbox-Uploader)\n\n\n## License\nPigeon is distributed under the GNU GENERAL PUBLIC LICENSE (GPL) version 2 or later\n\nFollow me on [Twitter](http://twitter.com/geraldoramos)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeraldoramos%2Fpigeon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgeraldoramos%2Fpigeon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeraldoramos%2Fpigeon/lists"}