Skip to content

Version 0.4.0a1

Released January 10th, 2026

Added

  • New origin property in AudioBeginEvent to make tracking audio source origins easier (via play(), queue, or history).
  • AudioPlaybackState to clearly define playback states (BUFFERING, IDLE, PAUSED, PLAYING, STOPPING).
  • New AudioSecondEvent which dispatches every elapsed second of a playing audio source.
  • New duration property for each AudioSource. Buffer/File/URL sources must be provided a duration for player timestamp properties/fields to work properly.
  • Corresponding elapsed, remaining, and progress properties in AudioPlayer.
  • New incoming audio system with MemberSpeechEvent - allows recording/handling of member audio (configurable with record option in Config).
  • New clear_history method in AudioPlayer.

Changed

  • Project build moved from setuptools to hatchling.
  • Playback FSM enforcement added with validation.
  • websockets DEBUG logs silenced by default.
  • Removed heartbeat DEBUG logging.
  • FileAudioSource marked primarily for testing, development, and simple use cases (not production).
  • Audio sources refactored into multiple files for organization.

Fixed

  • Internal AudioPlayer properly captures the current source when emitting the AudioEndEvent, preventing None source emissions.