Starstruk Logo MarkStarstruk

v1.6.0

deuxfleurs-org/garagev1.6.0Sep 3, 2025by met4citizen

AI Summary

This release focuses on improving audio streaming stability and introduces new features for external animation control and avatar management. Key updates include an experimental avatar-only mode, support for external animation loops, and fixes for pronunciation and Unicode handling.

Key Highlights

  • Improved streaming stability and AudioWorklet reuse.
  • Added experimental avatar-only mode with support for multiple avatars and custom 3D scenes.
  • Added external animation loop update function via the new `update` option.
  • Added `head.dispose` method and exposed `head.animations` and `head.userData`.
  • Added support for correctly pronouncing English decades and ordinal numbers.

New Features

  • Experimental avatar-only mode allowing the app to use its own 3D scene and renderer with multiple avatars.
  • External animation loop update function support.
  • Added `head.dispose` method to prevent memory leaks.
  • Exposed `head.animations` and `head.userData` to enable playing built-in PlayerZero animations.
  • Automatic generation of Ready Player Me blend shapes (mouthOpen, mouthSmile, eyesClosed, etc.).
  • Support for correctly pronouncing English decades and ordinal numbers.

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