Skip to content
Ichi Hirota's dual-fisheye plug-in for THETA V. Sample code for the THETA developer workshop. significant modifications by community
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Dual-Fisheye For THETA V

This is a early code for the Dual Fisheye Plug-in by Ichi Hirota for the RICOH THETA V. This is not the same as the code for Ichi's plug-in that is in the plug-in store.

This repository was created for a technical workshop as part of educational curriculum.

This code is not intended for production use.

For more information on plug-in development, including use and modification of this plug-in, see the free plug-in developer guide, available at

An improved version of Ichi Hirota's app is available in the THETA Plug-in Store.

Features and Usage Information

  • 3 image dual-fisheye taken within 3 seconds
  • Each image takes approximately 1 second
  • single image dual-fisheye in less than 1 second
  • HDR blending is handled by a free third-party application called Picturenaut (see documentation for instructions)
  • Dual-fisheye to equirectangular stitching is handled by Ichi Hirota's app. Demo version available in documentation.

Benefits of This Technique

High Volume

By saving the images as dual-fisheye, the camera can take a picture once per second, instead of 4 seconds. This is good for high-volume image taking such as at a large construction or retail store site. The pictures can be stitched later in a central office.


Normally, a 3 image HDR picture will take 12 seconds. With a dual-fisheye technique, 3 images can be taken in 12 seconds.

Industrial and Scientific Applications

Some developers prefer to use dual-fisheye images. For example, people involved with object recognition and external sensor alignment use dual-fisheye images.

Repository Organization

/apk/app-debug.apk - binary to install in the RICOH THETA V
/tools/stitcher/MiSphereConverter_for_THETAV.apk - mobile stitching application for your Android phone
/app/src/main/java/com/theta360/pluginapplication/ - main plug-in source code


Dual-fisheye Image

merged image

Stitched Image

stitched image

Closeup of Stitch Line


RICOH Camera API for plug-in API for exposure compensation is available at:

The Ricoh Plug-in SDK is available at:

Alternate Versions

As the repository was prepared for a development workshop, there are examples to extend the code for different purposes.

7 Image Modification

An easy modification is to change the plug-in to take 7 images instead of 3 images. This version is available in a separate repository. However, I will move it to a branch of this repository soon.

Shutter Speed Modification

The shutter-speed branch of this repository has the following changes:

  • expanded exposure range from 1/25000 to 60 second exposure time
  • 12 image and 9 image bracket shooting
  • plug-in starts in bracket shooting mode by default instead of single-shot mode
  • exposure is controlled by shutter speed instead of exposure compensation

Usage Notes

The plug-in is called Plugin Application

You must set permissions. Documentation includes information on using Vysor.

set permissions

In single image mode, the Wi-Fi LED will be cyan.

single image

In 3 image mode, the LED will be magenta.

3 image

Switch between the modes by briefly pressing the Wi-Fi button on the side of the camera.

Known Issues

As this is an example code base for learning purposes, there are a number of issues that we are intentionally not fixing to keep the line count small and to illustrate camera behavior, including when the plug-in crashes. This example does not handle long button presses. If you press the Wi-Fi, Mode, or Shutter buttons on the camera for longer than 1 second, it will send a long button press instead of a normal button press. In many cases, the long button press will crash the plug-in. When using the plug-in, you should use short button presses only. Press and release each button quickly.

  • when going into plug-in mode, pressing the mode button for too long may crash the plug-in
  • when taking a picture in plug-in mode, pressing the shutter button for too long may crash the plug-in
  • when switching between single-shot and multi-picture mode in plug-in mode, you normally short-press the Wi-Fi button on the side of the camera. If you press this button for too long, it may crash the plug-in.



You can’t perform that action at this time.