#sqlite #apple #photos #macos #interact #model

rust-apple-photos

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

1 unstable release

0.1.0 May 30, 2019

#8 in #photos

MIT license

29KB
429 lines

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.

Dependencies

~21MB
~413K SLoC