Awesome

gphoto

The gphoto crate provides a safe wrapper around the native libgphoto2 library.

Dependencies

In order to use the gphoto crate, you must have a Unix system with the libgphoto2 library installed where it can be found by pkg-config.

On Debian-based Linux distributions, install the libgphoto2-dev package:

sudo apt-get install libgphoto2-dev

On OS X, install libgphoto2 with Homebrew:

brew install libgphoto2

Usage

Add gphoto as a dependency in Cargo.toml:

[dependencies]
gphoto = "0.1.2"

Import the gphoto crate. The starting point for nearly all gphoto functionality is to create a context object. You can then autodetect a camera using the Camera::autodetect() function:

extern crate gphoto;

use std::path::Path;

fn main() {
    let mut context = gphoto::Context::new().unwrap();

    let mut camera = gphoto::Camera::autodetect(&mut context).unwrap();
    let capture = camera.capture_image(&mut context).unwrap();
    let mut file = gphoto::FileMedia::create(Path::new(&*capture.basename())).unwrap();

    camera.download(&mut context, &capture, &mut file).unwrap();
}

OS X Usage

OS X opens cameras automatically when connected, which prevents other applications from opening the camera device. When attempting to open a camera that is already opened by the operating system, you will get an error message like the following:

Could not claim the USB device

To fix this, you have to kill the PTPCamera process after connecting a camera to your system:

killall PTPCamera

Each camera is opened with a separate instance of the PTPCamera application. If you have several cameras connected, you may want to kill individual PTPCamera processes instead of using killall.

License

Distributed under the MIT License.

Note: By using this crate, your executable will link to the libgphoto2 C library, which is licensed under the LGPL version 2.1.