https://github.com/pixers/imaginator

A web interface to imagemagick.
https://github.com/pixers/imaginator

Last synced: 7 days ago
JSON representation

A web interface to imagemagick.

• Host: GitHub
• URL: https://github.com/pixers/imaginator
• Owner: pixers
• Created: 2018-06-04T13:02:54.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2019-01-03T12:50:31.000Z (almost 6 years ago)
• Last Synced: 2024-08-01T15:35:44.658Z (3 months ago)
• Language: Rust
• Size: 530 KB
• Stars: 2
• Watchers: 4
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
Imaginator

==========

Imaginator is a fast, safe web interface to imagemagick. While imaginator is relatively stable and is deployed in production at pixers, this document is a work in progress.

Dependencies

------------

  * Nightly rust (because we have to use the system allocator)

  * ImageMagick 7 (and whatever else [magick-rust](https://crates.io/crates/magick_rust) requires)

Installation

------------

First, install ImageMagick - magick_rust (and imaginator) needs it to automatically generate correct bindings.

Then, build the binary using `cargo build --release`. Your binary will be in `target/release/imaginator`.

Note that it still depends on ImageMagick – you'll have to install the same version on the machine you want to run it at.

Usage

-----

Once started, imaginator listens on port 3000. It takes a list of filters in a url, and returns an image. For example, resizing an image can be done with the following query:

    curl http://127.0.0.1:3000/download(http:example.com/image.jpg):resize(0.5w, 0.5h)

This will resize the image to 50% of its width, and 50% of its height.