Skip to content
Photography Website Generator
JavaScript Perl CSS HTML Other
Branch: stable
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.


Type Name Latest commit message Commit time
Failed to load latest commit information.


NOTICE: Activity in this repository has stalled. For continued development of Photog! please visit @konrul's fork or checkout the complete rewrite in Python

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. Photog also has it's own website with detailed installation instructions, online manual pages, and nice fonts.


Photog! is written in Perl and packaged as a regular Perl module. The stable branch of Photog!'s repository always contains the latest release. Here are the installation instructions:


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

Installation - the easy way

$ cpan Photography::Website

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. Instead of fetching from CPAN, t's also possible to run cpan . inside the source directory.

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
$ git checkout master
$ dzil install

Running 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!


The documentation of Photog! is available after installation as a collection of Unix-style manual pages. The available manpages are:

  • photog -- An overview of the command-line interface and an introduction to configuration and customization.

  • Photography::Website -- Describes the interface and the inner workings of the Photography::Website Perl module.

  • Photography::Website::Configure -- A comprehensive list of all configuration options and their default values.

You can’t perform that action at this time.