How kojix2/vovx works
VOVX is a Crystal desktop speech tool: it accepts text, splits it into sentences, synthesizes speech through VOICEVOX, and plays each sentence while preparing the next. Its GUI exposes voice, speed, playback, and stop controls; it can launch an unavailable engine and persists settings. The README also documents macOS Services integration and Linux clipboard fallback. Source excerpts were unavailable, so relationships below are limited to documented behavior; paths identify modules from the tree, not inspected implementations.
Main entry points: app.cr Application · voicevox_client.cr VOICEVOX client · cli.cr Text input · settings_window.cr Settings window
Components 19
Input and UI
- Text input
src/vovx/cli.cr - Clipboard fallback
src/vovx/cli.cr - Application
src/vovx/app.cr - Main window
src/vovx/ui/main_window.cr - Settings window
src/vovx/ui/settings_window.cr - UI state
src/vovx/ui/app_state.cr - macOS Services
src/vovx/service_workflow.cr
Speech workflow
- Sentence splitting
src/vovx/text.cr - VOICEVOX client
src/vovx/voicevox_client.cr - Voice selection
src/vovx/voice_style_option.cr - Audio playback
src/vovx/playback_controller.cr - Audio export
src/vovx/audio_exporter.cr - WAV handling
src/vovx/wav.cr
Runtime integration
- VOICEVOX Engine
- Engine launcher
src/vovx/platform/launcher.cr - Engine startup
src/vovx/ui/voicevox_startup.cr
Preferences
- Saved settings
src/vovx/settings.cr - App paths
src/vovx/paths.cr
Other components
- User
Connections 18
- User → Text input: provides text
README.md - Text input → Application: supplies input
README.md - User → Clipboard fallback: provides fallback
README.md - Clipboard fallback → Application: supplies text
README.md - User → macOS Services: invokes service
README.md - macOS Services → Application: starts reading
README.md - User → Main window: controls playback
README.md - User → Settings window: sets voice and speed
README.md - Application → Sentence splitting: splits sentences
README.md - Application → VOICEVOX client: requests synthesis
README.md - VOICEVOX client → VOICEVOX Engine: uses engine
README.md - Application → Audio playback: plays sentences
README.md - Audio playback → VOICEVOX client: overlaps synthesis
README.md - Application → Engine launcher: tries engine launch
README.md - Engine launcher → VOICEVOX Engine: starts if unavailable
README.md - Application → Saved settings: restores and saves
README.md - Application → Main window: presents controls
- Settings window → Saved settings: updates preferences