Interface a raspberry pi and the USB API with the Ricoh Theta S for time lapse spheres. Uses libptp
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 5 commits ahead, 1 commit behind khufkens:master.
THETA Developers Unofficial Community
THETA Developers Unofficial Community fixing typo
Latest commit b2ec385 Oct 5, 2017
Failed to load latest commit information.
cad-files first push Oct 15, 2016
libptp first push Oct 15, 2016
LICENSE Initial commit Aug 20, 2016 fixing typo Oct 5, 2017 tweak script Oct 15, 2016 first push Oct 15, 2016 first push Oct 15, 2016 first push Oct 15, 2016


The photosphere project combines a Ricoh Theta S and a raspberry pi with a custom outdoor housing into a rugged 360 (outdoor) time-lapse camera. In my application I track changes in leaf development in a North-Eastern US forest. You can visit the project website at However, other applications are possible (hints on how to do nighttime images through the USB API are welcome).

NOTE from community: For information on night images using an external LUX meter, see tlapser

The housing is made of standard PVC fittings, sitting on top of a garden fence post. The optics are covered by a glass lamp shade to provide optimal transmission and limited deformation (acrylic globes can be used as well). The only custom part is the plate on which the camera is mount using 1/4" steel thread. This plate is cut out of 3mm acrylic plastic. A vertical support also holds the raspberry pi to keep things tidy (see cad files). I use two 3mm plates extra rigidity (glued together). You can also use a 6mm top plate and a 3mm vertical plate. The inside of the "lens cover" is spray painted matte black to limit reflections.

Constructed and placed in the forest the camera looks like a garden lamp (see figure). Here the blue wire is the ethernet cable which runs to a nearby hub, and serves as the internet and power connection. The yellow wire is the ground wire for the surge protector, to protect the camera from voltage spikes due to nearby lightning strikes.


To install the software clone the project onto a raspberry pi and run the install script.

git clone

You will have to edit the crontab manually to add the server argument (for now).

Parts List

I assume that common items such as screws and glue (pvc, silicone) are available to makers.

Item Price ($)
Ricoh Theta S $350
Raspberry pi 2 $36
6-60V - 5V 3A UBEC $19
24V POE injector $10
APC surge protector $18
200ft / 50m Cat5e cable $13
8" glass globe lamp cover $35
4" (10cm) PVC pipe $20
4" (10cm) PVC coupler $2.5
3.5" Wooden Fence post $5
36" ground anchor $30
3mm Plexiglass sheet $5
1/4" stainless steel rod $1
1/4" (coupling) nuts $1
1/4" washers $1
TOTAL ~$550

NOTE: Information below added by theta360developers

Information on the WiFi and USB APIs is available in the Unofficial API Guide.

Discussion for this project is available on the site.

General discussion on USB API usage for the RICOH THETA is available in this topic.