Skip to main content

A convenient video thumbnails generator.

Project description

pypi license travis-ci

thumbup is a command-line video thumbnails generator written in Python.

Getting thumbup

You’ll need ffmpeg before you can use thumbup, which can be installed by

# on macOS
brew install ffmpeg

# on ubuntu (>= 14.04)
sudo apt-get install -y \
  libavformat-dev libavcodec-dev libavdevice-dev \
  libavutil-dev libswscale-dev libavresample-dev libavfilter-dev

ffmpeg is also widely available for many other distros. Please refer to the official website

thumbup can be installed from pip by

pip install thumbup


To generate thumbnails for video files file1 and file2, simply use

thumbup file1 file2

The above will create file1.jpg and file2.jpg in the same directory as the video files.

To generate thumbnails for all video files in directory dir, use -r option. thumbup will recursively go through every video in directory dir and generate thumbnails next to them.

thumbup -r dir

Full help message for more control:

usage: [-h] [-v] [-r] [-f] [-o OFFSET] [-s X] FILE [FILE ...]

thumbup video thumbnail generator vv1.5.1

positional arguments:
  FILE                  one or more video files or directories (with -r)

optional arguments:
  -h, --help            show this help message and exit
  -v, --verbose         logging more stuff
  -r, --rec             recursively go into all dirs
  -f, --force           force overwrite existing thumbnails
  -o OFFSET, --offset OFFSET
                        skip OFFSET ( or second) from the beginning
  -s X, --suffix X      add suffix to the output filename, input.mp4 ->

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

thumbup-1.5.1-py2.py3-none-any.whl (8.2 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page