Thumbnail/Preview generator for 450 different filetypes in python.

This package has been thoroughly tested on Linux machines. If you're facing any issue post it on Github Issues.

thumbnail depends on unoconv.(Universal Office converter)

apt-get install unoconv

thumbnail depends of ffmpeg for audio or video files

apt-get install ffmpeg

thumbnail depends on Imagemagick for image manipulation

apt-get install imagemagick

thumbnail also needs curl to be installled

apt-get install curl

To install this package:

pip install thumbnail

Sample code:

from thumbnail import generate_thumbnail

// generate_thumbnail(input, output, options)

options = {
	'trim': False,
	'height': 300,
	'width': 300,
	'quality': 85,
	'type': 'thumbnail'
}
generate_thumbnil('sample.docx', './thumbnails/thumbnail.png', options)

You need to pass three parameters in generate_thumbnail function.

input: location of the input file. You can see the list of supported files at the end.

output: location of the to be generated thumbnail file. It can be .png, .jpg or .gif

options: It can have five diff parameters. If you don't want to pass any options, pass options as a blank {}

• trim: Boolean(default = True) It'll automatically trim your file.
• height: Integer(default = 300) Height of the thumbnail in px.
• width: Integer(default = 300) Width of the thumbnail in px.
• quality: Integer(default = 85) Quality of the thumbnail on a scale of 1-100.
• type: String(default = "thumbnail" It takes two values "thumbnail" or "firstpage" "thumbnail" = 300X300 image of the first page of the document. Height and Width can be changed by providing values in options "firstpage" = snapshot of the document's first page.

ImageMagick no images defined:

• Open /etc/ImageMagick-6/policy.xml in the editor of your choice

<!-- Find this line(should be in the end of file) -->
<policy domain="coder" rights="none" pattern="PDF" />

• You can either comment it or change rights to "read | write"
• Reference: https://askubuntu.com/questions/1181762/imagemagickconvert-im6-q16-no-images-defined

unoconv: Cannot find a suitable pyuno library and python binary combination in /usr/lib/libreoffice:

• Open /usr/bin/unoconv in the editor of your choice
• Replace #!/usr/bin/env python3 with #!/usr/bin/python3
• Reference: unoconv/unoconv#405

This package is inspired from npm module filepreview.

The following list of document formats are currently available for exporting to:

• bib - BibTeX [.bib]
• doc - Microsoft Word 97/2000/XP [.doc]
• doc6 - Microsoft Word 6.0 [.doc]
• doc95 - Microsoft Word 95 [.doc]
• docbook - DocBook [.xml]
• html - HTML Document (OpenOffice.org Writer) [.html]
• odt - Open Document Text [.odt]
• ott - Open Document Text [.ott]
• ooxml - Microsoft Office Open XML [.xml]
• pdb - AportisDoc (Palm) [.pdb]
• pdf - Portable Document Format [.pdf]
• psw - Pocket Word [.psw]
• rtf - Rich Text Format [.rtf]
• latex - LaTeX 2e [.ltx]
• sdw - StarWriter 5.0 [.sdw]
• sdw4 - StarWriter 4.0 [.sdw]
• sdw3 - StarWriter 3.0 [.sdw]
• stw - Open Office.org 1.0 Text Document Template [.stw]
• sxw - Open Office.org 1.0 Text Document [.sxw]
• text - Text Encoded [.txt]
• txt - Plain Text [.txt]
• vor - StarWriter 5.0 Template [.vor]
• vor4 - StarWriter 4.0 Template [.vor]
• vor3 - StarWriter 3.0 Template [.vor]
• xhtml - XHTML Document [.html]

The following list of graphics formats are currently available for exporting to:

• bmp - Windows Bitmap [.bmp]
• emf - Enhanced Metafile [.emf]
• eps - Encapsulated PostScript [.eps]
• gif - Graphics Interchange Format [.gif]
• html - HTML Document (OpenOffice.org Draw) [.html]
• jpg - Joint Photographic Experts Group [.jpg]
• met - OS/2 Metafile [.met]
• odd - OpenDocument Drawing [.odd]
• otg - OpenDocument Drawing Template [.otg]
• pbm - Portable Bitmap [.pbm]
• pct - Mac Pict [.pct]
• pdf - Portable Document Format [.pdf]
• pgm - Portable Graymap [.pgm]
• png - Portable Network Graphic [.png]
• ppm - Portable Pixelmap [.ppm]
• ras - Sun Raster Image [.ras]
• std - OpenOffice.org 1.0 Drawing Template [.std]
• svg - Scalable Vector Graphics [.svg]
• svm - StarView Metafile [.svm]
• swf - Macromedia Flash (SWF) [.swf]
• sxd - OpenOffice.org 1.0 Drawing [.sxd]
• sxd3 - StarDraw 3.0 [.sxd]
• sxd5 - StarDraw 5.0 [.sxd]
• tiff - Tagged Image File Format [.tiff]
• vor - StarDraw 5.0 Template [.vor]
• vor3 - StarDraw 3.0 Template [.vor]
• wmf - Windows Metafile [.wmf]
• xhtml - XHTML [.xhtml]
• xpm - X PixMap [.xpm]

The following list of presentation formats are currently available for exporting to:

• bmp - Windows Bitmap [.bmp]
• emf - Enhanced Metafile [.emf]
• eps - Encapsulated PostScript [.eps]
• gif - Graphics Interchange Format [.gif]
• html - HTML Document (OpenOffice.org Impress) [.html]
• jpg - Joint Photographic Experts Group [.jpg]
• met - OS/2 Metafile [.met]
• odd - OpenDocument Drawing (Impress) [.odd]
• odg - OpenOffice.org 1.0 Drawing (OpenOffice.org Impress) [.odg]
• odp - OpenDocument Presentation [.odp]
• pbm - Portable Bitmap [.pbm]
• pct - Mac Pict [.pct]
• pdf - Portable Document Format [.pdf]
• pgm - Portable Graymap [.pgm]
• png - Portable Network Graphic [.png]
• pot - Microsoft PowerPoint 97/2000/XP Template [.pot]
• ppm - Portable Pixelmap [.ppm]
• ppt - Microsoft PowerPoint 97/2000/XP [.ppt]
• pwp - PlaceWare [.pwp]
• ras - Sun Raster Image [.ras]
• sda - StarDraw 5.0 (OpenOffice.org Impress) [.sda]
• sdd - StarImpress 5.0 [.sdd]
• sdd3 - StarDraw 3.0 (OpenOffice.org Impress) [.sdd]
• sdd4 - StarImpress 4.0 [.sdd]
• sti - OpenOffice.org 1.0 Presentation Template [.sti]
• stp - OpenDocument Presentation Template [.stp]
• svg - Scalable Vector Graphics [.svg]
• svm - StarView Metafile [.svm]
• swf - Macromedia Flash (SWF) [.swf]
• sxi - OpenOffice.org 1.0 Presentation [.sxi]
• tiff - Tagged Image File Format [.tiff]
• vor - StarImpress 5.0 Template [.vor]
• vor3 - StarDraw 3.0 Template (OpenOffice.org Impress) [.vor]
• vor4 - StarImpress 4.0 Template [.vor]
• vor5 - StarDraw 5.0 Template (OpenOffice.org Impress) [.vor]
• wmf - Windows Metafile [.wmf]
• xhtml - XHTML [.xml]
• xpm - X PixMap [.xpm]

The following list of spreadsheet formats are currently available for exporting to:

• csv - Text CSV [.csv]
• dbf - dBase [.dbf]
• dif - Data Interchange Format [.dif]
• html - HTML Document (OpenOffice.org Calc) [.html]
• ods - Open Document Spreadsheet [.ods]
• ooxml - Microsoft Excel 2003 XML [.xml]
• pdf - Portable Document Format [.pdf]
• pts - OpenDocument Spreadsheet Template [.pts]
• pxl - Pocket Excel [.pxl]
• sdc - StarCalc 5.0 [.sdc]
• sdc4 - StarCalc 4.0 [.sdc]
• sdc3 - StarCalc 3.0 [.sdc]
• slk - SYLK [.slk]
• stc - OpenOffice.org 1.0 Spreadsheet Template [.stc]
• sxc - OpenOffice.org 1.0 Spreadsheet [.sxc]
• vor3 - StarCalc 3.0 Template [.vor]
• vor4 - StarCalc 4.0 Template [.vor]
• vor - StarCalc 5.0 Template [.vor]
• xhtml - XHTML [.xhtml]
• xls - Microsoft Excel 97/2000/XP [.xls]
• xls5 - Microsoft Excel 5.0 [.xls]
• xls95 - Microsoft Excel 95 [.xls]
• xlt - Microsoft Excel 97/2000/XP Template [.xlt]
• xlt5 - Microsoft Excel 5.0 Template [.xlt]
• xlt95 - Microsoft Excel 95 Template [.xlt]

The following list of open office formats are currently available for exporting to:

• Microsoft Word 6.0/95/97/2000/XP (.doc and .dot)
• Microsoft Word 2003 XML (.xml)
• Microsoft Word 2007 XML (.docx, .docm, .dotx, .dotm)
• Microsoft WinWord 5 (.doc)
• WordPerfect Document (.wpd)
• WPS 2000/Office 1.0 (.wps)
• .rtf, .txt, and .csv
• StarWriter formats (.sdw, .sgl, .vor)
• DocBook (.xml)
• Unified Office Format text (.uot, .uof)
• Ichitaro 8/9/10/11 (.jtd and .jtt)
• Hangul WP 97 (.hwp)
• T602 Document (.602, .txt)
• AportisDoc (Palm) (.pdb)
• Pocket Word (.psw)
• Microsoft Excel 97/2000/XP (.xls, .xlw, and .xlt)
• Microsoft Excel 4.x–5.0/95 (.xls, .xlw, and .xlt)
• Microsoft Excel 2003 XML (.xml)
• Microsoft Excel 2007 XML (.xlsx, .xlsm, .xltx, .xltm)
• Microsoft Excel 2007 binary (.xlsb)
• Lotus 1-2-3 (.wk1, .wks, and .123)
• Data Interchange Format (.dif)
• Rich Text Format (.rtf)
• Text CSV (.csv and .txt)
• StarCalc formats (.sdc and .vor)
• dBASE (.dbf)
• SYLK (.slk)
• Unified Office Format spreadsheet (.uos, .uof)
• .htm and .html files, including Web page queries
• Pocket Excel (pxl)
• Quattro Pro 6.0 (.wb2)
• Microsoft PowerPoint 97/2000/XP (.ppt, .pps, and .pot)
• Microsoft PowerPoint 2007 (.pptx, .pptm, .potx, .potm)
• StarDraw and StarImpress (.sda, .sdd, .sdp, and .vor)
• Unified Office Format presentation (.uop, .uof)
• CGM – Computer Graphics Metafile (.cgm)
• Portable Document Format (.pdf)

The following list of video formats are currently available for exporting to:

• 3g2 3GP2 (3GPP2 file format)
• 3gp 3GP (3GPP file format)
• 4xm 4X Technologies
• a64 a64 - video for Commodore 64
• aac raw ADTS AAC (Advanced Audio Coding)
• ac3 raw AC-3
• act ACT Voice file format
• adf Artworx Data Format
• adp ADP
• adts ADTS AAC (Advanced Audio Coding)
• adx CRI ADX
• aea MD STUDIO audio
• afc AFC
• aiff Audio IFF
• alaw PCM A-law
• alias_pix Alias/Wavefront PIX image
• alsa ALSA audio output
• amr 3GPP AMR
• anm Deluxe Paint Animation
• apc CRYO APC
• ape Monkey's Audio
• apng Animated Portable Network Graphics
• aqtitle AQTitle subtitles
• asf ASF (Advanced / Active Streaming Format)
• asf_stream ASF (Advanced / Active Streaming Format)
• ass SSA (SubStation Alpha) subtitle
• ast AST (Audio Stream)
• au Sun AU
• avi AVI (Audio Video Interleaved)
• avisynth AviSynth script
• avm2 SWF (ShockWave Flash) (AVM2)
• avr AVR (Audio Visual Research)
• avs AVS
• bethsoftvid Bethesda Softworks VID
• bfi Brute Force & Ignorance
• bin Binary text
• bink Bink
• bit G.729 BIT file format
• bmp_pipe piped bmp sequence
• bmv Discworld II BMV
• boa Black Ops Audio
• brender_pix BRender PIX image
• brstm BRSTM (Binary Revolution Stream)
• c93 Interplay C93
• caca caca (color ASCII art) output device
• caf Apple CAF (Core Audio Format)
• cavsvideo raw Chinese AVS (Audio Video Standard) video
• cdg CD Graphics
• cdxl Commodore CDXL video
• cine Phantom Cine
• concat Virtual concatenation script
• crc CRC testing
• dash DASH Muxer
• data raw data
• daud D-Cinema audio
• dfa Chronomaster DFA
• dirac raw Dirac
• dnxhd raw DNxHD (SMPTE VC-3)
• dpx_pipe piped dpx sequence
• dsf DSD Stream File (DSF)
• dsicin Delphine Software International CIN
• dss Digital Speech Standard (DSS)
• dts raw DTS
• dtshd raw DTS-HD
• dv DV (Digital Video)
• dv1394 DV1394 A/V grab
• dvbsub raw dvbsub
• dvd MPEG-2 PS (DVD VOB)
• dxa DXA
• ea Electronic Arts Multimedia
• ea_cdata Electronic Arts cdata
• eac3 raw E-AC-3
• epaf Ensoniq Paris Audio File
• exr_pipe piped exr sequence
• f32be PCM 32-bit floating-point big-endian
• f32le PCM 32-bit floating-point little-endian
• f4v F4V Adobe Flash Video
• f64be PCM 64-bit floating-point big-endian
• f64le PCM 64-bit floating-point little-endian
• fbdev Linux framebuffer
• ffm FFM (FFserver live feed)
• ffmetadata FFmpeg metadata in text
• film_cpk Sega FILM / CPK
• filmstrip Adobe Filmstrip
• flac raw FLAC
• flic FLI/FLC/FLX animation
• flv FLV (Flash Video)
• framecrc framecrc testing
• framemd5 Per-frame MD5 testing
• frm Megalux Frame
• g722 raw G.722
• g723_1 raw G.723.1
• g729 G.729 raw format demuxer
• gif GIF Animation
• gsm raw GSM
• gxf GXF (General eXchange Format)
• h261 raw H.261
• h263 raw H.263
• h264 raw H.264 video
• hds HDS Muxer
• hevc raw HEVC video
• hls Apple HTTP Live Streaming
• hls,applehttp Apple HTTP Live Streaming
• hnm Cryo HNM v4
• ico Microsoft Windows ICO
• idcin id Cinematic
• idf iCE Draw File
• iec61883 libiec61883 (new DV1394) A/V input device
• iff IFF (Interchange File Format)
• ilbc iLBC storage
• image2 image2 sequence
• image2pipe piped image2 sequence
• ingenient raw Ingenient MJPEG
• ipmovie Interplay MVE
• ipod iPod H.264 MP4 (MPEG-4 Part 14)
• ircam Berkeley/IRCAM/CARL Sound Format
• ismv ISMV/ISMA (Smooth Streaming)
• iss Funcom ISS
• iv8 IndigoVision 8000 video
• ivf On2 IVF
• j2k_pipe piped j2k sequence
• jack JACK Audio Connection Kit
• jacosub JACOsub subtitle format
• jpeg_pipe piped jpeg sequence
• jpegls_pipe piped jpegls sequence
• jv Bitmap Brothers JV
• latm LOAS/LATM
• lavfi Libavfilter virtual input device
• libcdio
• libdc1394 dc1394 v.2 A/V grab
• libgme Game Music Emu demuxer
• libmodplug ModPlug demuxer
• live_flv live RTMP FLV (Flash Video)
• lmlm4 raw lmlm4
• loas LOAS AudioSyncStream
• lrc LRC lyrics
• lvf LVF
• lxf VR native stream (LXF)
• m4v raw MPEG-4 video
• matroska Matroska
• matroska,webm Matroska / WebM
• md5 MD5 testing
• mgsts Metal Gear Solid: The Twin Snakes
• microdvd MicroDVD subtitle format
• mjpeg raw MJPEG video
• mkvtimestamp_v2 extract pts as timecode v2 format, as defined by mkvtoolnix
• mlp raw MLP
• mlv Magic Lantern Video (MLV)
• mm American Laser Games MM
• mmf Yamaha SMAF
• mov QuickTime / MOV
• mov,mp4,m4a,3gp,3g2,mj2 QuickTime / MOV
• mp2 MP2 (MPEG audio layer 2)
• mp3 MP3 (MPEG audio layer 3)
• mp4 MP4 (MPEG-4 Part 14)
• mpc Musepack
• mpc8 Musepack SV8
• mpeg MPEG-1 Systems / MPEG program stream
• mpeg1video raw MPEG-1 video
• mpeg2video raw MPEG-2 video
• mpegts MPEG-TS (MPEG-2 Transport Stream)
• mpegtsraw raw MPEG-TS (MPEG-2 Transport Stream)
• mpegvideo raw MPEG video
• mpjpeg MIME multipart JPEG
• mpl2 MPL2 subtitles
• mpsub MPlayer subtitles
• msnwctcp MSN TCP Webcam stream
• mtv MTV
• mulaw PCM mu-law
• mv Silicon Graphics Movie
• mvi Motion Pixels MVI
• mxf MXF (Material eXchange Format)
• mxf_d10 MXF (Material eXchange Format) D-10 Mapping
• mxf_opatom MXF (Material eXchange Format) Operational Pattern Atom
• mxg MxPEG clip
• nc NC camera feed
• nistsphere NIST SPeech HEader REsources
• nsv Nullsoft Streaming Video
• nut NUT
• nuv NuppelVideo
• oga Ogg Audio
• ogg Ogg
• oma Sony OpenMG audio
• openal OpenAL audio capture device
• opengl OpenGL output
• opus Ogg Opus
• oss OSS (Open Sound System) playback
• paf Amazing Studio Packed Animation File
• pictor_pipe piped pictor sequence
• pjs PJS (Phoenix Japanimation Society) subtitles
• pmp Playstation Portable PMP
• png_pipe piped png sequence
• psp PSP MP4 (MPEG-4 Part 14)
• psxstr Sony Playstation STR
• pulse Pulse audio output
• pva TechnoTrend PVA
• pvf PVF (Portable Voice Format)
• qcp QCP
• qdraw_pipe piped qdraw sequence
• r3d REDCODE R3D
• rawvideo raw video
• realtext RealText subtitle format
• redspark RedSpark
• rl2 RL2
• rm RealMedia
• roq raw id RoQ
• rpl RPL / ARMovie
• rsd GameCube RSD
• rso Lego Mindstorms RSO
• rtp RTP output
• rtp_mpegts RTP/mpegts output format
• rtsp RTSP output
• s16be PCM signed 16-bit big-endian
• s16le PCM signed 16-bit little-endian
• s24be PCM signed 24-bit big-endian
• s24le PCM signed 24-bit little-endian
• s32be PCM signed 32-bit big-endian
• s32le PCM signed 32-bit little-endian
• s8 PCM signed 8-bit
• sami SAMI subtitle format
• sap SAP output
• sbg SBaGen binaural beats script
• sdl SDL output device
• sdp SDP
• sdr2 SDR2
• segment segment
• sgi_pipe piped sgi sequence
• shn raw Shorten
• siff Beam Software SIFF
• singlejpeg JPEG single image
• sln Asterisk raw pcm
• smjpeg Loki SDL MJPEG
• smk Smacker
• smoothstreaming Smooth Streaming Muxer
• smush LucasArts Smush
• sol Sierra SOL
• sox SoX native
• spdif IEC 61937 (used on S/PDIF - IEC958)
• spx Ogg Speex
• srt SubRip subtitle
• stl Spruce subtitle format
• stream_segment,ssegment streaming segment muxer
• subviewer SubViewer subtitle format
• subviewer1 SubViewer v1 subtitle format
• sunrast_pipe piped sunrast sequence
• sup raw HDMV Presentation Graphic Stream subtitles
• svcd MPEG-2 PS (SVCD)
• swf SWF (ShockWave Flash)
• tak raw TAK
• tedcaptions TED Talks captions
• tee Multiple muxer tee
• thp THP
• tiertexseq Tiertex Limited SEQ
• tiff_pipe piped tiff sequence
• tmv 8088flex TMV
• truehd raw TrueHD
• tta TTA (True Audio)
• tty Tele-typewriter
• txd Renderware TeXture Dictionary
• u16be PCM unsigned 16-bit big-endian
• u16le PCM unsigned 16-bit little-endian
• u24be PCM unsigned 24-bit big-endian
• u24le PCM unsigned 24-bit little-endian
• u32be PCM unsigned 32-bit big-endian
• u32le PCM unsigned 32-bit little-endian
• u8 PCM unsigned 8-bit
• uncodedframecrc uncoded framecrc testing
• v4l2 Video4Linux2 output device
• vc1 raw VC-1 video
• vc1test VC-1 test bitstream
• vcd MPEG-1 Systems / MPEG program stream (VCD)
• video4linux2,v4l2 Video4Linux2 device grab
• vivo Vivo
• vmd Sierra VMD
• vob MPEG-2 PS (VOB)
• vobsub VobSub subtitle format
• voc Creative Voice
• vplayer VPlayer subtitles
• vqf Nippon Telegraph and Telephone Corporation (NTT) TwinVQ
• w64 Sony Wave64
• wav WAV / WAVE (Waveform Audio)
• wc3movie Wing Commander III movie
• webm WebM
• webm_chunk WebM Chunk Muxer
• webm_dash_manifest WebM DASH Manifest
• webp WebP
• webp_pipe piped webp sequence
• webvtt WebVTT subtitle
• wsaud Westwood Studios audio
• wsvqa Westwood Studios VQA
• wtv Windows Television (WTV)
• wv raw WavPack
• x11grab X11 screen capture, using XCB
• xa Maxis XA
• xbin eXtended BINary text (XBIN)
• xmv Microsoft XMV
• xv XV (XVideo) output device
• xwma Microsoft xWMA
• yop Psygnosis YOP
• yuv4mpegpipe YUV4MPEG pipe