https://github.com/lookfirst/convert
alternative appengine conversion api - pdf->image & image->image
https://github.com/lookfirst/convert
Last synced: 6 months ago
JSON representation
alternative appengine conversion api - pdf->image & image->image
- Host: GitHub
- URL: https://github.com/lookfirst/convert
- Owner: lookfirst
- License: mit
- Created: 2012-10-03T02:34:55.000Z (almost 14 years ago)
- Default Branch: master
- Last Pushed: 2015-04-30T16:21:00.000Z (about 11 years ago)
- Last Synced: 2025-01-23T08:42:32.934Z (over 1 year ago)
- Language: HTML
- Homepage:
- Size: 11 MB
- Stars: 32
- Watchers: 6
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
convert
=======
alternative for the [appengine conversion api](https://developers.google.com/appengine/docs/java/conversion/) which was decommissioned November 2012
provides a webservice to [convert](http://www.imagemagick.org/script/convert.php) pdf -> image & image -> image
integrates [Ghostscript](http://ghostscript.com/) & [ImageMagick](http://www.imagemagick.org/) with a thin NodeJS web wrapper with easy deployment on Heroku (free!)
released under a Apache 2.0 style license
usage
-----
simply ```method=POST enctype=multipart/form-data``` an uploaded file to the server, with [some arguments](https://github.com/lookfirst/convert/blob/master/public/upload.html), and it'll return the result
view [AppEngine Java](https://github.com/lookfirst/convert/wiki/AppEngineJava) for an example Java client that saves output to the [blobstore](https://developers.google.com/appengine/docs/java/blobstore/overview)
deploy
------
1. install the [heroku toolbelt and setup your account](https://devcenter.heroku.com/articles/quickstart)
1. read [these directions](https://devcenter.heroku.com/articles/nodejs) for setting up a NodeJS app
1. ```git clone``` this repo
1. ```heroku create``` to create an appserver
1. ```git push heroku master``` to push this code up to heroku
1. ```heroku config:add NODE_ENV=production```
1. ```heroku ps:scale web=1``` to start the server
1. ```http://yourapp.herokuapp.com/upload.html``` u: nixon p: @#$jfiehd1
develop
-------
1. see above for setting up the toolbelt and cloning this repo
1. ```sudo npm install -g nodemon``` to install nodemon globally
1. ```npm install``` to install the rest of the node dependencies locally
1. ```brew install ghostscript``` && ```brew install imagemagick``` - you will need to install [brew](http://mxcl.github.com/homebrew/) first
1. ```foreman start``` to start the server
1. ```http://localhost:5000/``` u: nixon p: @#$jfiehd1
> [documentation](https://github.com/lookfirst/convert/wiki/Compile) on how Ghostscript/ImageMagick can be compiled on Heroku