Skip to content

generate thumbnail images for all kinds of files using a simple web API

License

Notifications You must be signed in to change notification settings

tokiwi/preview-service

 
 

Repository files navigation

preview-service

License: MIT Travis

Super slim webservice to generate thumbnail images for document files (pdf, odt, doc, docx), video files (mp4, flv, webm, ogv, wmv), 3D Files (ply, obj, stl) and many more using a simple HTTP API.

This is a simple wrapper around algoo/preview-generator.

See the full list of supported file formats.

Usage

Boot up the service:

docker run -p 8000:8000 fpurchess/preview-service

Use it to create a thumbnail:

curl -o thumbnail.jpeg -F 'file=file_to_preview.pdf' https://localhost:8000/preview/100x100

Optional Volumes

  • /tmp/cache/ - mount it to persist thumbnail cache
  • /tmp/files/ - stores all uploaded files

Here's a full example:

docker run -p 8000:8000 -v /tmp/cache/:/tmp/cache/ -v /tmp/files/:/tmp/files/ fpurchess/preview-service

API

GET /

Returns 200 OK when the service is up and running.

POST /preview/{width}x{height}

Awaits a the file to be converted in a multipart/form-data with form name file. Returns the converted file as a file response if the conversion is successful.

curl -o thumbnail.jpeg -F 'file=file_to_preview.pdf' https://localhost:8000/preview/100x100

Creates a 100x100 JPEG thumbnail image of file_to_preview.pdf and stores it in thumbnail.jpeg.

GET /cache/<cached-file>

Returns a cached converted file if present.

Thanks

Thanks algoo and all contributors of algoo/preview-generator.

LICENSE

see LICENSE file

About

generate thumbnail images for all kinds of files using a simple web API

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 70.4%
  • Dockerfile 25.2%
  • Shell 4.4%