Lightweight video thumbnailer that can be used by file managers to create thumbnails for video files
C++ C CMake Shell
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.vscode Fixed crash when setting a log callback using the c api Nov 13, 2017
cmake Cmake improvements Sep 9, 2017
dist Add "application/vnd.rn-realmedia" to thumbnailer mime types Sep 8, 2016
gfx Film strip overlay is dependant on thumbnail size May 12, 2010
kffmpegthumbnailer Fixed Changelog Jan 6, 2010
libffmpegthumbnailer Add image source field to video info Nov 21, 2017
man Preparations for release 2.2.0 Aug 26, 2016
test Add image source field to video info Nov 21, 2017
thunar files add gif to the thumbnailer mimetypes to support animated gifs Sep 26, 2014
.gitignore Add vscode files Nov 12, 2017
.travis.yml Disabled clang in travis. Version is too old Nov 13, 2017
AUTHORS Documention does not need to be executable. Oct 11, 2016
CMakeLists.txt Fixed size 0 of deprecated size settings Nov 20, 2017
CMakeUninstall.cmake.in Use cmake Apr 21, 2015
COPYING Initial import Feb 24, 2007
ChangeLog Support specifying the size as string using the c api Nov 13, 2017
INSTALL Documention does not need to be executable. Oct 11, 2016
MakeRelease.sh MakeRelase.sh fixed upload filename Apr 26, 2015
NEWS Documention does not need to be executable. Oct 11, 2016
README Documention does not need to be executable. Oct 11, 2016
README.md Documention does not need to be executable. Oct 11, 2016
TODO Documention does not need to be executable. Oct 11, 2016
config.h.in Support thumbnailer and gio option Apr 26, 2015
libffmpegthumbnailer.pc.in Fix libffmpegthumbnailer.pc to work with multilib systems Apr 16, 2017
main.c Namespace added to c++ interface Jan 5, 2010
main.cpp Support raw rgb data as image type Nov 13, 2017

README.md

Build Status Coverity Scan Build Status

FFmpegthumbnailer is a lightweight video thumbnailer that can be used by file managers to create thumbnails for your video files. The thumbnailer uses ffmpeg to decode frames from the video files, so supported videoformats depend on the configuration flags of ffmpeg.

This thumbnailer was designed to be as fast and lightweight as possible. The only dependencies are ffmpeg and libpng/libjpeg.

Usage

ffmpegthumbnailer is called from the command line

Available command line arguments:

  • -i: input video filename
  • -o: output filename of the generated image file (filename ending with .jpg or .jpeg will be in jpeg format, otherwise png is used)
  • -s: size of the generated thumbnail in pixels (use 0 for original size) (default value: 128)
  • -t: time to seek to (percentage or absolute time hh:mm:ss) (default: 10)
  • -f: use this option to overlay a movie strip on the generated thumbnail
  • -q: image quality (0 = bad, 10 = best) (default: 8) only applies to jpeg output
  • -c: override image format (jpeg or png) (default: determined by filename)
  • -a: ignore aspect ratio and generate square thumbnail
  • -w: workaround some issues in older versions of ffmpeg (only use if you experience problems like 100% cpu usage on certain files)
  • -h: display the usage