amasser/piuma

:rainbow: Simple and fast image optimizer service you can host on your machine

Piuma

Simple and fast image optimizer service you can host on your machine

Install

$ go get github.com/piumaio/piuma

Requirements

Since this project automates two applications, you will need them to be installed on your machine for us to be able to reach them:

• pngquant
• jpegoptim

Run

$ piuma

You can also change the default port and mediapath, type

$ piuma --help

for more info.

Running with Docker

Use the following command to build the Docker image from the root folder:

docker build -t piuma .

Next, you can run the image and provide the port and the mediapath where the optimized images will be stored:

docker run -p 8080:8080 -v $PWD:/data piuma -mediapath /data

Above command will run Piuma on http://localhost:8080 and it's going to store all optimized images in the current directory ($PWD).

Usage

https://yourpiumahost/Options/Image_URL

Where options are values separated by _

width_height_quality

Where quality is a value between 0 and 100.

To get your image resized to 100 x 100:

https://yourpiumahost/100_100/Image URL

If you want to specify only the width, you'll get a new image keeping the ratio:

https://yourpiumahost/100/Image URL

If you want to specify only the height

https://yourpiumahost/0_100/Image URL

Running tests

To run the unit tests, change to the directory with tests (files ending with _test.go contain unit tests) and run:

$ go test -v ./...