How saeed-hussain/cadence works
Cadence is a browser-based, on-device speech synthesis product. Users choose or audition a voice, enter text or provide a recording, and use the engine to produce audio; playback, voice browsing, studio, history, and engine-status pages provide the surrounding experience. The engine API dispatches inference to a worker, which runs the Kokoro backend. The README documents the voice library and current pitch-matched cloning behavior. Some app-to-engine and feature-page wiring is documented only at a high level, so the graph avoids guessing at individual page calls.
Main entry points: index.js Engine API · app/page.jsx Home · Player.jsx Player UI · text-to-speech/page.jsx Text to speech
Components 24
Web experience
- Home
apps/web/app/page.jsx - Text to speech
apps/web/app/text-to-speech/page.jsx - Studio
apps/web/app/studio/page.jsx - Voice cloning
apps/web/app/voice-cloning/page.jsx - Voice changer
apps/web/app/voice-changer/page.jsx - Voice library
apps/web/app/voices/page.jsx - History
apps/web/app/history/page.jsx - Engine status
apps/web/app/engine/page.jsx - App state
apps/web/lib/store.jsx - Voice picker
apps/web/components/VoicePicker.jsx - Audio controls
apps/web/components/Controls.jsx - Player UI
apps/web/components/Player.jsx
Engine control
- Engine API
packages/cadence/src/index.js - Inference worker
packages/cadence/src/worker.js
Synthesis backends
- Kokoro backend
packages/cadence/src/kokoro.js - Piper backend
packages/cadence/src/piper.js - Pitch analysis
packages/cadence/src/dsp.js
Voices and playback
- Voice catalog
packages/cadence/src/voices.js - WAV encoding
packages/cadence/src/wav.js - Audio playback
apps/web/lib/audio.js - Waveform display
apps/web/components/Waveform.jsx - Voice orb
apps/web/components/Orb.jsx
Other components
- User
- ONNX Runtime Web
Connections 22
- User → Home: uses
- Home → Text to speech: opens
- User → Studio: uses
- User → Voice cloning: provides recording
README.md - User → Voice changer: uses
- User → Voice library: browses
README.md - User → History: reviews
- User → Engine status: checks status
- Home → Engine API: uses engine
README.md - Text to speech → Engine API: uses engine
README.md - Studio → Engine API: uses engine
README.md - Voice cloning → Engine API: matches recording
README.md - Voice library → Engine API: auditions voices
README.md - Engine API → Inference worker: dispatches inference
README.md - Inference worker → Kokoro backend: loads backend
packages/cadence/src/worker.js - Kokoro backend → ONNX Runtime Web: runs inference
README.md - Engine API → Pitch analysis: measures pitch
packages/cadence/src/index.js - Engine API → Voice catalog: matches pitch
packages/cadence/src/index.js - Voice picker → App state: reads voices
apps/web/components/VoicePicker.jsx - Player UI → Audio playback: controls playback
apps/web/components/Player.jsx - Voice orb → Audio playback: reads playback level
apps/web/components/Orb.jsx - Player UI → Waveform display: renders waveform
apps/web/components/Player.jsx