A Jekyll site with the main goal to show a set of albums with ease and a pleasant theme out of the box.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Azores Image Gallery

This project is a small Frankestein that was put together from other similar projects:
Jekyll Gallery Generator
Jekyll MiniMagick new

Check this blog post if you want to know more about the creation of Azores Image Gallery 😀


If you want to see Azores Image Gallery in action check this demo: it's a small set of galleries put together in 1 minute.

Use case

The main goal is to show a given set of albums with ease leveraging the flexibility of Jekyll to provide a pleasant theme. Gallery Index Gallery Page

The following configuration options are applied by default if not specified:

  dir: photos               # Path to the gallery
  symlink: true             # false: copy images into _site. true: create symbolic links (saves disk space)
  title: "Photos"           # Title for gallery index page
  title_prefix: "Photos: "  # Title prefix for gallery pages. Gallery title = title_prefix + gallery_name
  auto_orient: false        # False by defeault. When activated it rotates the images based on the exifr.
  sort_field: "date_time"   # How to sort galleries on the index page.
                            # Possible values are: title, date_time, best_image
    x: 300                  # max width of thumbnails (in pixels)
    y: 300                  # max height of thumbnails (in pixels)

Check _config.yml for the full list of options.

Installation and Configuration

  • Clone the project and simply place all your albums in the gallery folder that by default is photos.
  • The first time only run bundle install to download all the dependencies.
  • Start Jekyll by typing jekyll serve. The firts time the build starts (either with jekyll build or jekyll serve) it will take some time to generate all the thumbnails.

DONE! When Jekyll is ready navigate to localhost:4000 to browse all your images, and mobile integration with swiping is supported too!

To further improve the experience you can modify, or remove some configuration options like

title: Your awesome title
email: your-email@example.com
description: >- # this means to ignore newlines until "baseurl:"
  Write an awesome description for your new site here. You can edit this
  line in _config.yml. It will appear in your document head meta (for
  Google search results) and in your feed.xml site description.
baseurl: "" # the subpath of your site, e.g. /blog
url: "" # the base hostname & protocol for your site, e.g. http://example.com
twitter_username: jekyllrb
github_username:  jekyll

There are also some placeholders in the following places:

  • _includes/header.html: <a class="site-title" href="{{ site.baseurl }}/"><img src="holder.js/500x150"></a>
  • _layouts/default.html: <script src="{{ '/js/holder.js' | prepend: site.baseurl }}"></script>

These can be changed with something better to improve the generated site.

To offer the site in your local network run jekyll serve --host and all the devices connected to the same network can navigate the albums by typing <local_ip>:4000. The <local_ip> is the local IP of the machine serving the Jekyll site. On OSx the IP can be easily discovered by accessing the Network Preferences.

Other useful info

  • Azores Image Gallery uses under the hood Minimagick to generate all the thumbnails. Minimagick is a clone of Rmagic but with a smaller memory footprint.

  • The symlink option, that is enabled by default, will create symbolic links instead of copying every pictures in order to save disk space.

  • auto_orient options is disabled by default. If set to true Azores Image Gallery will use an Exif Reader to determine the actual orientation of a picture.