A sample and quite dumb web server to serve pictures following the iiif API.
Image API Compliance Level 2 is reached.
libvips is required by bimg.
$ make deps $ make $ bin/iiif config.toml $ DEBUG=iiif,bimg go test -v github.com/greut/iiif/iiif
IIIF image API 2.1
The API specifications can be found on iiif.io.
filepath: the path of the file
url: the URL of the file (double
//is replaced with a simple
base64(url): the URL of the file (encoded using base64)
full: the full image
square: a square area in the picture (centered)
x,y,w,h: extract the specified region (as pixels)
pct:x,y,w,h: extract the specified region (as percentages)
smart: attempt to select the center of interest (subject to change as it is not part of IIIF)
full: the full image (deprecated)
max: the full image
w,h: a potentially deformed image of
w x h
!w,h: a non-deformed image of maximum
w x h
w,: a non-deformed image with
was the width
,h: a non-deformed image with
has the height
pct:n: a non-deformed image scaled by
na clockwise rotation of
!na flip is done before the rotation
limitations bimg only supports rotations that are multiples of 90.
colorimage in full colour
grayimage in grayscale
bitonalimage in either black or white pixels (not supported)
defaultimage returned in the server default quality
limitations : bimg (libvips) doesn't support writing to
It provides all informations but the available
sizes information would be much better linked with a Cache system.
It provides meta-informations about the service. (incomplete)
Some viewers are supporting the iiif API out of the box. The following are included.
?dl to any image, it will trigger the
attachement and download the file (ref). Otherwise, the
Save as command will take a non-
Cache-Controlby default 1 year (the maximum value for HTTP/1.1).
ETagbased on the full identifier (server independent).
Last-Modifiedheaders based on the filesystem information or current time.
$ go get -u github.com/golang/protobuf/protoc-gen-go $ PATH=$PATH:`pwd`/bin protoc --go_out=. iiif/image.proto