https://github.com/koraktor/gallerist

A web application to browse Apple Photos and iPhoto libraries
https://github.com/koraktor/gallerist

apple-photos iphoto ruby sinatra

Last synced: 3 months ago
JSON representation

A web application to browse Apple Photos and iPhoto libraries

• Host: GitHub
• URL: https://github.com/koraktor/gallerist
• Owner: koraktor
• License: bsd-3-clause
• Created: 2015-03-03T12:45:42.000Z (almost 10 years ago)
• Default Branch: master
• Last Pushed: 2019-10-25T18:05:20.000Z (over 5 years ago)
• Last Synced: 2024-04-17T00:19:05.504Z (9 months ago)
• Topics: apple-photos, iphoto, ruby, sinatra
• Language: JavaScript
• Homepage:
• Size: 216 KB
• Stars: 70
• Watchers: 7
• Forks: 3
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        
Gallerist

=========

[![Gem Version](https://badge.fury.io/rb/gallerist.svg)](http://badge.fury.io/rb/gallerist)

[![Build Status](https://travis-ci.org/koraktor/gallerist.svg)](https://travis-ci.org/koraktor/gallerist)

[![Code Climate](https://codeclimate.com/github/koraktor/gallerist/badges/gpa.svg)](https://codeclimate.com/github/koraktor/gallerist)

[![Coverage Status](https://coveralls.io/repos/koraktor/gallerist/badge.svg?branch=master&service=github)](https://coveralls.io/github/koraktor/gallerist?branch=master)

[![Gitter](https://img.shields.io/badge/Gitter-join%20chat-brightgreen.svg)](https://gitter.im/koraktor/gallerist)

Gallerist is a web application to browse libraries of Apple Photos and iPhoto.

It is built on top of [Sinatra][sinatra].

## Requirements

 * One or more Photos or iPhoto libraries (`.photoslibrary` or `.photolibrary`

   directories)

 * Ruby 2.2+

OS X 10.9 and above ship with Ruby 2.0. You can use [Homebrew][brew] to install

a current Ruby version on older versions of OS X.

## Installation

Gallerist can be simply installed as a Ruby gem.

```shell

$ gem install gallerist

```

*Note*: You might need to use `sudo` if you’re installing into your system

Ruby, e.g. when not using rbenv or RVM.

If you want to run the current development code please use Git to clone the

repository.

## Usage

```shell

$ bin/gallerist ~/Pictures/Photos\ Library.photoslibrary

```

After that the application is served on port 9292 by default. You can open it

by simply browsing to `http://localhost:9292`.

Further command-line arguments are available, see `gallerist --help` for more

information.

## Caveats

 * iPhoto libraries work to a certain degree as iPhoto’s events are not

   listed, only albums.

 * Gallerist works on a copy of the library databases, i.e. changes to the

   original library will not be reflected instantly. You will have to restart

   the web app first.

## Future plans

 * Support for internal categories like photo stream and videos

 * Support for moments and places

 * Performance improvements

 [brew]: http://brew.sh

 [sinatra]: http://www.sinatrarb.com