media_to_frames v1.0.0 First Stable Release

The first full release of media_to_frames, a Python-based media converter designed for ESP32 and ESP8266 display projects. This version transforms both .gif and .mp4 files into microcontroller-friendly frame sets, ready for use with SPIFFS, LittleFS, or SD-based animation playback.

Highlights:

🎞️ GIF and MP4 support — Converts videos to frame sequences using Pillow and MoviePy.

🖼️ Automatic resizing & quantization — Scales to your display’s resolution with color depth optimization.

🧠 Smart file handling — Creates and manages input_gifs/, input_mp4s/, and output_frames/ directories automatically.

🧪 Built-in test case — Runs GIF_TO_FRAME_TEST_CASE.gif to verify full conversion flow and data integrity.

⚙️ Command-line controls — Adjustable output size (--size 240x240) and cleanup options (--no-cleanup).

🧩 MoviePy 2.2.1 compatibility — Updated imports (from moviepy import VideoFileClip) to avoid deprecated editor calls.

This release marks a clean, stable foundation for adding new features such as PNG output, progress visualization, and frame previews.

Installation:

pip install pillow moviepy
python media_to_frames.py

Known Caveats:

Large MP4s may consume significant RAM during conversion — trim or reduce FPS before processing.

ESP8266 memory constraints may require smaller frame sizes (≤128×128).

License: MIT

A small tool with a big purpose — bridging desktop media and embedded displays.