https://github.com/atick-faisal/img2gif
🎬 A playful Python library for converting image sequences into animated GIFs
https://github.com/atick-faisal/img2gif
cli gif image-processing package pip pypi python
Last synced: 6 months ago
JSON representation
🎬 A playful Python library for converting image sequences into animated GIFs
- Host: GitHub
- URL: https://github.com/atick-faisal/img2gif
- Owner: atick-faisal
- License: mit
- Created: 2025-10-24T10:06:12.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-11-24T05:53:55.000Z (7 months ago)
- Last Synced: 2025-11-27T23:52:39.406Z (7 months ago)
- Topics: cli, gif, image-processing, package, pip, pypi, python
- Language: Python
- Homepage: https://pypi.org/project/imgif
- Size: 165 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
> ✨ A playful Python library for converting image sequences into animated GIFs with ease!
Turn your image sequences into delightful animated GIFs with just a few lines of code. Whether you're creating animations from screenshots, visualizing data, or just having fun, `imgif` makes it simple and enjoyable! 🚀
## 🌟 Features
- 🎨 **Simple API** - Convert images to GIF in just 3 lines of code
- ⚡ **Fast & Efficient** - Built on Pillow for optimal performance
- 🎛️ **Highly Configurable** - Control duration, quality, size, and more
- 💻 **CLI Interface** - Use directly from the command line
- 📝 **Fully Typed** - Complete type annotations for great IDE support
- 🧪 **100% Test Coverage** - Reliable and well-tested
- 🎭 **Rich Output** - Beautiful progress indicators and error messages
## 📦 Installation
```bash
# Using pip
pip install imgif
# Using uv (recommended for development)
uv pip install imgif
```
## 🚀 Quick Start
### Python API
```python
from img2gif import ImageToGifConverter
# Create converter
converter = ImageToGifConverter()
# Convert images to GIF
converter.convert(
input_dir="./my_images",
output_path="./output.gif",
duration=0.5, # seconds per frame
)
print("🎉 GIF created successfully!")
```
### Command Line
```bash
# Basic usage
imgif ./my_images output.gif
# With options
imgif ./my_images output.gif --duration 0.5 --loop 0
# See all options
imgif --help
```
## 📖 Documentation
Full documentation is available at [imgif.readthedocs.io](https://imgif.readthedocs.io)
## 🛠️ Development
### Setup
```bash
# Clone the repository
git clone https://github.com/atick-faisal/img2gif.git
cd img2gif
# Install dependencies using uv
uv sync
# Install pre-commit hooks
pre-commit install
```
### Running Tests
```bash
# Run tests on default Python version
hatch run test:all
# Run tests on all supported Python versions
hatch run test:all
# Run with coverage
hatch run test:cov
```
### Linting & Formatting
```bash
# Check code
ruff check .
# Format code
ruff format .
```
## 🤝 Contributing
Contributions are welcome! Please check out our [Contributing Guide](CONTRIBUTING.md) for details.
## 🙏 Acknowledgments
- Built with [Pillow](https://pillow.readthedocs.io/) 📸
- CLI powered by [click](https://click.palletsprojects.com/) 🖱️
- Beautiful output by [rich](https://rich.readthedocs.io/) 💎
