GPhoto2-rs
Rust bindings to libgphoto2
What about gphoto-rs?
I know about the other crate (gphoto and gphoto2-sys which was created by @dcuddeback, but it is missing a lot of features which make the crate unusable for me, most notably the ability to change camera settings and in memory file download.
The author hasn't been active since 2017 regardless of numerous pull- and feature requests, so I made a new project with a more up to date rust code and all the features from libgphoto2.
Features
- Camera
- Capture images
- Capture preview images
- Download images
- Get port information
- Get abilities (model, driver stability, permissions, ...)
- Read configuration
- Set configuration
- Interact with filesystem on camera
- Camera events
- Usb port information
- Context
- Autodetect camera
- Get list of available cameras
- Get camera by model and port
Gettings started
Installation
Run cargo add gphoto2 to add gphoto2 to your project or add this to your Cargo.toml:
[dependencies]
gphoto2 = "1"
Install libgphoto2
The libgphoto2 library must be installed on your system to use this library.
To install libgphoto2 on Debian based systems run:
sudo apt install libgphoto2-dev
On Arch systems run:
sudo pacman -S libgphoto2
On MacOS systems with Homebrew run:
homebrew install libgphoto2
Windows
There is no official way to install libgphoto2 on windows, but you can install it with MSYS2 (link to the package: mingw-w64-libgphoto2).
Basic Usage
This example takes a picture and saves it to disk
use gphoto2::Context;
use std::path::Path;
fn main() {
// Everything starts from a context
let context = Context::new().expect("Failed to create context");
// From the context you can detect cameras
let camera = context.autodetect_camera().expect("Failed to autodetect camera");
// And take pictures
let file_path = camera.capture_image().expect("Could not capture image");
file_path
.download(&camera, Path::new(&file_path.name().to_string()))
.expect("Failed to download image");
// For more advanced examples take a look at the examples/ foldeer
}
You can find more examples here
Stability
In general all all APIs should be stable, I've tested the ones my camera supported and found no bugs so far.
If you encounter an error like BAD_PARAMETERS or found a bug, please create an issue on GitHub.
License
Copyright © 2022 Maxicarlos08 [email protected]
This library uses the libgphoto2 library, which is licensed under the LGPL version 2.1.
2.1k Jan 3, 2023
3 Aug 4, 2023
44 Nov 14, 2023
5 Oct 11, 2022
2 Jul 30, 2022
24 Oct 6, 2022
16 Mar 26, 2023
3 Nov 21, 2023
38.9k Jan 8, 2023
4 Aug 14, 2022
5k Jan 9, 2023
5 Sep 26, 2022
204 Jan 6, 2023
1 Oct 31, 2021
3 Sep 17, 2022
4 Oct 28, 2022
38 Feb 11, 2023
12 Nov 16, 2022
43 Oct 31, 2022