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 Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page