Go API for HTTP Based Image Processing
Open Source Go Library that supports Online smart cropping, flip or rotate images, create image thumbnails, image zooming, adding watermark to PNG, WEBP, TIFF, PDF, GIF, and SVG, etc.
The imaginary is a powerful open source HTTP based image processing Go API that gives software developers the power to perform advanced image operation via private or public HTTP service with lesser dependency. It supports advanced operations like API token authorization, URL signature protection, HTTP traffic throttle strategy, and CORS support for web clients. The library can read images from HTTP POST payloads, server local path, or remote HTTP servers.
The imaginary is a powerful and stable library built on top of libvips a fast and efficient image processing. The library supports image formats such as JPEG, PNG, HEIF, WEBP, TIFF, PDF, GIF, and SVG format as well as transparent conversion across them. It has provided complete support for Docker & Fly.io. The great thing about Fly is that it can lessen latency and provide a better practice by serving traffic close to your user’s location.
The imaginary library fully supports several important features relates to image creation, conversion, and manipulation such as image resizing, enlarge images, image cropping, smart-crop, rotate images, AutoRotate with further image transformations, auto-flip based on EXIF metadata, image flop, zoom images, create images thumbnails, fit images, embed or extend an image, add watermark image, add blur effects to an image and many more.
At A Glance
An overview of imaginary features.
- Manipulate image
- Save images
- Resize images
- Cropping images
- Copy image
- Edit images
- Image cloning
- Apply watermark
- Save to browser
- Display images
- Draw text
imaginary supports popular Image file formats listed below.
imaginary can be used in multiple environments like Node or browsers etc.
Getting Started with imaginary
The easiest and recommended way to install imaginary is via GitHub.
Install imaginary via GitHub
go get -u github.com/h2non/imaginary
Convert Images to Other Formats via Go
The open-source API bimg library supports converting your images to other supported file formats with ease. You can save images in some useful formats like JPEG, PNG, and WEBP formats. The library has provided conversion support with additional quality and compression settings. You just need to provide the correct image name, address & the conversion format and the library will easily convert it for you with just a couple Go commands.
Online Image Cropping via Go
The open source imaginary library enables software developers to crop their images online with just a couple of lines of Go code inside their own applications. You can crop your image by providing custom width or height. The library makes your job easy by maintaining the Image ratio. The library also supports cropping the image by using the libvips built-in smart crop algorithm. You can also define the image compression level for PNG images and flip, flop, rotate your images with ease.
Resize Images to Fit
The Free imaginary library supports resizing images to fit using Go commands inside their apps. You can easily resize an image to fit within width and height, without cropping. The library makes your job easy by maintaining the image aspect ratio. The width and height specify a maximum bounding box for the image.
Rotate and Auto-Rotate Your Images
TThe Free imaginary library has provided functionality for rotating your images with ease. It has also included a useful function for auto-rotating images inside Go applications. It automatically rotates the image with no further image transformations based on EXIF orientation metadata. The AutoRotate method produces a new image with the same size and format as the input image.