Files

1.9 KiB

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 - 2026-01-22

Added

  • ๐ŸŽ™๏ธ High-quality text-to-speech using Piper TTS
  • ๐ŸŒ Support for 40+ languages (French, English, Spanish, German, and more)
  • ๐Ÿ“ค Automatic WhatsApp message sending via Bot
  • ๐Ÿ‘ฅ Support for WhatsApp groups (use group ID as target)
  • ๐ŸŽ›๏ธ Multiple quality levels (x_low, low, medium, high)
  • ๐ŸŽต Automatic conversion to OGG/Opus format for WhatsApp
  • ๐Ÿงน Smart file cleanup:
    • Auto-delete files after successful send
    • Auto-cleanup files older than 24 hours
    • Keep files on send error for manual retry
  • โš™๏ธ Flexible configuration via environment variables
  • ๐Ÿšซ --no-send option to generate audio without sending
  • ๐ŸŽš๏ธ --speed option to adjust playback speed
  • ๐Ÿ’ฌ --message option to add text caption with audio
  • ๐Ÿ“Š Clear progress logging and error messages
  • ๐Ÿ” Model existence validation with helpful error messages

Features

  • Multi-language support: Switch between 40+ languages with --lang
  • Voice selection: Choose specific voices with --voice
  • Quality control: Adjust quality/size trade-off with --quality
  • Group messaging: Send to WhatsApp groups using group IDs
  • Environment-based defaults: Set preferences via environment variables
  • Fast generation: ~2-3s from command to WhatsApp delivery

Technical Details

  • Node.js script with minimal dependencies
  • Integration with Piper TTS for speech synthesis
  • FFmpeg for audio format conversion
  • Bot CLI for WhatsApp delivery
  • Automatic cleanup of temporary files
  • Comprehensive error handling