Sample Media and Development Resources

Welcome to working with RICOH THETA, an Android 7.1.1 OS-based device. Once the 360 degree media (images, videos, live streaming) has been generated, the image processing or other programming that may occur in-camera can be built independently of having the hardware itself.

You can create a plug-in without the camera with the no-camera-template. If you are applying for hardware, please read the document Dream and Build - Apply for Hardware Supplemental Information after you apply for hardware.

If you complete an Android no-camera challenge, your submission will be prioritized over those that just send in ideas for development.

Deadline for Apply for Hardware is April 16, 2019.

Media Assets

Currently, we are providing static images. If you need more assets, please email

Images With Metadata Taken in “Standard” Manner

Images Without Metadata Taken with Plug-in Camera API

Dual Fisheye and Stitched

Mystery Image

  • 533185782.778969.jpg - Indoor. 4 human figures and faces. Different filename format. XMP data is different from normal THETA image. Does not have ProjectionType set to equirectangular. Would be great if you can add the ProjectionType metadata back in using an Android app you build on the AVD.

Video With Metadata

Video Without Metadata

Testing Image Processing Without a Camera

The THETA V runs Android OS 7.1 internally. The camera connects to Android Studio with adb and will appear like a normal Android phone. If you do not have a THETA V, you can develop image processing programs using an Android Virtual Device. Build the apk and send it to us for confirmation.

AVD Configuration

  • 3GB RAM
  • Screen Size: 5”
  • Screen Resolution: 720x1028
  • System Image: Nougat 7.1 x86

Images are stored in /sdcard/DCIM/100RICOH


Idea #1: Apply watermark to THETA Image

Use OpenCV or other image processing library. Create a transparent image with a watermark on it. Save to camera as template. Merge THETA image with transparent image.

Idea #2: Convert JPG to WebP

Create copy of THETA image and save to WebP format

Idea #3: Create Low-Resolution Copy of Video

As the 4K video size is large. Use techniques such as creating a low-resolution version of the video for transmission over slow Internet links for editors to preview and provide feedback on the video.

Idea #4: Convert Video to Short-Looped Animated GIF

Alternate idea is to convert still images to animated GIF

Idea #5 Cloud Upload

Upload image or video to cloud backup or sharing service

Idea #6 Orientation Data as XMP Data

Attach the following data to the image as metadata using Photo Sphere XMP Metadata as a reference.

  • PosePitchDegrees (up to one decimal place such as 5.7)
  • PoseRollDegrees (up to one decimal place such as 5.7)
  • RicohPitch (same value as PosePitchDegrees, but with two decimal places such as 5.67)
  • RicohRoll (same value as PosePitchDegrees, but with two decimal places such as 5.67)

Idea #7: Orientation Data as Exif Data

Set orientation data with ExifInterface. This is one of many articles online using ExifInterface.

RICOH THETA Mobile and Desktop Software

Use the Basic app to view images and video. The Basic app can also stitch the videos.

Software Development Resources

Completing and Submitting Plug-in Without a Camera

This is for people who submitted to Apply for Hardware in the Dream and Build contest but didn’t receive a camera. There is still a good path for submitting a plug-in to the contest.

  1. Build application with sample media.
    • Create AVD. Put sample media in /sdcard/DCIM/100RICOH/ of the AVD
    • create method getPicture() that returns a String for the filename. The file name will be in this format R0010126.JPG
    • Have your program accept the string and process the file
    • there is no UI on the camera. Your program should run when a button on the camera is pressed. For example, the shutter button. For the submission, you can create a button, but we will need to move the code to the camera button.
  2. Submit private GitHub (or BitBucket) repo to @jcasman by DM on this forum
  3. will send you information on how to register for the Plug-in Partner Program (PPP) with the serial number of a camera we have.
  4. You must register for the PPP. can assist you if you have any problems
  5. After you have registered with the PPP, will create a new branch of your code on your repository and modify the branch code to run on a physical hardware camera.
  6. Oppkey will notify you when the modification is complete
  7. You test the plug-in and submit to the THETA Plug-in Store. can assist.
1 Like