🌀 Create a GIF with Pyhton

A simple and educational Python project that generates an animated GIF from a series of images, while showcasing best practices in image processing, file handling, and user interaction.

---

Naruto GIF Generator
Create animated GIFs from images with Python

---

🎯 Learning objectives

This project has enabled me to learn to :

• Manipulating image files with the library imageio
• Using regular expressions to clean up file names
• Manage file paths in a portable way with pathlib
• Dynamically create a GIF file from local images
• Apply good Python development practices:
  • Error handling(try/except)
  • Automatic directory creation
  • Secure user input
  • Code readability and structure

---

⚙️ Technologies used

Technologie	Usage
Python 3.13	Main language
imageio.v3	Reading/writing images and creating GIFs
pathlib	Modern file path management
re	Cleaning up filenames with regular expressions
datetime	Inserting the date in the name of the generated file

---

💻 Features

• 🔄 Generates an animated GIF from images in a folder images/
• 🧼 Automatically cleans up GIF file names to avoid forbidden characters
• 📁 Automatically creates the gif_generate/ si inexistant
• 📅 Adds today's date to the file name to prevent overwriting
• 🔐 Handles errors caused by missing or illegible files
• 🧠 Code that is structured, commented, readable and easy to modify

---

🗂️ Structure du projet

naruto-gif-generator/
│
├── images/                 # Contains source images
│   ├── naruto1.jpg
│   └── ...
│
├── gif_generate/           # Contains the generated GIF
│   └── naruto_<date>.gif
│
├── create_gif.py          # Main script
└── README.md               # Project description (you are here)

---

▶️Use

1. Place your images in the images/
2. Run the script :

python3 create_gif.py

3. Give your GIF a name when requested
4. The file will be generated in gif_generate/

---

🧪 Example of output

Give me the name you want for your gif : naruto_final
✅ GIF generated successfully at: gif_generate/naruto_final_2025-04-06.gif

---

📦Installation

1. Clone this repository :

git clone https://github.com/ton-nom-utilisateur/Create-a-GIF-with-Python.git

2.Installs dependencies:

pip install imageio

---

✨What you can learn from this project

Expertise	Learned
Use of third-party libraries (imageio)	✅
Secure cleaning of user input (regex)	✅
File creation and path management(pathlib)	✅
Robust scripts with error handling	✅
Python project structuring	✅
Continuous integration possible	✅

---

🔄 Opportunities for improvement

• Interface graphique (Tkinter / PyQt)
• If you have any ideas, don't hesitate to contact us.

---

🙌 Remerciements

• 🔗Codedex.io the best site for learning