GI Sync

What is this?

This is an attempt to import the photos I take with my Android phone, which uploads the photos to Google Photos, into iCloud Photos. Currently it is pretending to be an OSX application, but in the end I want this to run on both OSX and iOS.

I also might give 'the other way around' a try.

The whole project is written in Swift and I am not affraid to use dependencies, which I do a lot to keep this project moving forward.

Known issues

Google Photos strips the location data from the images, before you download them through the API. Want location metadata to be supported? Make it clear to Google by commenting on this issue!
Need to keep a 'mapping' between Google Photos and iCloud Photos, so images won't be duplicated when reimporting the photos. I read cases where identifiers for iCloud photos are 'reset' between iOS updates.

Todo

Just the basic classes and requests for Google Photo are currently implemented. There is so much to do, that it is too much to write down, but for example:

Import photos from GP to IP and keep a clean administration.
Option to remove copied photos from GP.
Import by album.
Interfaces for everything.

Classes

Classes for Google Photos are kept in the GooglePhotosAPI folder in this repository. The following classes contain functionality to communicate with the Google Photos API. Other classes are there to make sure we get the full metadata from the API.

Album

Album contains the following methods:

list: Gets a list of albums. (static)
listAll: Gets the full list of albums, if more than 20 it performs multiple requests. (static)
get: Gets the metadata of a single album. (static)
getMediaItems: Gets the MediaItem objects for an album.

MediaItem

MediaItem contains the following methods:

list: Gets a list of MediaItem objects. (static)
listAll: Gets the full list of MediaItem objects. (static)
get: Gets the metdata of a single MediaItem object. (static)
search: Perform a search over the MediaItem objects in the photo library. (static)
download: Download the image belonging to the MediaItem object.

google_api.json

To use this project, you must create a file called google_api.json in the GI Sync folder. This is a simple JSON file, containing the following information:

{
    "client_id": "<Google client id>",
    "client_secret": "<Google client secret>"
}

This file is read on run-time and the items are used to configure the Google signin process.

Examples

Search in `MediaItems` for selfies and animals.

let filter = Filters.create(category: .selfies)
filter.addContentCategory(category: .animals)

MediaItem.search(filters: filter, completed: { (response) in
    log.verbose("Found \(response.mediaItems?.count)")
}) { (error) in
    log.error(error)
}

Getting all `Albums` and get the `MediaItems` for the first album (if present).

Album.listAll(completed: { (albums) in
    if albums.count > 0 {
        if let album = albums.first {
            album.getAllMediaItems(completed: {
                log.verbose("Contains \(album.mediaItems.count) items")
            }, failed: { (error) in
                log.error(error)
            })
        }
    }
}) { (error) in
    log.error(error)
}

Dependencies

Currently I use the following dependencies:

Alamofire
AlamofireObjectMapper
ObjectMapper
SwiftyBeaver
RealmSwift
PureLayout
SwiftLint

This list might not be up-to-date, but you can check out the Podfile for a more recent list.

wimhaanstra/GI-Sync