Python package wrapping the gifsicle library for editing and optimizing gifs.
Project description
Python package wrapping the gifsicle library for editing and optimizing gifs.
How do I install this package?
As usual, just download it using pip:
pip install pygifsicle
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.
Usage examples
The library is currently pretty plain: it offers a wrapper to gifsicle and a method to optimize gifs, wrapping the options for gifsicle.
Optimizing a gif
To optimize a gif, use the following:
from pygifsicle import optimize
optimize("path_to_my_gif.gif")
General wrapper
To run gifsicle from Python use the following:
from pygifsicle import gifsicle
gifsicle(
sources=["list.gif", "of.gif", "gifs.gif"], # or a single_file.gif
destination="destination.gif" # or just omit it and will use the first source provided.
optimize=False, # Whetever to add the optimize flag of not
colors=256, # Number of colors t use
options=["--verbose"] # Options to use.
)
Learn more about the general wrapper by reading the function documentation.
Troubleshooting
One of the most common issues you can get, especially on windows, is that simply the gifsicle library is not available system wide. Do try to run gifsicle in your terminal to check if the library is properly installed.
Help and support
Wanna add another wrapper for easier usage? Do a pull request!
Did you find an error or weird behavior? Open an issue!
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.