Starstruk Logo MarkStarstruk

v1.6.0

met4citizen/TalkingHeadv1.6.0Sep 3, 2025by met4citizen

AI Summary

This release significantly improves streaming stability with AudioWorklet reuse, introduces an experimental avatar-only mode supporting multiple avatars, and adds various new APIs including update option, head.dispose method, and exposure of animations and userData. Also adds English pronunciation support and auto-generates missing RPM blend shapes.

Key Highlights

  • Improved streaming stability and AudioWorklet reuse
  • New experimental avatar-only mode with multiple avatars support
  • Added external animation loop update function via update option
  • Added head.dispose method to prevent memory leaks
  • Exposed head.animations and head.userData for PlayerZero animations
  • Support for English decades and ordinals pronunciation
  • Auto-generation of Ready Player Me blend shapes
  • Three.js bumped from r170 to r180

New Features

  • Avatar-only mode with custom 3D scene and renderer
  • Multiple avatars support
  • update option for external animation loop
  • head.dispose method
  • head.animations and head.userData exposure
  • English decades and ordinals pronunciation
  • Automatic Ready Player Me blend shapes generation

Full Release Notes

- Improved streaming stability and AudioWorklet reuse (contributed by @ibrahoss).
- Added a new, experimental avatar-only mode that allows the app to use its own 3D scene and renderer + support for multiple avatars (see Appendix H in README for more information).
- Added support for an external animation loop update function via the new `update` option.
- Added `head.dispose` method to prevent memory leaks in cases when the app wants to dispose the TalkingHead instance.
- Exposed `head.animations` and `head.userData` to enable the app to play built-in PlayerZero animations #124 .
- Added support for correctly pronouncing English decades and ordinal numbers (h/t to @red-reddington ).
- Added automatic generation of the additional Ready Player Me blend shapes (mouthOpen, mouthSmile, eyesClosed, eyesLookUp, eyesLookDown), if  missing.
- Bumped Three.js version from r170 to r180 (tested; no changes to the TalkingHead class).
- Fixed Unicode handling.
- Minor fixes and improvements.

## What's Changed
* Fix streamStop() to properly interrupt audio playback by @ibrahoss in https://github.com/met4citizen/TalkingHead/pull/118
* Improve Streaming Stability and AudioWorklet Reuse + Add Performance Metrics by @ibrahoss in https://github.com/met4citizen/TalkingHead/pull/123


**Full Changelog**: https://github.com/met4citizen/TalkingHead/compare/v1.5.0...v1.6.0