Convertit is a format conversion webservice.

Retrieve your document in another format !

The input file is converted and served back ! Using a dead simple GET request, documents are pulled. Using POST request, it takes the attachment.

Supported conversions:

• odt -> pdf
• odt -> doc
• ods -> xls
• csv -> ods
• csv -> xls
• svg -> pdf
• svg -> png

Previously converted documents are cleaned along the way (on each request).

USAGE

Default port is 6543, but can be changed with --port option.

Using the web interface

Go to http://localhost:6543/ui/ and upload your document. The converted document will be served back.

Using GET request

Example, convert from odt to pdf :

curl http://localhost:6543/?url=http://server/document.odt&to=application/pdf
HTTP/1.1 302 Found
Content-Disposition: attachment; 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://localhost:6543/?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://localhost:6543/?to=image/png
HTTP/1.1 302 Found
Content-Disposition: attachment; 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).

INSTALL

System dependencies

• for OpenDocument support: libreoffice-writer-nogui, libreoffice-calc-nogui
• for SVG support: libcairo2 (used by CairoSVG)

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

Download

• Debian package from latest github release
• Docker image from github package registry: ghcr.io/makinacorpus/convertit:latest or dockerhub image: makinacorpus/convertit:latest

Development

git clone https://github.com/makinacorpus/convertit.git
cd convertit
docker compose build
docker compose up

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

Run tests:

make tests

Production

Using Docker :

docker run -p :6543 convertit

Feedback

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

CREDITS

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
• Jean-Etienne Castagnede j.e.castagnede@gmail.com