Small maker of thumbnails and spitter-out of HTML for galleries.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

2.1 KiB


Python to make thumbnails and generate HTML and/or JSON pointing to them.

Implemented as a badly-designed class with a command-line wrapper. Probably wrong in many particulars. I don't know Python.

As of September 2016, this is just kind of an experiment. I'll probably change the interface (and might also abandon the whole thing in favor of some existing tool). If I get it to a place where I think I won't break the interface and there are some unit tests in place, that will probably be a v1.0.0.


I just want to make some simple photo galleries for my website, using something I can easily plumb into Makefiles or Vim macros.


gallery-html --base_url= --base_dir=. -x=256 -y=256


# I needed this on my Debian Jessie system:
# sudo apt-get install python3-pil
git clone
cd galleryhtml
sudo python3 install

Installing for development:

sudo pip3 install -e
$ gallery-html --help
gallery-html - generate thumbnails and print html for images

  gallery-html [--source <pattern>...] [--output <dir>] [--base_url <url>] [-x <n>] [-y <n>] [--json <filename>] [--html <filename>] [--overwrite]
  gallery-html (-h | --help)
  gallery-html (-v | --version)

  --source <pattern>  Source directory or image file(s) to make gallery from
  --output <dir>      Parent directory on local filesystem for thumbnails
  --base_url <url>    Base URL for images
  -x <n>              Maximum width of thumbnails in pixels
  -y <n>              Maximum height of thumbnails in pixels
  --json <filename>   Render JSON output to filename
  --html <filename>   Render HTML output to filename
  --overwrite         Replace existing thumbnail files
  -h --help           Show this screen
  -v --version        Display version