Skip to content
Static image gallery generator
Go JavaScript CSS HTML
Branch: master
Clone or download
Latest commit 59caf98 Jan 20, 2020
Type Name Latest commit message Commit time
Failed to load latest commit information.
assets UI fixes Jan 20, 2020
sample Documentation Jan 19, 2020
test Fixed missing files and updated command line parsing Jan 19, 2020
.gitignore Fixed issue #9, strip navigation button not fully visible Jan 20, 2020 doc Jan 20, 2020
files.go Added mac support Jan 6, 2020
pictures.go Added support for face detection Jan 19, 2020



Chobi is a static photo gallery generator. chobi is lansliteration of "ছবি" which means picture in Bengali/Bangla.

Given a source folder of photos, chobi will generate a destination folder containing the original photos, generated thumbnails, css stylesheets, scripts and html files which constitute a website displaying those photos as follows


There are a lot of such generator out there, so why build one more you ask. There is two specific reasons

  1. I could
  2. I needed a feature which I couldn't find in other tools. More on this below


While this tool works as good or as bad as many other photo gallery generator, it does something special for photos with faces (portraits). I needed the gallery generator to create square thumbnails for the image strip shown at the bottom of the page. However, the generated thumbnails would simply be either from the center or some other arbitrary location. This meant that the thumbnails would cut off at weird places.

Chobi uses face-detection to ensure that does not happen and the face is always fully present in the generated thumbnail.

Consider the following images and the thumbnails generated without face detection and then with facedetection

Image Thumbnail Thumbnail with face-detection
Portrait Thumnail Thumnail
Portrait Thumnail Thumnail

What these face-detected thumbnails mean is that instead of the photo gallery as in the left below, where in the thumbnails a lot of heads have been chopped off (literally), you have a much nicer gallery (below right).

Gallery without face detection Gallery with face detection
Portrait Portrait

How Does it work

I use my other project to generate face detected thumbnails. Please check that project out as well!


Get the sources and then run the following command the first time

go get

Subsequently build using

go build .


The tool needs the facefinder binary that ships with in the local folder. go get run above already fetches that repo into your GOPATH. So use the following command to copy facefinder over

copy %GOPATH%\src\\abhinababasu\facethumbnail\test\facefinder .

Now you can run chobi. Check usage using

chobi -h

Example below runs the generator with facedetection and verbose mode

chobi -name People -src .\test -dst c:\temp -face

You can skip the -face flag when running this tool for non-portrait albums like Landscapes


A sample gallery Photography. This was generated by exporting photos from lightroom and then running chobi repeated from those folders into the same target folder.

You can’t perform that action at this time.