#wrapper #exif #libexif #metadata #safe-wrapper #api-bindings #safe-bindings

sys libexif-wrapper

A safe rust wrapper around libexif

3 releases

0.1.2 Mar 10, 2024
0.1.1 Feb 1, 2024
0.1.0 Feb 1, 2024

#324 in Images

Download history 7/week @ 2024-01-29 9/week @ 2024-02-19 29/week @ 2024-02-26 134/week @ 2024-03-04 70/week @ 2024-03-11 4/week @ 2024-03-18 54/week @ 2024-04-01

262 downloads per month

Apache-2.0

3MB
1.5K SLoC

A safe Rust wrapper aroung libexif.

Libexif is a C library for extracting EXIF data from picture files. This crate contains a safe
wrapper around libexif. This crate also exposes unsafe rust bindings for libexif through the bindings module.

The libexif static library will be linked statically during build time. Libexif needs to be
installed to build the bindings. The bindings are generated using bindgen. By default, the
libexif static library is searched using pkg-config. To manually give a file path to the
libexif.a file, set the LIBEXIF_STATIC_LIBRARY_PATH environment variable during build time.

Run

cargo add libexif-wrapper 

to add this crate as a dependency.

Example

use libexif_wrapper::{Exif, ExifIfd, ExifTag};  
  
fn main() {  
    let exif = Exif::from_jpeg_file("test_resources/DSC_5613.jpg").unwrap();  
    let datetime = exif.get_entry_value(ExifIfd::IfdExif, ExifTag::DateTimeOriginal).unwrap();  
    println!("The picture was taken on: {}", datetime);  
}  

Extracting maker notes

In addition to standardized EXIF tags, most camera manufacturers use the maker note exif tag to store useful information about the
photo. Maker notes are specific to the camera manufacturer. Note that libexif may not be able
to decode all maker note tags.

use libexif_wrapper::{Exif, ExifIfd, ExifTag};  
  
fn main() {  
    let exif = Exif::from_jpeg_file("test_resources/DSC_5613.jpg").unwrap();  
    let make = exif.get_entry_value(ExifIfd::Ifd0, ExifTag::Make).unwrap();  
    println!("The picture was taken with a camera by {}", make);  
    // Get maker notes specific to Nikon cameras  
    if make == "NIKON CORPORATION" {  
        // 0x0084 is the maker note tag ID for lens type in Nikon's photos.  
        // A list of maker notes for specific camera manudacturers can be found at https://exiftool.org/TagNames/index.html  
        let lens = exif.get_maker_note(0x0084).unwrap();  
        println!("The lens used was: {}", lens.value);  
    }  
}  

Installing libexif

curl -L https://github.com/libexif/libexif/releases/download/v0.6.24/libexif-0.6.24.tar.bz2 | tar -jsx  
cd libexif-0.6.24  
./configure && make  
sudo make install  

Libexif is only required during build time, as it is linked statically.

Libexif is licensed under the LGPL-2.1 license
This crate is licensed under the Apache-2.0 license.

Dependencies