Imbo¶
Imbo is an image “server” that can be used to add/get/delete images using a RESTful HTTP API. There is also support for adding meta data to the images stored in Imbo. The main idea behind Imbo is to have a place to store high quality original images and to use the API to fetch variations of the images. Imbo will resize, rotate and crop (amongst other transformations) images on the fly so you won’t have to store all the different variations.
Imbo is an open source (MIT license) project written in PHP and is available on GitHub. If you find any issues or missing features please add an issue in the Imbo issue tracker. If you want to know more feel free to join the #imbo channel on the Freenode IRC network (chat.freenode.net) as well.
Installation guide¶
- Requirements
- Installation
- Upgrading Imbo
- Configuration
- Using callables in configuration
- Imbo access control -
accessControl - Database configuration -
database - Storage configuration -
storage - Image identifier generation -
imageIdentifierGenerator - HTTP cache headers -
httpCacheHeaders - Content negotiation for images -
contentNegotiateImages - Rethrow any non-handled general exceptions -
rethrowFinalException - Trusted proxies -
trustedProxies - Authentication protocol -
authentication - Event listeners -
eventListeners - Event listener initializers -
eventListenerInitializers - Image transformation presets -
transformationPresets - Custom resources and routes -
resourcesandroutes - Redirect the index route -
indexRedirect - Input loaders -
inputLoaders - Output converters -
outputConverters
- Customize your Imbo installation with event listeners
- Command line tool
End user guide¶
- Imbo’s API
- Resources/endpoints
- Index resource -
/ - Stats resource -
/stats - Status resource -
/status - Global short URL resource -
/s/<id> - User resource -
/users/<user> - Images resource -
/users/<user>/images - Image resource -
/users/<user>/images/<image> - Short URLs resource -
/users/<user>/images/<image>/shorturls - Short URL resource -
/users/<user>/images/<image>/shorturls/<id> - Metadata resource -
/users/<user>/images/<image>/metadata - Global images resource -
/images - Public key resource -
/keys/<publicKey> - Groups resource -
/groups - Group resource -
/groups/<groupName> - Access rules resource -
/keys/<publicKey>/access - Access rule resource -
/keys/<publicKey>/access/<ruleId>
- Index resource -
- Access tokens
- Signing write requests
- Supported content types
- Cache headers
- Errors
- Resources/endpoints
- Transforming images on the fly
- Auto rotate image based on EXIF data -
t[]=autoRotate - Blur the image -
t[]=blur - Add an image border -
t[]=border - Expand the image canvas -
t[]=canvas - Compress the image -
t[]=compress - Change image contrast -
t[]=contrast - Convert the image type -
.jpg/.gif/.png - Crop the image -
t[]=crop - Make a gray scaled image -
t[]=desaturate - Draw points of interest -
t[]=drawPois - Make a mirror image -
t[]=flipHorizontally - Flip the image upside down -
t[]=flipVertically - Generate a histogram of the image -
t[]=histogram - Apply an ICC color profile -
t[]=icc - Adjust levels of the image -
t[]=level - Enforce a max size of an image -
t[]=maxSize - Modulate the image -
t[]=modulate - Make a progressive image -
t[]=progressive - Resize the image -
t[]=resize - Rotate the image -
t[]=rotate - Apply a sepia color tone -
t[]=sepia - Sharpen the image -
t[]=sharpen - Smart size the image -
t[]=smartSize - Strip image properties and comments -
t[]=strip - Create a thumbnail of the image -
t[]=thumbnail - Create a vertical mirror image -
t[]=transpose - Create a horizontal mirror image -
t[]=transverse - Add a vignette to the image -
t[]=vignette - Add a watermark to the image -
t[]=watermark
- Auto rotate image based on EXIF data -