# Tlapse

Automated time lapse photography using gphoto2.

## Installation

1. Install gphoto2

  * macOS: `brew install gphoto2`
  * Debian/Ubuntu: `sudo apt install gphoto2`

2. `gem install tlapse`

## Example: Integrate with cron

* From 9 AM to sunset, capture one image every 10 minutes

```
0 9 * * * cd $HOME && eval "$(tlapse until_sunset --interval 10)" >> capture.log
```

## CLI

Find better documentation by running `tlapse help` or `tlapse help SUBCOMMAND`

* `tlapse capture_single` - Capture an image using the tethered camera
* `tlapse until_sunset` - Generate a gphoto2 command which captures images until sunset

## API

Mostly useful for cronjobs and the like.

* Capture images between given hours
  ```ruby
  Tlapse::Capture.timelapse_command({
    from: Time.now,
    to: Time.now + 6.hours,
    interval: 30.minutes
  }) # => "gphoto2 --capture-image-and-download -I 1800 -F 12 --filename '%Y-%m-%d_%H-%M-%S.jpg'"
  ```

* Capture images from sunset to sunrise
  ```ruby
  Tlapse::Capture.timelapse_command_while_sun_is_up(interval: 30.minutes)
  # => "gphoto2 --capture-image-and-download -I 1800 -F 11 --filename '%Y-%m-%d_%H-%M-%S.jpg'"
  ```

## License

The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).