OpenPocketCine README

The project's README from github.com/erik-sutton95/OpenPocketCine. As one markdown file: README.md.

OpenPocketCine

CI Docs License: Apache 2.0

OpenPocketCine live monitor recording on a landscape iPhone

The open field monitor for DJI Osmo.
Pro monitoring scopes, playback, camera control, and optional Frame.io upload with LUT baking. Free and open source.

Join the TestFlight  ·  Visit openpocketcine.app  ·  Docs  ·  Explore the roadmap

Made for the shot

OpenPocketCine is a production monitor and remote for the DJI Osmo series. Live view is captured today for Osmo Pocket 4 / 4 Pro (HEVC) and, on iOS, Osmo Nano (AVC). Other Osmo bodies can show up in Bluetooth scan; Action and 360 live view is not captured yet.

iOS (iPhone and iPad) is the daily driver. Android is a Play closed-testing beta (waitlist on openpocketcine.app).

Verify record start/stop on the camera body until you trust the link. Reverse-engineered control can be incomplete.

See it in action

Face lock. On iOS Pocket in AF-C, tap a face on the feed to start the camera's subject tracking. Histogram, zebras, and a LUT stay on while you record.

Live monitor with custom face tracking for gimbal lock-on

Scopes. Read the image like a colorist. Waveform, RGB parade, histogram, and vectorscope run live beside the image you are judging, with Traffic Lights on the feed.

Waveform and Traffic Lights over a live view

View assist. Catch it before the take. False color, zebras, Traffic Lights, peaking, grids, and crosshairs sit on the iOS assist rail — including in portrait.

Portrait assist rail with zebras and framing tools

Camera control. On iOS: record, ISO, EV, zoom, and related writes, plus gimbal on Pocket (on-screen stick, a connected game controller, or iOS AirPods head tracking). On Pocket 4 Pro, zoom while you're in D-Log2 hops to D-Log automatically so you keep moving.

Camera controls and zoom while recording

Media library. On iOS, browse clips and stills on the camera. Star the keepers and delete bad takes before you pack up.

Media library showing clips and photos on iPhone

Playback. On iOS and Android, the same scopes and assists as live view, armed from the playback rail (GPU LUT / peaking / zebra on Android playback is a follow-up; the chips already persist). Export with an optional baked LUT on iOS, preview high-frame-rate clips at conform speed, share natively, or upload to Frame.io when Frame.io is configured.

Frame.io

Clip playback with timeline and share controls Clip playback with the full monitoring assist rail

Available today

The native Android implementation lives in this repository as a phone shell with live pairing, HEVC live view, and GPU LUT / peaking / false colour / zebra on the feed. Play closed testing is the waitlist path on openpocketcine.app. Clip export LUT bake and GPU scopes are iOS today.

Captured live view: Osmo Pocket 4 / 4 Pro, and Osmo Nano on iOS. Other Osmo models may appear in scan. Action and 360 live view is not captured yet.

Roadmap shaped in the open

The roadmap lives in GitHub Discussions, where proposed features can have their own thread. Browse the Ideas category to vote, add production context, or propose what OpenPocketCine should tackle next. Roadmap discussions describe direction, not promised dates or release commitments. Engineering-phase detail lives in docs/ROADMAP.md.

Free. Open source. Yours

No subscriptions, no paywalls, no advertising, and no telemetry. OpenPocketCine is Apache-2.0 licensed and built in public with the latest frontier models — Grok, Codex, and Claude — so filmmakers and developers can inspect, improve, and adapt the tool they rely on.

Documentation

Architecture

Production targets a shared Swift business/protocol core with native platform shells:

Layer Path Purpose
Shared core Sources/OpenPocketViewCore/ DUML framing, datalink, BLE adverts, commands, status
iOS app ios/OpenPocketCine/ SwiftUI shell, CoreBluetooth, Hotspot Configuration, VideoToolbox
Android app Apps/Android/app/ Jetpack Compose phone shell and Android platform adapters
Android facade Sources/OpenPocketCineAndroidFacade/ Swift session and JNI boundary for Android
Tests Tests/OpenPocketViewCoreTests/ Swift package tests — framing, transport, discovery, layout

The shared Swift core owns protocol logic and stays portable (no SwiftUI, UIKit, or Android dependencies). Platform shells own sockets, permissions, lifecycle, rendering, and UI.

See docs/ARCHITECTURE.md.

Built in the open

OpenPocketCine is deliberately, transparently built in public with the latest frontier models such as Grok, Codex, and Claude. Engineering guidelines live in AGENTS.md.

OpenPocketCine went through an extended private R&D phase before publication; the public repository starts from a clean slate with a squashed initial commit rather than carrying the experimental history along.

Contributors

@erik-sutton95 @KonradIT

Credits

Osmosis

I learned the BLE pairing and camera Wi-Fi connection path with the help of Osmosis by Konrad Iturbe — a generous open Android client for Osmo cameras. I'm grateful. OpenPocketCine is its own implementation; Osmosis was inspiration for that connection story, not a source I copied.

Please go look at Osmosis too. If you care about talking to Osmo cameras, Konrad's work is worth your time.

No vendor SDK

This project is not affiliated with DJI. No DJI SDK or proprietary documentation is included in, distributed with, or required by this project.

Development

Tooling is managed through just:

just setup         # install meta-check tools (macOS / Homebrew)
just               # list all recipes
just handbook      # docs at http://127.0.0.1:4321/ (live: https://openpocketcine.app/docs/)
just check         # run repository quality checks
just format        # format Swift sources
just test          # run Swift package tests
just native-check  # run Swift tests and build the native iOS app
just android-build # build the Android app and staged Swift runtime
just android-check # build, test, and lint Android
just android-play-setup # one-time Play Console + signing (closed testing)

The iOS Xcode project is generated:

cd ios && xcodegen generate && open OpenPocketCine.xcodeproj

The Simulator has no Bluetooth or camera Wi-Fi. Pairing and live view need a physical iPhone or Android phone.

iOS beta: TestFlight. Archives come from Xcode Cloud. One-time App Store Connect setup:

./scripts/setup-xcode-cloud.sh

See docs/testflight-ci.md.

Android closed testing: signed AAB from GitHub Actions onto Play closed testing (alpha), the same shape as OpenZCine’s Play Internal pipeline. One-time Play Console / signing:

just android-play-setup          # walkthrough (Console, keystore, API robot)
just android-play-sync-secrets   # push play-closed GitHub secrets

See docs/android-play-ci.md.

Contributing

Contributions are welcome!

Please also read our CODE_OF_CONDUCT.md. For security issues, see SECURITY.md.

Support

I truly appreciate everyone who uses this project, files an issue, or sends a patch. Optional Buy Me a Coffee contributions help keep the lights on. If you would rather give to a charity — especially one that helps animals — that is just as welcome.

License

Apache 2.0. Third-party licenses are listed in THIRD-PARTY-NOTICES.md. The app's privacy policy lives at openpocketcine.app/privacy.

This project is not affiliated with or endorsed by SZ DJI Technology Co., Ltd. "DJI", "Osmo", "Osmo Pocket", "Osmo Action", "Osmo Nano", and "Mimo" are trademarks of SZ DJI Technology Co., Ltd., used here for identification only. No DJI SDK is used.

OpenPocketCine (erik-sutton95/OpenPocketCine)

Searching Database…

338 ·GitHub
OpenPocketCine
Что это?OpenPocketCine — бесплатное приложение с открытым кодом: монитор и пульт управления для камер DJI Osmo Pocket, дающий киношникам колористские измерители (scopes), помощники экспозиции/фокуса и управление камерой на экране телефона.
Это библиотека или приложение, которое ставится на телефон?Это нативное мобильное приложение (не библиотека) с общим протокольным ядром на Swift и отдельными оболочками для iOS и Android, созданное, чтобы работать прямо на вашем iPhone/iPad или Android-телефоне.
Как запустить это на телефоне?Пользователям iOS — в бету TestFlight; Android сейчас в закрытой бете Play, попасть можно через лист ожидания на openpocketcine.app. Сопрягите по Bluetooth и подключитесь к Wi-Fi-точке камеры, чтобы получить Live view.
Нужен реальный телефон, или Simulator подойдёт?Нужен настоящий iPhone/iPad или Android-телефон — в iOS Simulator нет Bluetooth и Wi-Fi камеры, поэтому сопряжение и Live view там не заработают. Также нужна поддерживаемая камера DJI Osmo.
Работает ли это с любой камерой и моделью Osmo?Сейчас Live view снимается только с Osmo Pocket 4/4 Pro (HEVC) и, на iOS, Osmo Nano (AVC); другие камеры Osmo могут показываться в Bluetooth-скане, но Live view с Action и 360 пока не снимается, а управление камерой получено реверс-инжинирингом, так что может быть неполным.
На Android функции те же, что на iOS?Нет — iOS это основная платформа с измерителями, запеканием/экспортом LUT, загрузкой в Frame.io и полным управлением камерой, а нативное Android-приложение пока предлагает урезанный набор функций (запись, ISO, выдержка, баланс белого, фокус по тапу, гимбал) и всё ещё в закрытой бете.
Приложение отслеживает или монетизирует данные об использовании?Нет — нет никаких подписок, пейволлов, рекламы или телеметрии.
Можно отправить отснятое прямо в Frame.io из приложения?Да — на iOS можно экспортировать клипы с опционально запечённой LUT и загружать прямо в Frame.io, но только после того, как вы добавите собственные ключи Adobe-приложений для этой интеграции.
Что такое Osmosis и почему её упоминают?Osmosis — открытый Android-клиент для камер Osmo от Konrad Iturbe, который помог автору разобраться в BLE-сопряжении и Wi-Fi-подключении. OpenPocketCine — самостоятельная отдельная реализация, а не скопированный код.
Нужен ли приложению официальный DJI SDK?Нет. Проект не использует DJI SDK или закрытую документацию — поддержка протокола камеры получена реверс-инжинирингом.
Что именно показывает живой мониторинг?Waveform, RGB parade, гистограмма, vectorscope, false color, зебры, Traffic Lights, focus peaking, сетки, направляющие соотношения сторон и перекрестие — всё в реальном времени на iOS-картинке, плюс блокировка лиц на устройстве для слежения за объектом в AF-C.
What are similar projects?MotionShot, omi, mangayomi, happy, openhaystack, remote-mic-app, dart_simple_live, Shizuku-Next
Which topics is it in?swift-library, photography, camera, bluetooth, jetpack-compose, remote-control, app, hardware, mobile-app, swift, video, mobile
Creator
erik-sutton95
Size
18.2 MB
Stars
338
Updated
CommitOct 20Releasesideload-v0.1.5-8Oct 18
Age
2mo
Commits · 90 Days