Skip to content
Lightweight video thumbnailer that can be used by file managers to create thumbnails for video files
C++ C CMake Shell
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.vscode vscode settings Mar 1, 2019
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
.clang-format Use chrono for duration logic Mar 1, 2019
.gitignore vscode settings Mar 1, 2019
.travis.yml Travis: drop old xcode config Mar 1, 2019
AUTHORS Documention does not need to be executable. Oct 11, 2016
CMakeLists.txt Remove broken continuous mode Oct 3, 2019
CMakeUninstall.cmake.in Use cmake Apr 21, 2015
COPYING Initial import Feb 24, 2007
ChangeLog Remove broken continuous mode Oct 3, 2019
INSTALL Documention does not need to be executable. Oct 11, 2016
MakeRelease.sh Fixed version detection in release script Sep 29, 2019
NEWS Documention does not need to be executable. Oct 11, 2016
README Documention does not need to be executable. Oct 11, 2016
README.md Support for continuous thumbnail creation Jun 6, 2017
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 Remove broken continuous mode Oct 3, 2019

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)
  • -rN: repeat thumbnail generation each N seconds, N=0 means disable repetition (default: 0)
  • -h: display the usage
You can’t perform that action at this time.