THETA X Firmware 1.40.0 (released December 20, 2022)

• camera.listFiles details works as expected. See this video at 4:53
• static IP assignment in client mode works. See this article.
• Fingerprint ID changes when camera state changes, per documentation. See this article.

THETA X WebAPI Issues in Firmware 1.30.0 (released Oct 4, 2022)

Issue	More Info	Status
static IP assignment not working in client mode	community	community will check again in next firmware. Fixed in firmware 1.40.0 community tests
fingerprint ID not changing on battery state, battery level, take picture button	community	community will check again in next firmware. Fixed in firmware 1.40.0 community tests
camera.listFiles details requires startPosition	community	I believe the problem still exists in firmware 1.30.0. Need to check. There’s a workaround, so you just need to check for the camera mode and use startPosition or use startPosition for all models. Fixed in firmware 1.40.0 community tests

Official API Reference Document from RICOH

• THETA Web API v2.1
• THETA Plug-in API
• THETA BLE API
• THETA USB API

Official RICOH iOS and Android SDKs

Uses the WebAPI.

• theta-api2.1-android-sdk
• theta-api2.1-ios-sdk

THETA X Live Streaming to Linux Using USB Cable

• Live Stream RICOH THETA X on Ubuntu 22.04
• libuvc-theta
• gstthetauvc
• libuvc-theta-sample on GitHub with small modifications for THETA X

THETA X Plug-in Starter Examples and Libraries

The plug-in in the THETA X can access the RICOH THETA WebAPI or the Camera API, based on the Android Camera API (deprecated, but it still works).

• theta-plugin-camera-api-sample-x
• theta-plugin-sdk
• theta-plugin-library

If you use the CameraAPI, you need to import the plugin-library for camera features specific to the THETA X.

import theta360.hardware.Camera
import theta360.media.CamcorderProfile
import theta360.media.MediaRecorder

To set permissions settings on the plug-in, you may need to call up the settings screen with this command.

adb shell am start -a android.settings.SETTINGS

Using Vysor, you can enable the permissions.

THETA X Wireless Live Streaming Plug-in Example

• theta-wireless-live-streaming-plugin

THETA X Plug-in Development Tips

• Using THETA X with external bluetooth microphone (firmware 1.30.0 or newer required)

THETA X WebAPI Development Tips

• Turn off authentication in client mode (firmware 1.20 or newer required)
• camera.listFiles workaround (startPostion still required in firmware 1.30.0. May be fixed in newer updates. last checked Oct, 2022)
• fingerprint ID fixed.

Sample Images Inside of TH-3 Case

TH-3 case offers increased camera protection with reduced image quality and increased glare.

• Outdoor courtyard – THETA X inside TH-3 case
• Rear seat of 10 year old beater minivan – THETA X inside TH-3 case
• Underside of beater minivan near catalytic converter – THETA X inside TH-3 case
• Under car 2
• Under car 3

Upcoming Tests

• Image Metadata: Verify HDR in JPG pictures: exiftool analysis of MakerNote -> ReceptorIFD -> 0x0002 -> SphereHDR
• Heat: remove battery, turn off LCD, reduce framerate on LCD if you need the LCD

VSLAM

Example THETA X plug-in with open source code available

VSLAM-plugin-sample

Example THETA X plug-ins without source code

Route Shooting BETA

Outside-in Shooting BETA

There is a pre-installed plug-in called VSLAM. You can access the VSLAM service using the sample app above as a reference.