{"id":15645258,"url":"https://github.com/lucacappelletti94/pygifsicle","last_synced_at":"2025-10-15T05:12:40.649Z","repository":{"id":49121596,"uuid":"210006086","full_name":"LucaCappelletti94/pygifsicle","owner":"LucaCappelletti94","description":"Python package wrapping the gifsicle library for editing and optimizing gifs.","archived":false,"fork":false,"pushed_at":"2024-07-07T08:01:08.000Z","size":3855,"stargazers_count":56,"open_issues_count":0,"forks_count":9,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-05-08T21:43:54.456Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/LucaCappelletti94.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"LucaCappelletti94"}},"created_at":"2019-09-21T15:11:08.000Z","updated_at":"2025-03-22T20:26:25.000Z","dependencies_parsed_at":"2024-10-03T12:09:42.944Z","dependency_job_id":"6c70080f-d2de-44d8-908d-40cdd42012d7","html_url":"https://github.com/LucaCappelletti94/pygifsicle","commit_stats":{"total_commits":58,"total_committers":4,"mean_commits":14.5,"dds":"0.15517241379310343","last_synced_commit":"0df654299e91b7130804645dda7b8fd3d1714115"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LucaCappelletti94%2Fpygifsicle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LucaCappelletti94%2Fpygifsicle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LucaCappelletti94%2Fpygifsicle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LucaCappelletti94%2Fpygifsicle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LucaCappelletti94","download_url":"https://codeload.github.com/LucaCappelletti94/pygifsicle/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253153948,"owners_count":21862434,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-03T12:05:26.510Z","updated_at":"2025-10-15T05:12:35.629Z","avatar_url":"https://github.com/LucaCappelletti94.png","language":"Python","readme":"# Pygifsicle\n\n[![pip](https://badge.fury.io/py/pygifsicle.svg)](https://pypi.org/project/pygifsicle/)\n[![License](https://img.shields.io/github/license/LucaCappelletti94/pygifsicle)](LICENSE)\n[![downloads](https://pepy.tech/badge/pygifsicle)](https://pepy.tech/project/pygifsicle)\n[![python versions](https://img.shields.io/pypi/pyversions/pygifsicle)](https://www.python.org/downloads/)\n[![GitHub actions](https://github.com/LucaCappelletti94/pygifsicle/actions/workflows/python.yml/badge.svg)](https://github.com/LucaCappelletti94/pygifsicle/actions/)\n\nPython package wrapping the [gifsicle library](https://www.lcdf.org/gifsicle/) for editing and optimizing gifs.\n\n## How do I install this package?\n\nAs usual, just download it using pip:\n\n```shell\npip install pygifsicle\n```\n\nWhile running the installation, on **MacOS** the setup will automatically install **gifsicle** using [Brew](https://brew.sh/).\n\nOn Linux you will need to install **gifsicle** using apt-get as follows:\n\n```shell\nsudo apt-get install gifsicle\n```\n\nOn Windows you will need to download and install the [correct port of the library](https://eternallybored.org/misc/gifsicle/) for your OS.\n\n## Usage examples\n\nThe library is currently pretty plain: it offers a wrapper to gifsicle and a method to optimize gifs, wrapping the options for gifsicle.\n\n### Optimizing a gif\n\nTo optimize a gif, use the following:\n\n```python\nfrom pygifsicle import optimize\noptimize(\"path_to_my_gif.gif\")\n```\n\n### General wrapper\n\nTo run gifsicle from Python use the following:\n\n```python\nfrom pygifsicle import gifsicle\ngifsicle(\n    sources=[\"list.gif\", \"of.gif\", \"gifs.gif\"], # or a single_file.gif\n    destination=\"destination.gif\", # or just omit it and will use the first source provided.\n    optimize=False, # Whether to add the optimize flag or not\n    colors=256, # Number of colors to use\n    options=[\"--verbose\"] # Options to use.\n)\n```\n\nLearn more about the general wrapper [by reading the function documentation](https://github.com/LucaCappelletti94/pygifsicle/blob/0c7a1928eb0a5eb3dc99c46c227f970c7bd6b31b/pygifsicle/pygifsicle.py#L8).\n\n## Troubleshooting\n\nOne 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.\n\n## Help and support\n\nWanna add another wrapper for easier usage? [Do a pull request!](https://github.com/LucaCappelletti94/pygifsicle/pulls)\n\nDid you find an error or weird behavior? [Open an issue!](https://github.com/LucaCappelletti94/pygifsicle/issues)","funding_links":["https://github.com/sponsors/LucaCappelletti94"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flucacappelletti94%2Fpygifsicle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flucacappelletti94%2Fpygifsicle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flucacappelletti94%2Fpygifsicle/lists"}