v1.6.0

SamsungSAILMontreal/TinyRecursiveModelsv1.6.0Sep 3, 2025by met4citizen

AI Summary

Significant update improving streaming stability, adding avatar-only mode, exposing internal animation properties, and bumping Three.js.

Key Highlights

  • Improved streaming stability and AudioWorklet reuse.
  • Added experimental avatar-only mode.
  • Added `head.dispose` method and exposed `head.animations` and `head.userData`.
  • Bumped Three.js version from r170 to r180.

New Features

  • Avatar-only mode
  • External animation loop update function
  • `head.dispose` method
  • Exposed `head.animations` and `head.userData`
  • Automatic blend shape generation
  • English number pronunciation support
  • Unicode handling fixes

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