img2mp3/CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.0.0] - 2025-09-06

Added

• Initial release of IMG2MP3
• MP3 encoding into images using steganography techniques
• Decoding of .i2m files back to original image and MP3
• Built-in audio player with support for multiple system players:
  • mpg123, mpv, ffplay, vlc, sox
• Command-line interface with the following commands:
  • encode: Embed MP3 into image
  • decode: Extract image and MP3 from .i2m file
  • play: Play audio from .i2m file
  • info: Show information about .i2m file
  • interactive: Interactive mode for guided usage
• Programmatic API with IMG2MP3 class
• TypeScript type definitions
• Cross-platform support (Linux, macOS, Windows)
• Custom .i2m file format with magic byte verification
• Automatic cleanup of temporary files
• Comprehensive documentation and examples

Features

• Steganography: Advanced encoding techniques to hide MP3 data in images
• Lossless: Original image and audio quality preserved
• Format Support: Works with various image formats (PNG, JPEG, WebP, etc.)
• Audio Players: Automatic detection of available system audio players
• CLI Interface: Easy-to-use command-line tools
• Interactive Mode: Guided step-by-step usage
• API: Clean programmatic interface for integration
• TypeScript: Full type definitions included

Technical Details

• Uses Sharp library for reliable image processing
• Custom container format with 16-byte header
• Magic bytes "I2M3" for file format verification
• Supports images and MP3 files of any size
• Generates PNG containers for pixel manipulation reliability
• Temporary file management with automatic cleanup