smartcrop finds good image crops for arbitrary crop sizes
Switch branches/tags
Nothing to show
Clone or download
anthonyfok and muesli Update and clarify copyright of example images (#32)
examples/goodtimes.jpg is now credited under a different (real?) name;

examples/gopher.jpg was relicensed from CC-BY-2.0 to CC-BY-NC-2.0
retrospectively circa November 2016.
Latest commit f6ebaa7 Feb 28, 2018


smartcrop finds good image crops for arbitrary sizes. It is a pure Go implementation, based on Jonas Wagner's smartcrop.js

Example Image: by Washington Dept of Fish and Wildlife, originally licensed under CC-BY-2.0 when the image was imported back in September 2014

Example Image: by Leon F. Cabeiro (N. Feans), licensed under CC-BY-2.0


Make sure you have a working Go environment (Go 1.4 or higher is required). See the install instructions.

To install smartcrop, simply run:

go get

To compile it from source:

cd $GOPATH/src/
go get -u -v
go build && go test -v


package main

import (
	_ "image/png"


func main() {
	f, _ := os.Open("image.png")
	img, _, _ := image.Decode(f)

	analyzer := smartcrop.NewAnalyzer(nfnt.NewDefaultResizer())
	topCrop, _ := analyzer.FindBestCrop(img, 250, 250)

	// The crop will have the requested aspect ratio, but you need to copy/scale it yourself
	fmt.Printf("Top crop: %+v\n", topCrop)

	type SubImager interface {
		SubImage(r image.Rectangle) image.Image
	croppedimg := img.(SubImager).SubImage(topCrop)
	// ...

Also see the test cases in smartcrop_test.go for further working examples.

Sample Data

You can find a bunch of test images for the algorithm here.


Join us on IRC:

GoDoc Build Status Coverage Status Go ReportCard