convertit 1.1.3

Using GET request

Example, convert from odt to pdf :

curl http://convertit/?url=http://server/document.odt&to=application/pdf
HTTP/1.1 302 Found
Content-Disposition: attachement; filename=document.pdf
...

GET parameters:

url: absolute url of the document to be converted.

“url” also supports a “{X_FORWARDED_FOR}” placeholder for requests not knowing their own host. “{X_FORWARDED_FOR}” will be replaced with the corresponding “X_FORWARDED_FOR” header if available. Be warned that “X_FORWARDED_FOR” is not a safe value since it can be modified by user agents or given false value by forward proxies. Use only if really needed. Exemple:

curl "http://convertit/?url=http://{X_FORWARDED_FOR}/document.odt&to=application/pdf"

Using POST request

Upload data in POST parameter named file:

curl -F "file=@tiger.svg" http://convertit/?to=image/png
HTTP/1.1 302 Found
Content-Disposition: attachement; filename=tiger.png

Query parameters

• to: output mimetype (optionnal, default to application/pdf if not provided);

• from: input mimetype (optionnal, guessed from input url or file if not provided).

System dependencies

• for OpenDocument support: unoconv

• for SVG support: inkscape

Conversion binaries should be in system PATH (which is used internally.)

As unoconv fails if it is called more than once at a time, if you want to serialize unoconv calls through a single celery worker, you should install rabbitmq-server too.

Download

• Download and extract a released tarball from pypi

• The bleeding edge version is hosted on github

  git clone https://github.com/makinacorpus/convertit.git
  cd convertit

Development

make serve

Once the application is running, you may visit http://localhost:6543/ in your browser.

Run tests:

make tests

Production

Using gunicorn for example :

./bin/celery -P solo -A convertit.converters.tasks worker &
gunicorn_paster --workers=4 production.ini

Make sure to run only one celery worker as unoconv cannot handle multiple conversions in parallel.

Using Docker :

sudo docker build -t="convertit" .
sudo docker run -p :6543 convertit

Feedback

Open an issue to report a bug or request a new feature.

Companies

• Planet Makina Corpus

• Contact us

Authors

• Antoine Cezar

• Alex Marandon

Contributors

• kiorky <kiorky@cryptelium.net>

• Mathieu Leplatre <mathieu.leplatre@makina-corpus.com>

• Gaël Utard <gael.utard@makina-corpus.com>

1.1.3 (2015-01-20)

• Serialize parallel libreoffice conversions

1.1.2 (2014-12-30)

• Fix a crash in unoconv error handling

• Log errors

• Add a warning about unoconv not able to work in parallel

1.1.1 (2014-12-18)

• Send HTTP errors as raw strings instead of HTML documents

1.1.0 (2014-05-21)

• Use original request header Accept-language to download the URL

• Add {X_FORWARDED_FOR} placeholder in GET url parameter. Replaced by the corresponding header if available. It avoids the client initiating the request to be aware of its own address. Exemple:

  curl "http://convertit/?url=http://{X_FORWARDED_FOR}/document.odt&to=application/pdf"

1.0 (2013-09-03)

• Initial working version