# Changelog

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

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [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