Skip to content

A website to display Lightroom images that were tagged with hierarchical keywords. The important part is keyword navigation by analyzing the image library metadata and a keyword index. This is written in HTML5, CSS3, PHP and based on the Bootstrap framework.

License

barry-ha/Lightroom-nested-keywords

Repository files navigation

Lightroom-nested-keywords

A website to display and navigate Adobe Lightroom images that were tagged with hierarchical keywords. This is written in HTML5, CSS3, PHP and based on the Bootstrap framework.

Background

Lightroom is a wonderful organizing tool for very large groups of photos. It can easily handle many thousands of images and offers several great ways to quickly find them. An especially good method is to tag images with keywords. You can organize keywords into a tree structure (hierarchies) to represent, for example, countries -> states -> cities -> neighborhoods.

However, a limitation of Lightroom is its organizational schemes only work on the single workstation running Lightroom. Although Lightroom can publish to the web, and it can embed keywords in metadata, the end result does not have any features to navigate by keyword. This project intends to fill that need.

A well-chosen tree structure (taxonomy, or controlled vocabulary) along with consistently applying these keywords will be tremendously helpful to visitors on the world wide web.

We built this project for Shoreline Historical Museum under guidance from Visual Cognetics.

Lightroom-nested-keywords provides PHP functions to process embedded metadata, and an example website to display and navigate images by keyword.

Requirements

  • PHP >= 5.4
  • Web server

Non-requirements

  • Does not require any SQL database support features. All data is stored in XML files. It doesn't need or use MySQL or MSSQL or any other database.
  • Does not require Lightroom. This software will process metadata stored in image files; it doesn't matter how it was embedded in the file. For example, the titles and captions and keywords could have been written by Photo Mechanic or some other image-handling software.

Working Demos

Installation

  • Extract these files into a folder for your web server
  • Configure your web server for your website
  • Modify php/custom.php to match your website's domain name
  • Detailed instructions are in docs/USERS-GUIDE.md

Usage

  • In a web browser, visit your website's home page index.html
  • Explore the features using example photos included
  • Or visit the public website Shoreline Historical Museum

Try your own images

  • Put full-size images in photos/large (typically 640px on longest edge)
  • Put thumbnail images in photos/small (typically 120px on longest edge)
  • In a web browser, update the cached image info by visiting admin/build-keyword-database.html

Acknowledgments

License

barry-ha\Lightroom-nested-keywords is under Gnu GPL v3 license. Please read the LICENSE file for further details.

NOTE: The test images contained within are not my work.
DO NOT REDISTRIBUTE OR USE THESE IMAGES OUTSIDE THE DEMO. These images are used by permission of Shoreline Historical Museum for the purpose of demonstration. Please contact shm@shorelinehistoricalmuseum.org for more information.

About

A website to display Lightroom images that were tagged with hierarchical keywords. The important part is keyword navigation by analyzing the image library metadata and a keyword index. This is written in HTML5, CSS3, PHP and based on the Bootstrap framework.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published