Simple adaptive image server based on smartcrop.js
Image: https://www.flickr.com/photos/endogamia/5682480447/ by N. Feans
Adaptive exposes a single function that creates an Express app:
var adaptive = ;var opts =secret: 'mysecret'cache: '/tmp/adaptive';;
The generated images will be stored in the filesystem. If you don't specify a
cache directory, adaptive will store the files in the system's temp
You can request images using the following URL pattern:
The following URL will generate a 200x200 crop from the example image shown above: http://localhost:3000/unsafe/200x200/https://farm6.staticflickr.com/5189/…
You can parametrize the JPEG compression by adding
:<quality> where quality
is a value from 0 to 100, optionally followed by a
p to create a progressive
http://localhost:3000/unsafe/200x200:p/<src-url>progressive, default quality
http://localhost:3000/unsafe/200x200:75p/<src-url>75% quality, progressive
In order to prevent DoS attacks adaptive allows you to specify shared secret that is used to generate a hash-based message authentication code.
The web server that serves a page which contains adaptive images generates an auth key for the options and src-url.
When end-users access the page and thus load the image, adaptive generates a key using the same algorithm. If both auth keys match, the request is processed.
Adaptive uses standard HMAC with SHA1 signing.
In order to convert
into a safe URL we must sign the part
unsafeat the beginning of the URL with the generated key
Adaptive also comes with a binary that can be used to start a HTTP server:
adaptive -p <port> -s <secret> -c <cache-dir>
Alternatively the options can be set using environment variables:
PORT=3000 SECRET=mysecret npm start
The easiest way to deploy adaptive to Heroku or a dokku instance is to create
an empty project with nothing but a
Dokku's Ubuntu image provides all required dependencies except for
The easiest way to add it is to do this:
echo > .buildpacksecho >> .buildpacksecho apt-get install -y libgif-dev > .installgit add .buildpacks .installgit commit -m "add node-canvas prerequisites"
You can turn on debug output by setting
DEBUG env var to
Copyright (c) 2014 Felix Gnass
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.