caravaggio

Caravaggio

A blazing fast ⚡ image manipulation service.

Note

This is an early release of this software! This is not yet suitable for production.
The docker image is not yet production ready.
The api can change without any warning.
Feel free to contribute to make this an amazing project!

Installation

Docker

An image is provided

docker pull ramielcreations/caravaggio

Refer to the page on the docker store for its configuration

Node

npm i -g caravaggio
caravaggio

Git

git clone [e-mail]:ramiel/caravaggio.git
cd caravaggio
npm install
npm start

Using the service

The service is avaiable at http://localhost:8565/

and can be used sending a set of options and an image:
http://localhost:8565/rotate_90/https://image.com/pony.jpg

Options

operation	Description	example
resize	Resize the image. Both width and height can be specified. If only one is specified the other is auto-scaled.	resize_640x480 resize_640x resize_x480
	Values between 0 and 1 will be considered percentage of the image size	resize_0.6x0.3 resize_0.5x resize_x0.5
crop	Crop the image. Coordinates or gravity can be specified
	Gravity: north, northeast, east, southeast, south, southwest, west, northwest, center and centre.	crop_200x200xeast Crop the resized image (200wx200h) with gravity at east
	Otherwise you can specify x, y, width and height	crop_50x60x200x200 starting from x=50 y=60 drop a subimage of 200w and 200h
q	Set the quality for the resulting image (1 to 100). Default is 80. Note: this has no effect on PNGs	q_65 q_10
rotate	Rotate the image of a multiple of 90° If nothing is specified it rotates depending on the exif Orientation value	rotate rotate_90 rotate_270
flip	Flip the image horizontally or vertically	flip_x flip_y
blur	Add a blur effect to the image	blur_10 blur_0.4
progressive	Return the image as progressive.	progressive_true progressive_false

Thank you

This project is possible thanks to

• sharp - A js image processing library
• micro - A fast microservice library
• A lot of other great developers