Used to shoot time lapse 360 photos with cameras that support the Open Spherical Camera API.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Used to shoot time lapse 360 photos with cameras that support the Open Spherical Camera API.

This is a proof of concept script I originally wrote to run on a raspberry pi with a Ricoh Theta S camera. It has since been updated to support the Theta V. The original was an attempt to get my Theta S camera to shoot stills faster than using the built in intervalometer. In testing I was able to shave about 2 seconds from the shooting time, This however only seems to work using WIFI and not the USB. It also supports geotaging with gpsd and camera metering via an adafruit LUX meter. Metering features are still a work in progress and require a familiarity with the Raspberry pi GPIO interface. With metering enabled you can force the exposure to ramp in a single direction, this is useful for things like sunrise and sunsets. USB features were experimental and I will no longer be adding to them. If you only need to capture, download, and delete images from the camera you may want to look at using ptpcam alone 'ptpcam --loop-capture=5 --interval=3' for USB.

Early test fotage can be found here:

Use at your own risk!

Docker support:

Docker is not required to use this script. The Docker file has been included to simplify things. Use the following commands to build and run the script in doker. Note when saving files you must specify a volume to mount into the container and the -O option will be relative to the path in the container.

Docker build

$ sudo docker build -t alpine_tlapser360 .

Print help

$ sudo docker run -v /reflection_pool/tmp/humboldt/tlapser360_061618_test001:/mnt alpine_tlapser360 -h

Take pictures with camera in client mode

$ sudo docker run -v /tmp/tlapser360_test001:/mnt alpine_tlapser360 -H -I 5 -C 10 -m 2 -W y -r l -a "THETAYL00SERIALNUM:password" -O /mnt



  • -H Camera hostname or IP address (defaults to
  • -p Camera port (defaults to 80)
  • -a Authentication string for client mode "THETAYL:<s/n or password>". NOTE: this is not secure!
  • -l Legacy support, if added this script should work with a Theta S which defaults to api v2. Read here
  • -I (Interval seconds) : This sets the sleep interval time between photos. Be aware this does not take into consideration any latency added by features of this script such as image downloads, usb control, gps metat data injection, ilong exposures, etc. This means if you set a 10 second interval your photos may be taken every 12 seconds. You can also set this to a lower threshold than the Ricoh Theta S can shoot using it's built in intervalometer. In testing I've been able to shoot a photo ever 3 seconds in low resolution and 5 seconds in high res without over running the on cammera buffer.
  • -U (y/n) default n. Usb mode for Ricoh Theta S. This will control the camera over usb and requires libptp and gphoto2.
  • -W (y/n) Default y Wifi mode unless USB mode is enabled. Control the camera using the direct wifi connection and Opens Spherical camera API.
  • -C (Image count) How many total images you would like to take.
  • -m (Exposure Program mode 1 2 4 9) 1 = Manual, 2 = Auto, 4 = shutter priority, 9 ISO priority
  • -G (0/1) GPS metadata injection. This relies on GPSD being installed and properly configured. It may also introduce latency so adjust your interval accordingly.
  • -T (GPS Track log path and file name) Write a gps track log, relies on GPSD.
  • -r (h/l) Image resolution size h=5376x2688 l=2048x1024 Set the resolution of the image. I may depricate this and use -K.
  • -i (iso) Camera iso ex. 100, 125, 160, 200, 250, 320, 400, 500, 640, 800, 1000, 1250, 1600
  • -s (shutter speed) Floating point or integer, based on wifi api. ie 0.0004=1/2500, 0.04=1/25, 0.4=1/2.5, 4=4 seconds.
  • -w (White Balance) In WIFI mode (auto, daylight, shade, etc) USB mode in hex? (2, 4 ,8001) Check the api guides for details.
  • -O (Output path /) Path to where you would like output image files.
  • -d (0/1) if images are downloaded delete them from the camera.
  • -F Config file - NOT SUPPORTED YET
  • -M (0/1) use a TSL2561 LUX sensor for metering. if used we will add time to your interval
  • -R Ramp exposure speed up (longer shutter - Sunset) or down (shorter/faster shutter - Sunrise) based on external LUX meter.
  • -A (time) Sunrise time (24hr no : ex, 6:00AM=600) -P Sunset time (24hr no ":" ex, 7:00PM=1900)


  • Using USB take a large resolution photo every 5 seconds for a total of 5 images with the camera set to manual mode, iso 100, white balance auto, and a shutter speed of .5 seconds while writing the images to a directory and leaving them on the camera..
./ -U y -I 5 -C 5 -m 1 -r h -i 100 -s 0.5 -w 2 -O /mnt/tmp/tlapser_test/

Copyright 2016 - Jason Charcalla