camera.timelapse

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

camera.timelapse

★ 20 Open GitHub ↗

Take timelapse photos with a Raspberry Pi camera and automatically generate an MP4 on a daily basis. Optionally upload the daily timelapse to YouTube.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Camera (Timelapse)
Take timelapse photos with a Raspberry Pi camera and automatically generate an MP4 on a daily basis.  Optionally upload the daily timelapse to YouTube.

---

## Getting Started

- Use [Raspberry Pi Imager](https://www.raspberrypi.com/software) to install Raspberry Pi OS Lite *(Bookworm)* on a microSD card
- Use [raspi-config](https://www.raspberrypi.org/documentation/configuration/raspi-config.md) to:
  - Enable the CSI camera interface
  - Set up your WiFi connection
- Connect the Raspberry Pi camera to your Raspberry Pi

## Installation

Installation of the program, as well as any software prerequisites, can be completed with the following two-line install script.

```bash
wget -q https://raw.githubusercontent.com/eat-sleep-code/camera.timelapse/master/install-camera.timelapse.sh -O ~/install-camera.timelapse.sh
sudo chmod +x ~/install-camera.timelapse.sh && ~/install-camera.timelapse.sh
```

---

## Usage
```bash
camera.timelapse <options>
```

### Options

+ _--interval_ : Set the timelapse interval    *(default: 10)*
+ _--framerate_ : Set the output framerate     *(default: 60)*
+ _--rotate_ : Rotate the camera in 90&deg; increments     *(default: 0)*
+ _--exifFStop_ : Set the numeric F-Stop value in the image EXIF data *(default: Not specified)*
+ _--exifFocalLength_ : Set the numeric Focal Length value (mm) in the image EXIF data *(default: Not specified)*
+ _--exifFocalLengthEquivalent_ : Set the numeric 35mm Focal Length value (mm) in the image EXIF data *(default: Not specified)*
+ _--outputFolder_ : Set the folder where images will be saved     *(default: dcim/)*
+ _--retention_ : Set the number of days to locally retain the captured files    *(default: 7)*
+ _--waitUntilAnalysis_ : Set whether to perform an initial analysis.     *(default: False)*
+ _--renderVideo_ : Set whether a video is generated every 24 hours     *(default: True)*
+ _--uploadVideo_ : Set whether to automatically upload videos to YouTube    *(default: False)*
+ _--privacy_ : Set the privacy status of the YouTube video  *(default: public)*

### Example
```bash
camera.timelapse --rotate 180 --exifFStop 2.2 --exifFocalLength 2.75 --exifFocalLengthEquivalent 16 --retention 14 --uploadVideo True
```

> [!TIP]
> The EXIF data shown above is completely optional but may prove useful when using captured images with third-party applications such as photogrammetry software.

---

## Automatic YouTube Upload

- Copy [config.json.example](config.json.example) to a new file called __config.json__.
- Sign in to the [Google APIs & Services](https://console.cloud.google.com/apis/dashboard) console.
- If necessary, create a new Project.
- Expand the left menu and select the __Enabled APIs & services__ menu item.
- Click the __+ ENABLE APIS AND SERVICES__ button.
- Search for &ndash; and enable &ndash; the __YouTube Data API v3__.
- Select the __Credentials__ menu item from the left menu.
- Click the __+ CREATE CREDENTIALS__ button and select __OAuth client ID__ from the dropdown menu that appears.
- :heavy_exclamation_mark: Select __Desktop app__ from the __Application Type__ dropdown menu.  Selecting any other option from the list will make authentication impossible. :heavy_exclamation_mark:
- Enter an appropriate value in the __Name__ field and click the Submit button.   
- From the screen that appears, copy the Client ID and Client Secret and paste them in the appropriate places within the config.json file you created in the first step.
- Open a terminal and execute `./camera.timelapse/setup-youtube-device-trust.sh`.  You will be prompted to open a link in the browser.
- You will receive a warning about only continuing if you trust the requestor.   If you trust yourself, advance to the final step to complete the authentication process.
- Be sure to set __--uploadVideo__ to __True__ when you launch `camera.timelapse` to automatically upload the new videos after they are created each day.
---

## Autostart Timelapse Sequence
Want to start the timelapse sequence every time you boot your Raspberry Pi?  Here is how!

* Review `/etc/systemd/system/camera.timelapse.service`
   * If you would like to add any of aforementioned options you may do so by editing the service file.
* Run `~/camera.timelapse/install-camera.timelapse.service.sh`

---

## Infrared Cameras
If you are using an infrared (IR) camera, you will need to modify the Auto White Balance (AWB) mode at boot time.

This can be achieved by executing `sudo nano /boot/config.txt` and adding the following lines.

```bash
# Camera Settings 
awb_auto_is_greyworld=1
```

> [!NOTE]
> While IR cameras utilize "invisible" (outside the spectrum of the human eye) light, they can not magically see in the dark.   You will need to illuminate night scenes with one or more IR lights to take advantage of an Infrared Camera.

---

> [!TIP]
> If you are using a Raspberry Pi with 1GB &ndash; or less &ndash; of memory, you may wish to increase your SWAP file to match your memory size as outlined in this [third-party guide](https://pimylifeup.com/raspberry-pi-swap-file/).

---

> [!IMPORTANT]
> *This application was developed using a Raspberry Pi V3 12MP (2023) camera and a Raspberry Pi Zero 2 W board.   This application should also work without issue with Raspberry Pi 5, Raspberry Pi 4B, Raspberry Pi 3B and 3A, and Raspberry Pi Zero W boards.   This application should also work with Raspberry Pi HQ (2020) cameras.   Issues may arise if you are using either third party or older hardware.*

camera.timelapse

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README