Complete cleanup.

.gitignore

@@ -1,13 +1 @@
-# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm
-
-*.iml
-
-## Directory-based project format:
-.idea/
-/bin/
-/target/
-
-## 
-.classpath
-.project
-.settings/
+images/*

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "Dropbox-Uploader"]
+	path = Dropbox-Uploader
+	url = [email protected]:andreafabrizi/Dropbox-Uploader.git

README.md

@@ -4,12 +4,33 @@ Timelapse photography with the Raspberry Pi camera.
 
 ## Summary
 
-A long-term time lapse is an effective and fun way to communicate changes over time. However, most cameras which are custom-built to capture time lapse videos are very costly. While DSLRs are able to capture photos at set intervals, the images captured cannot be accessed (without purchasing additional equipment) until the entire set of photos. Our project captures the individual frames of a time-lapse video with cheap, reliable, off-the-shelf components, with the added benefit of allowing one to review and work with the images as they are being captured by uploading the images to Dropbox.
+A long-term time lapse is an effective and fun way to communicate changes over time. However, most cameras which are custom-built to capture time lapse videos are very costly. While DSLRs are able to capture photos at set intervals, the images captured cannot be accessed (without purchasing additional equipment) until the entire set of photos. Our project captures the individual frames of a timelapse video with cheap, reliable, off-the-shelf components, with the added benefit of allowing one to review and work with the images as they are being captured by uploading the images to Dropbox.
+
+## Installation
+
+Clone this repository to your Raspberry Pi and run the `run_timelapse` script. By default, the script will take images to the `images` directory once every minute, and _not_ upload it to Dropbox.
+
+### Dropbox Upload
+
+If you would like to upload the images to Dropbox, either ensure that the `images` folder exists on your Dropbox, or run
+
+```sh
+./Dropbox-Uploader/dropbox_uploader.sh mkdir images
+```
+
+### Auto-Start on Reboot
+
+If you would like the script to run on reboot, add the following line to your crontab via `crontab -e`
+
+```crontab
+# runs script once on reboot
+@reboot /PATH/TO/REPO/run_timelapse &
+```
 
 ## Other Work
 
 Plenty of work has already been done in the field of time-lapse photography, including an [Instructables Site](http://www.instructables.com/id/How-to-make-a-long-term-time-lapse/), an amazing [Vimeo video](http://www.photographyblogger.net/a-year-long-time-lapse-study-of-the-sky/), and a [project by David Hunt](http://www.davidhunt.ie/raspberry-pi-in-a-dslr-camera/) using a Raspberry Pi to control a DSLR camera
 
-## Additonal Resources
+## Additional Resources
 
 [Testing Multiple Pi Camera Options](https://www.raspberrypi-spy.co.uk/2013/06/testing-multiple-pi-camera-options-with-python/)

on_the_pi/rtlC → run_timelapse

@@ -1,7 +1,10 @@
 #!/bin/bash
 # Timelapse controller for Raspberry Pi
 
-IMAGEDIR=imagesCONTINUOUS
+# directory containing this script: https://stackoverflow.com/a/246128/1404966
+DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" >/dev/null 2>&1 && pwd )"
+
+IMAGEDIR="images"
 DELAY=54
 ISUPLOAD=0
 # Note: The total time interval between images is 
@@ -22,9 +25,11 @@ do
      esac
 done
 
-PROJECTDIR=/home/pi/techxtimelapse
-mkdir -p "$PROJECTDIR/$IMAGEDIR"
-# # /home/pi/Dropbox-Uploader/dropbox_uploader.sh mkdir "$IMAGEDIR"
+DROPBOX_UPLOADER_SCRIPT="$DIR/Dropbox-Uploader/dropbox_uploader.sh"
+
+mkdir -p "$DIR/$IMAGEDIR"
+## TODO (vtjeng): This is necessary to do the first time. Perhaps the script's mkdir has a -p flag?
+# "$DROPBOX_UPLOADER_SCRIPT" mkdir "$IMAGEDIR"
 
 # As of 13 Dec 2013,
 # -sh, -co, -sa range from -100 to 100. Default at 0
@@ -35,11 +40,13 @@ mkdir -p "$PROJECTDIR/$IMAGEDIR"
 
 while true;
 do
-	filename=$(date +"%Y%m%d_%H%M-%S").jpg
-    raspistill --metering matrix --nopreview --output "$PROJECTDIR/$IMAGEDIR/$filename"
+	FILENAME=$(date +"%Y%m%d_%H%M-%S").jpg
+    OUTPUT_PATH="$DIR/$IMAGEDIR/$FILENAME"
+    raspistill --metering matrix --nopreview --output "$OUTPUT_PATH"
 
-    if [ $ISUPLOAD = 1 ]; then
-		/home/pi/Dropbox-Uploader/dropbox_uploader.sh upload $PROJECTDIR/$IMAGEDIR/$filename $IMAGEDIR
+    if [[ $ISUPLOAD == 1 ]]; then
+        # TODO (vtjeng): make this a proper flag
+		"$DROPBOX_UPLOADER_SCRIPT" upload "$OUTPUT_PATH" "$IMAGEDIR"
 	fi
 
 	sleep "$DELAY"