fig-converter 2.9.7

A powerful, versatile and simplistic FOSS python package and CLI to turn videos into GIFs and vice-versa.

Usage

You can use FIG's built-in CLI to convert videos to GIFs through the Command-Line.

Usage: fig [OPTIONS] FILENAME                                          
                                                                              
Options:                                                                      
  -o, --output TEXT               Output filename                             
  -g2v, --gif2video               Convert a gif to a video (options: disable- 
                                  dither, low-quality, shit-optimize, ffmpeg  
                                  are disabled)                               
  -w, --width INTEGER             Width of the gif (must be 16 or bigger)     
  -fr, --fps-reduction INTEGER    Divide fps by this number (must be bigger   
                                  than 0 and can't be bigger than the original
                                  fps)                                        
  -lq, --low-quality              Prioritize speed and size over quality      
  -dd, --disable-dither           Disable dither to increase quality but cause
                                  color banding (disables low-quality)        
  -so, --shit-optimize            Optimize the gif but make it look bad       
                                  (requires gifsicle)                         
  -f, --ffmpeg                    Use ffmpeg for higher quality conversion    
                                  (requires ffmpeg) (enables dithering)       
  -t, --text TEXT                 Text to add to the gif                      
  -ts, --text-style [top|bottom|caption]                                      
                                  Style of text to add to the gif             
  -v, --version                   Show the version and exit.                  
  --help                          Show this message and exit.

Usage: fig-download [OPTIONS] SEARCH                                       
                                                                              
Options:                                                                      
  -s, --service [tenor|youtube|other]                                         
                                  Service to download from                    
  -o, --output TEXT               Output filename                             
  -ak, --api-key TEXT             API key for Tenor                           
  -c2v, --convert2video           Convert to a video (options: disable-dither,
                                  shit-optimize, ffmpeg are disabled)         
  -w, --width INTEGER             Width of the gif (must be 16 or bigger)     
  -fr, --fps-reduction INTEGER    Divide fps by this number (must be bigger   
                                  than 0 and can't be bigger than the original
                                  fps)                                        
  -lq, --low-quality              Prioritize speed and size over quality      
  -dd, --disable-dither           Disable dither to increase quality but cause
                                  color banding (disables low-quality)        
  -so, --shit-optimize            Optimize the gif but make it look bad       
                                  (requires gifsicle)                         
  -f, --ffmpeg                    Use ffmpeg for higher quality conversion    
                                  (requires ffmpeg) (enables dithering)       
  -t, --text TEXT                 Text to add to the gif                      
  -ts, --text-style [top|bottom|caption]                                      
                                  Style of text to add to the gif             
  -v, --version                   Show the version and exit.                  
  --help                          Show this message and exit.

Or you could use FIG as a Python package.

import fig

fig.video2gif("myvideo.mp4")  # Convert video to GIF
fig.gif2video("myvideo.gif")  # Convert GIF to video

Installation

pip install fig-converter

• In order to use the shit-optimize option you'll need to install gifsicle:

  While running the installation, on MacOS the setup will automatically install gifsicle using Brew.

  On Linux you will need to install gifsicle using apt-get as follows:

  sudo apt-get install gifsicle
  

  On Windows you will need to download and install the correct port of the library for your OS.
  
  

• In order to use the ffmpeg option you'll need to install FFmpeg:

  There are a variety of ways to install FFmpeg, such as the official download links, or using your package manager of choice (e.g. sudo apt install ffmpeg on Debian/Ubuntu, brew install ffmpeg on OS X, etc.).

  Regardless of how FFmpeg is installed, you can check if your environment path is set correctly by running the ffmpeg command from the terminal, in which case the version information should appear, as in the following example (truncated for brevity):

  $ ffmpeg
  ffmpeg version 4.2.4-1ubuntu0.1 Copyright (c) 2000-2020 the FFmpeg developers
    built with gcc 9 (Ubuntu 9.3.0-10ubuntu2)
  

  Note: The actual version information displayed here may vary from one system to another; but if a message such as ffmpeg: command not found appears instead of the version information, FFmpeg is not properly installed.

Comparison

Comparison against shitty online GIF conversion tools

All GIFs are available in the gif_comparison folder for you to compare.

All of the information here was submitted in a survey.

About Us

We are a duo of independent university students and professional programmers who love contributing to the world of FOSS. Our goal is to improve our skills as developers and to make the world a better place by replacing shitty online GIF conversion tools with FOSS.

Credits

• opencv-python (Special Thanks! Super Fast)
• click (Special Thanks! Made Our CLI Amazing)
• numpy (Special Thanks! Awesome Work)
• pygifsicle
• gifsicle
• Pillow (Special Thanks! Great Project)
• more-itertools (Special Thanks! Keep Up The Good Work)
• tqdm (Special Thanks! Made Our CLI SOO Much Better)
• imageio (Special Thanks! Cheers)
• FFmpeg (Special Thanks! Amazing Project)
• requests (Special Thanks! The Simplest Web Library!)
• yt-dlp (Special Thanks! The Best youtube-dl Fork!)
• tldextract (Special Thanks! Amazing Library!)
• art (Special Thanks! Awesome fonts!)
• cpython (Special Thanks! Couldn't Have Done This Without You)
• FIG (Super Mega Special Special Thanks!!! One Of The Best FOSS Projects Out There)