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

Sebastian Staudt 7d6ca0171b Also skip persons with an empty name 2 months ago
assets 298c96e293 Added minimal slideshow 2 months ago
bin 435be62ba3 Switch to Puma as HTTP server 10 months ago
lib 7d6ca0171b Also skip persons with an empty name 2 months ago
spec e646f2b768 Add support for Photos 3.0+ 2 months ago
views f8fde726fb Update to ActiveRecord 5.2.x 2 months ago
.codeclimate.yml d6c0590dc2 Enable Reek on Code Climate 3 years ago
.gitignore 5ac6b63f05 Add Rakefile for gem packaging 4 years ago
.rspec 853b4b2950 Add basic RSpec setup 3 years ago
.travis.yml 6ab2b635b8 Update Ruby build matrix 2 months ago
CHANGELOG.md 1dc10def0e Added a changelog entry for version 0.2.0 3 years ago
CONTRIBUTING.md ae1f0cbff2 Add CONTRIBUTING.md 4 years ago
Gemfile d42134e913 Enable Code Climate coverage reporting 9 months ago
LICENSE 0d99fafb81 Update license years 10 months ago
README.md 3b11998d4f Remove suppor for Ruby < 2.2 9 months ago
Rakefile 853b4b2950 Add basic RSpec setup 3 years ago
config.ru b6b8dc6c53 Update terminal titles if available 3 years ago
gallerist.gemspec 0242cd0cd2 Update sqlite3 to 1.4.x 2 months ago



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.


  • 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.


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.


$ 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.


  • 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