Photog!

Photog! turns a directory tree of source images into a photography website with nested albums of chronologically sorted photographs. It is created by Jaap Joris Vens who uses it for his personal photography website.

Installation

Photog! is written in Perl and packaged as a regular Perl module. The stable branch of Photog!'s repository always contains the latest release, which can be downloaded as a zip file and installed like any ol' Perl module. The following steps give some advice on how to install Photog! in various ways.

Prerequisites

• ImageMagick: It's best to install this using your operating system package manager, e.g., [apt-get|yum|brew|pacman|apt-cyg] install imagemagick.

• Cpanminus: This is the recommended way to install Perl modules. To get it, run curl -L https://cpanmin.us | perl - --sudo App::cpanminus (or just use your OS package manager again).

• local::lib: Only needed if you want to install Photog! without using root permissions. Make sure to put eval "$(perl -Mlocal::lib)" in your .bashrc after installation.

Installation - the easy way

$ cpanm https://github.com/rtts/photog/archive/stable.tar.gz

This will fetch and build all dependencies and install Photog! to your $HOME/perl5 directory. To install Photog! system-wide, prepend sudo to the above command.

Installation - the old-fashioned way

$ perl Makefile.PL
$ make
$ sudo make install

This works like you'd expect, but beware that you'll have to install all the dependencies yourself.

Installation - using Dist::Zilla

This module is maintained using Dist::Zilla, which builds the module distributions and pushes them to the 'stable' branch. Dist::Zilla can also be used for installing the module from the original source code (which lives in the master branch):

$ git clone https://github.com/rtts/photog.git
$ git checkout master
$ dzil install

Running Photog!

After installation, a manpage is available with the following command:

man photog

To generate a photography website using the default settings, simply cd to your Pictures directory and execute photog with the destination directory as its argument:

cd ~/Pictures
photog ~/public_html

That's it! Your website's main page should now be available in $HOME/public_html/index.html. Go have a look!

Customizing

The output of Photog! be customized by a number of configuration variables and by changing the website template. Please read the manpage which contains all the documentation.