The simplest way to make a static image library, with only a little Python, minimal HTML, and nothing else
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
docs
sample_images
LICENSE.txt
README.md
__init__.py
generate_gallery.py
setup.py

README.md

simple_img_gallery

The simplest way to make a static image library, with only a little Python, minimal HTML, and nothing else

Quickstart

./generate_gallery.py ./sample_images

Alternatively, instead of sample_images, pass a full path to a directory of images of your choice:

./generate_gallery.py /path/to/image_directory

The script will create an index.html in that directory, and view it with Firefox.

Dependencies

There are no dependencies other than Python. (Currently only Python 2 supported.)

Installation

If you'd like to be able to use from any directory on your machine, you can:

cd simple_img_gallery
python ./setup.py install --prefix=${INSTALL_PATH}

where INSTALL_PATH must be on your PYTHONPATH.

The installation step (to a directory that lies on your PYTHONPATH) allows you to call generate_gallery.py from any directory.

Features

  • Tile N images per row: pass an argument after the directory path. (The default is 3.) For example, to tile 6 per row:
	generate_gallery.py /path/to/image_directory 6

  • Click on any image to zoom (thank you browser)

  • Right click on any image and "Save Image As" (if you want it for your plots)

Note:

  • Currently only supports tiling the images in alphabetical order.

Future features:

  • Support Python3

  • Multi-browswer support (currently we only natively support Firefox)

  • Support randomization, down-sampling