A python script to generate a timelapse video. Designed specifically to record at sunset, and post to twitter with a weather report.
This project assumes that you will run this on a Raspberry Pi with a CSI-port camera, although pull requests to broaden that support are certainly accepted. @goldenhourSEA runs on a Pi 3 Model B with the Camera Module V2.
FFmpeg
FFmpeg is used to convert the sequence of photos captured by the camera into a video suitable for uploading to Twitter. FFmpeg must be compiled with x264 support. On a Raspberry Pi running Raspbian, simply sudo apt install ffmpeg
. If you are running this on a Mac, brew install ffpmeg
should be sufficient.
golden-hour
pip install .
golden-hour --help
to check that it's hooked up right!Configuration data - Twitter and Dark Sky credentials, and location information, will all live in a .yaml
file.
You can put this wherever you want but we recommend ~/.config/golden-hour.yaml
.
Check out example_config.yaml
for the expected format of the file.
So that golden-hour
knows when sunset will happen, tell it where the camera is located via the configuration file. For many major cities, you can just specify the city name.
See example_config.yaml
for the format.
twitter_secrets.yaml
file, and put the consumer key, consumer secret, access token, and access token secret in there:If you want the weather report, get a Dark Sky API key.
Once it's installed, run golden-hour --help
for usage instructions.
If you get the error "-bash: golden-hour: command not found
", you may need to restart your shell or check that golden-hour
is installed somewhere on your PATH
. See "Gotchas" below.
Once you have everything set up, set up a cron job to run golden-hour
at the same time every day. Make sure it runs at least one hour before the earliest sunset of the year. You can find this by looking at the "Sun Graph" for your city at timeanddate.com (for example, here is Seattle).
Example crontab entry (Insert this into your user's crontab with crontab -e
):
0 15 * * * golden-hour --start-before-sunset 60 --post-to-twitter
For another example, which uses a specially crafted .sh
file and a virtualenv, check out alanhussey's setup . Note that this may be out of date from the latest version of code in this repo.
When it is run by cron
, by default golden-hour
will send logs to syslog. You can monitor them with tail -F /var/log/syslog
.
golden-hour
, you will need to make sure that it's on your PATH
. This may mean adding something like PATH=~/.local/bin:/usr/local/bin:$PATH
to your crontab and your ~/.bash_profile
, or activating a virtualenv.cron
runs in a different environment from your normal shell. In my case, it did not have access to ffmpeg
, because I had installed it to /usr/local/bin
, but the $PATH
only had /bin
and /usr/bin
.date
to see what time it is for your Pi, and set the cron job to run at an appropriate translated time. I set mine to run at 2300, which is 3pm local time.