A web application to browse Apple Photos and iPhoto libraries https://travis-ci.org/koraktor/gallerist

Sebastian Staudt d42134e913 Enable Code Climate coverage reporting 2 months ago
assets 1169304e56 Use Bootstrap’s transition mixins where applicable 2 years ago
bin 435be62ba3 Switch to Puma as HTTP server 3 months ago
lib 435be62ba3 Switch to Puma as HTTP server 3 months ago
spec d42134e913 Enable Code Climate coverage reporting 2 months ago
views 48c415785a Add a way to multi select tags 2 years ago
.codeclimate.yml d6c0590dc2 Enable Reek on Code Climate 2 years ago
.gitignore 5ac6b63f05 Add Rakefile for gem packaging 3 years ago
.rspec 853b4b2950 Add basic RSpec setup 2 years ago
.travis.yml d42134e913 Enable Code Climate coverage reporting 2 months ago
CHANGELOG.md 1dc10def0e Added a changelog entry for version 0.2.0 2 years ago
CONTRIBUTING.md ae1f0cbff2 Add CONTRIBUTING.md 3 years ago
Gemfile d42134e913 Enable Code Climate coverage reporting 2 months ago
LICENSE 0d99fafb81 Update license years 3 months ago
README.md 3b11998d4f Remove suppor for Ruby < 2.2 2 months ago
Rakefile 853b4b2950 Add basic RSpec setup 2 years ago
config.ru b6b8dc6c53 Update terminal titles if available 3 years ago
gallerist.gemspec 435be62ba3 Switch to Puma as HTTP server 3 months ago

README.md

Gallerist

Gem Version Build Status Code Climate Coverage Status Gitter

Gallerist is a web application to browse libraries of Apple Photos and iPhoto. It is built on top of 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 to install a current Ruby version on older versions of OS X.

Installation

Gallerist can be simply installed as a Ruby gem.

$ 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

$ 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