Whitebox Plugin - Insta360 Camera Support
This is a plugin for whitebox that enables support for Insta360 cameras using the insta360 library.
Live X4 preview sessions publish transient, non-persistent gravity observations
for the matching device_connection_<id> stream. Raw X4 acceleration maps to
the right-handed Three.js leveling-root frame (+X world, viewer-left with the
current +Z camera target; +Y up; +Z target-forward) as (ay, ax, az), is
confidence-gated and EMA-filtered on every eligible sample. This
Device calibration is distinct from ThreeJS's private, unchanged
source-to-SphereGeometry projection basis (x, y, z) -> (z, y, -x). Gyroscope
values are not integrated and no yaw is inferred.
Live publication is uncapped by default, with no intentional rate delay. Set
WHITEBOX_INSTA360_LEVELING_MAX_HZ in Whitebox's container environment to a positive
finite number (fractional Hz supported) to limit publication using monotonic elapsed
time. Missing or 0 means uncapped; negative, nonfinite, empty or malformed values
fail daemon startup with a configuration error, as do nonzero values too small to
represent as a floating-point rate. Restart the daemon after changing
its environment; recreate its container when changing Compose environment values.
This is a maximum publication cadence, not guaranteed sensor or render FPS. Filtering is independent of the cap. Delivery keeps only the latest pending trusted value, replacing obsolete observations during rate waits or slow sends rather than replaying a backlog. A replacement stream generation discards retired pending data and starts a new cadence with an immediate first publication. Video remains independently transported; this does not imply video-frame synchronization or camera-equivalent stabilization.
Installation
Simply install the plugin to whitebox:
poetry add whitebox-plugin-device-insta360
Adding Plugin to Whitebox Locally (For Development)
- Set up whitebox locally.
- Clone this repository.
- Add plugin to whitebox using the following command:
poetry add -e path/to/plugin. - Run the whitebox server.
Running Plugin Tests Locally
- Ensure you have the plugin installed in whitebox like mentioned above.
- Run the tests:
make test.
Contribution Guidelines
- Write tests for each new feature.
- Ensure coverage is 90% or more.
- Google style docstrings should be used for all functions and classes.
2 maintainers
Metadata
2 maintainers
Release files for whitebox-plugin-device-insta360 0.1.40
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| whitebox_plugin_device_insta360-0.1.40.tar.gz | 47.6 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| whitebox_plugin_device_insta360-0.1.40-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 147.5 kB
Release files / whitebox_plugin_device_insta360-0.1.40.tar.gz
| Download URL | whitebox_plugin_device_insta360-0.1.40.tar.gz |
|---|---|
| Size | 47.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b56891b4dca7d1603d32cc4ca3d0b79563fb0ad2d0da731a0389bb7c6b130a71
|
|
BLAKE2b-256 checksum How to use checksums |
7ce6fd4cf97333649dfda9c630d991eafc72e3e73a374ed30627d8ea641b8792
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.2.0.dev0 CPython/3.14.4 Linux/6.1.75+
|
Release files / whitebox_plugin_device_insta360-0.1.40-py3-none-any.whl
| Download URL | whitebox_plugin_device_insta360-0.1.40-py3-none-any.whl |
|---|---|
| Size | 99.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
dc7a26649d9399afa57d87b5d90b4572cec823a142fb8b8e16242342af3b7f5e
|
|
BLAKE2b-256 checksum How to use checksums |
94dd765bd6b888ea78700803f07d9a6dd919a147142eae8ed44cef73f86470f0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.2.0.dev0 CPython/3.14.4 Linux/6.1.75+
|
Security for whitebox-plugin-device-insta360 0.1.40
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
