Starstruk Logo MarkStarstruk

v1.6.0

HKUDS/CLI-Anythingv1.6.0Sep 3, 2025by met4citizen

AI Summary

Significant improvements to streaming stability and performance, including AudioWorklet reuse, an experimental avatar-only mode, external animation loops, and memory management tools like `head.dispose`.

Key Highlights

  • Improved streaming stability and AudioWorklet reuse
  • Experimental avatar-only mode with multiple avatar support
  • Added `head.dispose` method for memory management
  • Exposed `head.animations` and `head.userData`
  • Automatic generation of Ready Player Me blend shapes

New Features

  • Avatar-only mode
  • External animation loop update function
  • `head.dispose` method
  • Exposed `head.animations` and `head.userData`
  • English decades and ordinal number support
  • Automatic blend shape generation
  • Three.js bump to r180
  • 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