{"id":22468567,"url":"https://github.com/projectweekend/pi-camera-time-lapse","last_synced_at":"2025-08-02T08:32:24.251Z","repository":{"id":17128021,"uuid":"19894267","full_name":"projectweekend/Pi-Camera-Time-Lapse","owner":"projectweekend","description":"A time-lapse program for the Raspberry Pi Camera Module with automatic uploads to Dropbox","archived":false,"fork":false,"pushed_at":"2021-06-01T21:57:32.000Z","size":72,"stargazers_count":6,"open_issues_count":3,"forks_count":4,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-04-13T11:07:19.948Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/projectweekend.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}},"created_at":"2014-05-17T19:18:56.000Z","updated_at":"2019-08-20T18:21:25.000Z","dependencies_parsed_at":"2022-08-24T13:52:30.396Z","dependency_job_id":null,"html_url":"https://github.com/projectweekend/Pi-Camera-Time-Lapse","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/projectweekend%2FPi-Camera-Time-Lapse","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/projectweekend%2FPi-Camera-Time-Lapse/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/projectweekend%2FPi-Camera-Time-Lapse/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/projectweekend%2FPi-Camera-Time-Lapse/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/projectweekend","download_url":"https://codeload.github.com/projectweekend/Pi-Camera-Time-Lapse/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228453982,"owners_count":17922585,"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":[],"created_at":"2024-12-06T11:17:43.738Z","updated_at":"2024-12-06T11:17:44.248Z","avatar_url":"https://github.com/projectweekend.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Installation \u0026 Setup\nThe following instructions cover everything necessary to setup your Raspberry Pi for this project. I tried to script out a good chunk of system installation stuff to help keep things fairly simple. With that said, I welcome feedback about how to make this better.\n\n#### Step 1: Clone this repository\n\n```\ngit clone https://github.com/projectweekend/Pi-Camera-Time-Lapse.git\n```\n\n#### Step 2: Authorize Dropbox account\nTo automatically upload time-lapse images to Dropbox, you must authorize your account with the Pi Camera Time-Lapse Dropbox app. I made the the following website to handle this process and generate a key file you will need to save on your Raspberry Pi: [http://pi-camera-time-lapse.herokuapp.com/](http://pi-camera-time-lapse.herokuapp.com/). Once the `dropbox.txt` file is downloaded, save it the root of the project directory: `Pi-Camera-Time-Lapse/`.\n\n#### Step 3: Run install script\n\nFrom the project directory `Pi-Camera-Time-Lapse/`, run the following command:\n\n```\n./install.sh\n```\n\n**NOTE:** This step will probably take several minutes to complete. When the script starts to install [Upstart](http://upstart.ubuntu.com/), you will receive a warning message. It will prompt you to type the following message to confirm the installation: `Yes, do as I say!`. You must type it exactly.\n\n#### Step 4: Reboot\n\n```\nsudo reboot\n```\n\n-------------------------------------------------------------------------------\n\n## Making a time-lapse\n\nTime-lapse sequences are controlled using job files written in [YAML](http://en.wikipedia.org/wiki/YAML). This file describes everything needed to execute the time-lapse. Job files must be saved in the directory `/home/pi/time-lapse/jobs` and prefixed with `job_`. If multiple files are found, they will be processed one at a time. When a time-lapse has completed, the job file will be moved into the archive folder: `/home/pi/time-lapse/jobs/archive`.\n\nThe `time-lapse` service runs in the background as an Upstart job. As soon as it finds a job file, in the directory referenced above, it will load those configurations and begin taking photos. Since there is no image preview, it's best to run a couple test images on your subject before commiting to a full time-lapse job. To do this, simply save a job file with a `snap_total` of 1. When the resulting image shows up in Dropbox, review it, tweak settings, and repeat until you get what you want.\n\n#### Example job file\n\nName: `job_sunset_time_lapse.yml`\n\n~~~yaml\nsnap_interval: 60\nsnap_total: 30\nfile_prefix: sunset\nresolution_x: 2592\nresolution_y: 1944\nquality: 100\nISO: 400\nbrightness: 50\ncontrast: 0\nsaturation: 0\nsharpness: 0\nshutter_speed: 0\nexposure_compensation: 0\nexposure_mode: auto\nrotation: 0\nawb_mode: auto\n~~~\n\nEach of the configurable options in the job file corresponds to a setting in the [picamera.PiCamera](http://picamera.readthedocs.org/en/latest/api.html#picamera.PiCamera) object. Any setting not specified in the job file will use its default value in *picamera.PiCamera*.\n\nIf you want to disable automatic Dropbox uploading, add the following line to the config file:\n\n```\nauto_upload: Off\n```\n\n#### AWB_MODES List\n\nI dug these out of `PiCamera.AWB_MODES` so you don't have to. Use these values in your job file for the `awb_mode`. The default, if the property is not set, is `auto`.\n\n* `auto`\n* `cloudy`\n* `flash`\n* `fluorescent`\n* `horizon`\n* `incandescent`\n* `off`\n* `shade`\n* `sunlight`\n* `tungsten`\n\n#### EXPOSURE_MODES List\n\nI dug these out of `PiCamera.EXPOSURE_MODES` so you don't have to. Use these values in your job file for the `exposure_mode`. The default, if the property is not set, is `auto`.\n\n* `antishake`\n* `auto`\n* `backlight`\n* `beach`\n* `fireworks`\n* `fixedfps`\n* `night`\n* `nightpreview`\n* `snow`\n* `sports`\n* `spotlight`\n* `verylong`\n\n#### IMAGE_EFFECTS List\n\nI dug these out of `PiCamera.EXPOSURE_MODES` so you don't have to. Use these values in your job file for the `image_effect`. The default, if the property is not set, is `none`.\n\n* `blackboard`\n* `blur`\n* `cartoon`\n* `colorbalance`\n* `colorpoint`\n* `colorswap`\n* `denoise`\n* `emboss`\n* `film`\n* `gpen`\n* `hatch`\n* `negative`\n* `none`\n* `oilpaint`\n* `pastel`\n* `posterise`\n* `posterize`\n* `saturation`\n* `sketch`\n* `solarize`\n* `washedout`\n* `watercolor`\n* `whiteboard`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprojectweekend%2Fpi-camera-time-lapse","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprojectweekend%2Fpi-camera-time-lapse","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprojectweekend%2Fpi-camera-time-lapse/lists"}