The THETA V plug-in application development process is the same as the development process for an Android phone. Setting up the development environment on a Mac is very similar to using either Windows or Linux, with a few small differences.

If you are interested in developing for the THETA V, please contact us for more information on how to unlock your THETA V and how to get developer documentation.

This article is a quick taste of Android development on a Mac. I used both a MacBook Air, 11-inch, Early 2015, OS X El Capitan, Version 10.11.6, and an iMac, 27-inch, Mid 2010, macOS High Sierra, Version 10.13.4.

[UPDATED Apr 30, 2018, with easier and more accurate information on installing adb. It comes with Android Studio. My original posted added separately - a second, unnecessary time.]

Main Steps

Step 1: Get a RICOH THETA V and update to the latest version of firmware - Currently at 2.11.1

Step 2: Enable developer mode for your THETA V - This currently requires you to contact theta360.guide to find out how

Step 3: Install Android™ Studio - It will automatically detect your system and offer the Mac version

Step 4: Connect RICOH THETA V with USB

Step 5: Run adb devices -l in a terminal window

If this does not instantly work, you need to find the Android SDK on you Mac and add it to your PATH.

In Android Studio, under Preferences, go to Appearance & Behavior and System Settings and look at Android SDK. It will show Android SDK Location.

If that doesn’t work or you prefer the command line, here’s a good summary on Stack Overflow here.

Now you’re ready!

Import Ricoh Sample Plugin

You will get the first remote control Plug-in example directly from RICOH as a .zip file (142 KB). The pluginsample.zip file requires you to enter a password which will be supplied.

Import Project from File -> New -> Import Project

Your security setup on the Mac will (probably) ask “Allow incoming Java connections?” Click on YES

You may need to update your Android SDK Platform-tools. The latest version is Android SDK Platform 26. Click on the link in Android Studio to do the update.

You’ll see the Component Installer window.

Then install your Build Tools. You’ll be installing SDK Build-Tools 26.0.3. Click on the link to do the update.

You’ll see the Component Installer window again.

Android Gradle Plugin Update is recommended.

Click Update.

Next, you’ll need Android Debug Bridge (adb) to move the plug-in over to your unlocked THETA V. adb is a versatile command-line tool that lets you communicate with a device. adb facilitates a variety of device actions, such as installing and debugging apps, and it provides access to a Unix shell that you can use to run a variety of commands on a device. Pretty handy.

Setting up adb on Mac OS X

Stack Overflow shows three different ways to set up adb on your Mac (Using Homebrew, Manually, and If you already have Android Studio installed). I chose probably the easiest one, Using Homebrew. It provides automatic updates.

stackoverflow.com Set up adb on Mac OS X

Install homebrew

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Install adb

brew cask install android-platform-tools

Start using adb

adb devices

Or, to get more verbose information, use

adb devices -l

You’re up and running. Now you can start working with the plug-in that has been successfully installed on your unlocked THETA V.

Here’s me surprised that you can run the sample plugin (removed control) directly with your Mac and the Android emulator program Vysor.

If you’re interested in the plug-in technology and getting access to the closed beta SDK, let us know!