https://github.com/coral/blackmagic-camera-control
Interface with your Blackmagic camera over Bluetooth in Rust
https://github.com/coral/blackmagic-camera-control
blackmagic blackmagic-design blackmagicdesign ble bluetooth camera cinema control rust
Last synced: about 1 year ago
JSON representation
Interface with your Blackmagic camera over Bluetooth in Rust
- Host: GitHub
- URL: https://github.com/coral/blackmagic-camera-control
- Owner: coral
- License: mit
- Created: 2021-08-21T19:41:50.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2022-12-06T08:16:20.000Z (over 3 years ago)
- Last Synced: 2025-06-05T07:36:14.201Z (about 1 year ago)
- Topics: blackmagic, blackmagic-design, blackmagicdesign, ble, bluetooth, camera, cinema, control, rust
- Language: Rust
- Homepage:
- Size: 70.3 KB
- Stars: 20
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Interface with your Blackmagic camera over Bluetooth in Rust!
This library allows you to easily communicate with your Blackmagic camera over Bluetooth.
- Implements the full camera spec for easy access to commands with static type checking `Command::Video(Video::Iso(640)))`
- Uses [btleplug](https://github.com/deviceplug/btleplug) for Bluetooth to work across platforms.
- Consumes `PROTOCOL.json` for code generation so it's easy to add more functions to the library
## Usage
You can test the library easy by opening `examples/control.rs`, replacing the _CAMERA_NAME_ const with your cameras bluetooth name and then running `cargo run --example control`
```rust
//Create a new camera with the device name
let mut camera = BluetoothCamera::new(CAMERA_NAME).await.unwrap();
//Connect with a set timeout
camera.connect(Duration::from_secs(10)).await.unwrap();
//Change the ISO to 320
camera.write(255, Operation::AssignValue, Command::Video(Video::Iso(640))).await.unwrap();
```
## How does it work?
The library consumes the [PROTOCOL.json](https://github.com/coral/blackmagic-camera-protocol) file which documents the camera protocol in a machine readable format. From there it generates the commands as rust enums during the build stage (see /build). This allows us to have statically typed addressing of camera features without manually writing the code, rather relying on the conversion from the camera protocol manual. The library takes care of packaging down the commands into the camera protocol.
## Contributing
Just open a PR LUL
## License
All under MIT