Skip to main content

Create compressed GIFs from video and image sequences

Project description

Logo

vid2gif

PyPI-Status PyPI-Versions

Build-Status Coverage-Status Branch-Coverage-Status Codacy-Grade

LICENCE

Convert a video or multiple images into an optimised GIF.

  • Suited for text such as console screen recordings.

  • Requires gifsicle, convert and ffmpeg/avconv binaries.


Installation

Latest PyPI stable release

PyPI-Status

pip install vid2gif

Latest development release on github

GitHub-Status GitHub-Stars GitHub-Forks

Pull and install in the current directory:

pip install -e git+https://github.com/casperdcl/vid2gif.git@master#egg=vid2gif

Changelog

The list of all changes is available either on GitHub’s Releases: GitHub-Status or on crawlers such as allmychanges.com.

Usage

vid2gif [–help | options] <outfile> <infile>…

Documentation

PyPI-Versions README-Hits (Since 19 May 2016)

vid2gif --help
-h, --help     Print this help text and exit
-v, --version  Print version number and exit
-a=<a>, --avconv=<a>   FFMpeg executable in PATH [default: avconv]
-c=<c>, --convert=<c>  Conversion executable in PATH [default: convert]
-C=<C>, --cdepth=<C>   Colour conversion depth [default: 3]
-d=<d>, --dupdir=<d>   Directory to move duplicate input files into
                       [default: vid2gif_dup]
-D, --nodup    Don't move duplicates (ignores `dupdir`)
-g=<g>, --gifsicle=<g>
               gifsicle executable in PATH [default: gifsicle]
-i, --interactive      Pause and wait for the user to manually tweak images
                       after video -> image conversion
-l=<level>, --log=<level>
               Print various types of debugging information. Choices:
                       CRITICAL|FATAL
                       ERROR
                       WARN(ING)
                       [default: INFO]
                       DEBUG
                       NOTSET
-L, --log-trace        Print lots of debugging information (-D NOTSET)
-n, --just-print       Don't execute commands, just show them (dry-run, recon)
-T=<T>, --period=<T>   Frame period [default: 10]
-t=<t>, --tmpdir=<t>   Directory to use as scratch space
                       [default: vid2gif_tmp]

Contributions

All source code is hosted on GitHub. Contributions are welcome.

See the CONTRIBUTE file for more information.

LICENCE

Open Source (OSI approved): LICENCE

Citation information: DOI-URI

Authors

  • Casper da Costa-Luis (casperdcl)

README-Hits (Since 2 Nov 2016)

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