lightroom-cc-api

A Python implementation of Adobe's Creative Cloud Lightroom API.

Disclaimer

This project is new and needs a lot of work. Use with caution.. See the issues page for some low hanging fruit if you have time to contribute :D.

Pre-Requisities

You'll need two things:

• A lightroom integration api key
• A token for your user.

See the Lightroom's getting started walks you through this, but it's not very inutitive.. issue #2 should add more documentation here.

Installation

The python package can be installed via pip/git:

pip install git+https://github.com/lou-k/lightroom-cc-api.git@VERSION

where VERSION is a relase tag.

In addition, you'll need libmagic. Install via:

• OSX: brew install libmagic
• Ubuntu: sudo apt-get install libmagic

API Usage

The Lightroom api object has the health, account, and catalog endpoints. It also provides catalog api:

from lightroom import Lightroom
lr_api = Lightroom(api_key, token)
catalog = lr_api.catalog_api()

The catalog api contains all of of the assets and albums calls.

# get the assets in the catalog
catalog.assets()
...

The catalog api also has two higher-level functions to help you add media to your Lightroom account:

# Uploads an image to lightroom
catalog.upload_image_file(path_to_image)

# Uploads an image to lightroom if it's not already in there.
catalog.upload_image_file_if_not_exists(path_to_image)