v1.3.0

Release Notes (v1.3.0)

v1.3.0 - Audio Format Handling Improvements

🐛 Bug Fixes

• Fixed hardcoded MP3 file extension that ignored user-configured output format
• Audio files now correctly use extension matching the configured Azure output format (e.g., .ogg for Opus, .g722 for G.722)
• Fixed missing auto-reload when changing integration options

✨ Enhancements

• Replaced free-text audio format field with categorized dropdown menu
• Added 12 pre-configured streaming audio formats with user-friendly labels
• Formats organized by use case: Recommended, Standard quality, VoIP/Telephony
• Integration now automatically reloads when options are changed (no manual restart required)
• Added debug logging for format detection and extension mapping

🎯 New Features

• Support for VoIP/telephony codecs: µ-law, A-law, G.722, AMR-WB
• Support for modern compressed formats: OGG Opus (24/48 kHz), WebM Opus
• Dynamic file extension mapping based on Azure format specification
• Auto-reload integration on options update via async_update_options() listener

🔧 Technical Changes

• Added _get_file_extension_from_format() helper function in tts.py
• Added AUDIO_FORMATS constant dictionary in const.py
• Modified config_flow.py to use vol.In() validator for format selection
• Added async_update_options() in init.py with entry update listener
• All supported formats are streaming-compatible (RIFF/non-streaming formats excluded)
• Debug logs added for initialization and format mapping

📋 Supported Formats

• MP3: 16/24/48 kHz (32-192 kbps)
• OGG Opus: 24/48 kHz
• WebM Opus: 24 kHz
• VoIP: µ-law, A-law (8 kHz), G.722 (16 kHz), AMR-WB (16 kHz)

⚠️ Notes

• Home Assistant TTS proxy may normalize file extensions to .mp3 for media player compatibility
• Audio quality and codec parameters are correctly applied regardless of file extension

Full Changelog: 1.2.0...1.3.0