mARTin-B78/tts-voice-creator-clone-and-design-2
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
8f856c8f8b
tts-voice-creator-clone-and.../architecture/voice-health.md
mARTin-B78 a0cd7b867f feat(voices): show audio problems in the voice library 
Single-voice health endpoint (GET /api/voices/{id}/health), problems stored in
meta on import, shown in the Try-out voice panel; architecture note and docs.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-04 16:35:10 +02:00

1.1 KiB
Raw Blame History

Voice health and audio problems

  • core/voice.py::_voice_health(p, analyze=False) returns the metadata checks (ok, warnings, duration, word_count, words_per_sec, loudness) plus problems.
  • core/audio.py::audio_problems decodes with pydub in 50 ms chunks (first 120 s only) and returns [{kind: silence|clipping|level_jump, start_s, end_s, detail}]. Thresholds are PROBLEM_* constants. No new dependencies.
  • Cost model: decoding is the expensive part, so the voice list never analyses (analyze=False returns meta["audio_problems"], empty if absent). Fresh analysis runs for GET /api/voices/{id}/health and the routing test, cached in-process by (path, mtime). Imports store the result in meta in routes/sources.py::_prepare_imported_voice; failures there never block the import.
  • UI: fmtAudioProblems (static/js/utils.js) renders text for the routing result and the Try-out voice panel (#preview-match-problems, role=status).
  • Limits: heuristics (RMS/peak per chunk); legacy voices show problems only after the health endpoint is called.