https://github.com/ricohapi/theta-client

A library to control RICOH THETA
https://github.com/ricohapi/theta-client

android flutter ios kotlin-multiplatform react-native ricoh ricoh360 theta vr

Last synced: 4 months ago
JSON representation

A library to control RICOH THETA

• Host: GitHub
• URL: https://github.com/ricohapi/theta-client
• Owner: ricohapi
• License: mit
• Created: 2023-01-24T02:42:21.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2026-02-19T05:03:03.000Z (4 months ago)
• Last Synced: 2026-02-19T07:27:28.631Z (4 months ago)
• Topics: android, flutter, ios, kotlin-multiplatform, react-native, ricoh, ricoh360, theta, vr
• Language: Kotlin
• Homepage:
• Size: 80.1 MB
• Stars: 26
• Watchers: 18
• Forks: 22
• Open Issues: 14
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# THETA Client

[![theta-client CI with Gradle](https://github.com/ricohapi/theta-client/actions/workflows/buildAndTest.yaml/badge.svg)](https://github.com/ricohapi/theta-client/actions/workflows/buildAndTest.yaml)

[![KDoc](https://img.shields.io/badge/API_reference-KDoc-green.svg)](https://ricohapi.github.io/theta-client/)

[![Kotlin](https://img.shields.io/badge/Kotlin-1.9.10-navy.svg?style=flat&logo=kotlin)](https://kotlinlang.org)

[![Swift](https://img.shields.io/badge/for_Swift-5-FF9900.svg)](https://kotlinlang.org)

[![Flutter](https://img.shields.io/badge/for_Flutter->=2.5.0-blue.svg)](https://ricohapi.github.io/theta-client/)

[![React Native](https://img.shields.io/badge/for_React_Native-0.70.8-aqua.svg)](https://ricohapi.github.io/theta-client/)

This library provides a way to control RICOH THETA using [RICOH THETA API v2.1](https://github.com/ricohapi/theta-api-specs/tree/main/theta-web-api-v2.1).

Your app can perform the following actions:

* Take a photo and video

* Acquire a list of photos and videos

* Acquire a JPEG file and MP4 file

* Acquire the status of THETA

* Acquire and set properties of THETA

## Supported Environments

* Android native (Kotlin)

* iOS native (Swift)

* React Native

* Flutter

## Supported Models

* THETA X

* THETA Z1

* THETA V

* THETA SC

* THETA S (firmware version 01.62 or later)

## Directory Structure

* theta-client

  * demos: Demo applications

  * docs: Documentation

  * kotlin-multiplatform: Library body ([Kotlin Multiplatform Mobile](https://kotlinlang.org/docs/multiplatform-mobile-getting-started.html))

  * react-native: React Native package

  * flutter: Flutter plugin

## Build

### Android (aar)

```

theta-client$ ./gradlew publishToMavenLocal

```

aar is output to `theta-client/kotlin-multiplatform/build/outputs/aar`

### iOS (XCFramework)

```

theta-client$ ./gradlew podPublishXCFramework

```

XCFramework is output to `theta-client/kotlin-multiplatform/build/cocoapods/publish`

### ReactNative & Flutter

See README in each directory.(`react-native`, `flutter`)

### Test

```

theta-client$ ./gradlew testReleaseUnitTest

```

## How to Use

See tutorials in `docs` directory and [API reference](https://ricohapi.github.io/theta-client/) of this library.

Demo applications in `demos` directory may help you understand how to use this library.

## Verification tool

A tool, written in React Native, is prepared to verify the responses and behavior of Theta to verious requests.

Using this verification tool, you can select and send a command with its parameters then its response is displayed in JSON converted from Android or iOS object.

![menu screen](docs/assets/screen_menu.jpg)

![info screen](docs/assets/screen_info.jpg)

![capture screen](docs/assets/screen_capture.jpg)

## License

[MIT License](LICENSE)

## Useful guides

* [THETA SDK docs | help](https://theta360developers.github.io/sdk/)