Lib.rs

A simple yet powerful library to interact with the SQLite database used by the Apple Photos app on macOS.

Installation

Add the following to your Cargo.toml:

...
[Dependencies]
...
rust-apple-photos = "0.1.0"
...

Basic Usage

extern crate rust-apple-photos;
extern crate rusqlite;

use rust-apple-photos::ApplePhotos;
use rust-apple-photos::types::{ Album };

fn main() -> Result<()>
{
    /* Specify other .db path using "new_with_path" method! */
    let photos: ApplePhotos = ApplePhotos::new()?;
    let albums: Vec<Album> = photos.get_albums()?;
    
    println!("You have {} albums!", albums.len());
}

Custom Queries

...

fn get_large_images() -> Result<()>
{
    ...
    let big_boys: Vec<Master> = photos.query("SELECT * FROM RKMaster WHERE width >= 2000 AND height >= 2000")?;
    println!("You have {} images that are big!", big_boys.len());
}

...

Roadmap

There are a lot of models to implement to complete just the base layer of models. There are additional sub-models that will need to be implemented if the goal is to fully replace Apple's own implementation.

Models

• RKAdminData
• RKAlbum
• RKAlbumVersion
• RKAttachment
• RKBookmark
• RKCloudResource
• RKCustomSortOrder
• RKFace
• RKFaceCrop
• RKFaceGroup
• RKFacePrint
• RKFolder
• RKImageMask
• RKImageProxyState
• RKImportGroup
• RKImportMoment
• RKKeyword
• RKMaster
• RKMemory
• RKMemoryCuratedVersion
• RKMemoryExtendedCuratedVersion
• RKMemoryMovieVersion
• RKMemoryRepresentativeVersion
• RKModelResource
• RKMoment
• RKMomentCollection
• RKMomentYear
• RKPerson
• RKPersonInvalidMergeCandidatePerson
• RKPersonMergeCandidatePerson
• RKPersonRejectedFace
• RKPersonRejectedFaceNeedingFaceCrop
• RKPlace
• RKPlaceForVersion
• RKSceneInVersion
• RKVersion
• RKVersionAnalysisState
• RKVolume

Contributions

If you want to improve anything, go ahead and open up a pull request.

License

rust-apple-photos is available under the MIT license. See the LICENSE file for more info.