github kizuna-ai-lab/sokuji v0.29.0

4 hours ago

Highlights

🎧 Self-healing audio playback during Bluetooth / device disruptions

Sokuji now recovers automatically when the playback output device misbehaves — Bluetooth hiccups, audio renderer errors, or device hot-swaps mid-session no longer leave the monitor permanently silent or stuck replaying audio from 10 seconds ago. Addresses #246.

Specifically:

  • Auto-rebuild stuck audio contexts. When Chrome's WebAudio renderer encounters an error (most commonly a Bluetooth disconnect on Windows), the player AudioContext used to get permanently stuck in a suspended state that resume() couldn't recover from. The player now detects this within ~1.5 seconds, tears down the dead audio graph, and rebuilds it from scratch with the previous device selection.

  • Smooth passthrough catch-up. When the live mic monitor falls behind (250–800ms of accumulated backlog), the playback worklet gracefully speeds up the consume rate to between 1.01x and 1.06x using fractional sample stepping with linear interpolation. Slight pitch rise during catch-up, but no audible drops. Above 800ms, a hard ring trim takes over as the safety net.

  • Silence-aware producer. Quiet moments (below ~-50 dBFS) aren't enqueued at all, so the passthrough ring drains naturally during pauses in speech and backlog can't ratchet upward.

Previous behavior could let monitor audio drift to a 10-second delay or stop entirely until session restart. After this release, the same trigger recovers within a couple of seconds.


What's improved

  • Karaoke subtitles clear immediately when the corresponding playback item completes, instead of lingering past the end of audio.
  • Smaller, deduplicated worker bundles — a shared manualChunks helper splits the transformers, ORT, and VAD vendor code into common chunks instead of duplicating them into every worker.
  • Quieter ONNX Runtime startup — silenced the noisy VerifyEachNodeIsAssignedToAnEp warning from Supertonic on first load.

Installation

Platform Asset
macOS (Apple Silicon) Sokuji-0.29.0-arm64.pkg
macOS (Intel) Sokuji-0.29.0-x64.pkg
Windows Sokuji-0.29.0.Setup.exe
Linux (.deb, x64) sokuji_0.29.0_amd64.deb
Linux (.deb, arm64) sokuji_0.29.0_arm64.deb
Linux (AppImage, x64) Sokuji-0.29.0-x86_64.AppImage
Linux (AppImage, arm64) Sokuji-0.29.0-arm64.AppImage
Browser extension (Chrome/Edge) sokuji-extension-0.29.0.zip

Existing installations on macOS / Windows auto-update on next launch.


Full change log: v0.28.0
v0.29.0

Don't miss a new sokuji release

NewReleases is sending notifications on new releases.